Merge pull request #50203 from MicrosoftDocs/NEW-sk-guided-project

Modules/M05-guided-project-create-sk-assistant

Author: JamesJBarnett

learn-pr/paths/develop-ai-agents-azure-open-ai-semantic-kernel-sdk/index.yml

@@ -29,6 +29,6 @@ modules:
 - learn.wwl.create-plugins-semantic-kernel
 - learn.wwl.give-your-ai-agent-skills
 - learn.wwl.combine-prompts-functions
-- learn.wwl.guided-project-create-ai-travel-agent
+- learn.wwl.guided-project-create-sk-assistant
 trophy:
   uid: learn.wwl.develop-ai-agents-azure-open-ai-semantic-kernel-sdk.trophy

learn-pr/wwl-azure/guided-project-create-sk-assistant/1-introduction.yml

@@ -0,0 +1,13 @@
+### YamlMime:ModuleUnit
+uid: learn.wwl.guided-project-create-sk-assistant.introduction
+title: Introduction
+metadata:
+  title: Introduction
+  description: Learn how to design an AI assistant with Semantic Kernel and Azure OpenAI.
+  ms.date: 04/28/2025
+  author: wwlpublish
+  ms.author: buzahid
+  ms.topic: unit
+durationInMinutes: 3
+content: |
+  [!include[](includes/1-introduction.md)]

learn-pr/wwl-azure/guided-project-create-sk-assistant/2-exercise.yml

@@ -0,0 +1,13 @@
+### YamlMime:ModuleUnit
+uid: learn.wwl.guided-project-create-sk-assistant.exercise
+title: Exercise - Create a DevOps Assistant with the Semantic Kernel SDK
+metadata:
+  title: Exercise - Create a DevOps Assistant with the Semantic Kernel SDK
+  description: Learn how to build an AI assistant. This unit provides an interactive exercise to develop an example DevOps solution with the Semantic Kernel SDK.
+  ms.date: 04/28/2025
+  author: wwlpublish
+  ms.author: buzahid
+  ms.topic: unit
+durationInMinutes: 10
+content: |
+  [!include[](includes/2-exercise.md)]

learn-pr/wwl-azure/guided-project-create-sk-assistant/3-knowledge-check.yml

@@ -0,0 +1,47 @@
+### YamlMime:ModuleUnit
+uid: learn.wwl.guided-project-create-sk-assistant.knowledge-check
+title: Module assessment
+metadata:
+  title: Module assessment
+  description: "Knowledge check"
+  ms.date: 04/28/2025
+  author: wwlpublish
+  ms.author: buzahid
+  ms.topic: unit
+durationInMinutes: 3
+quiz:
+  title: "Check your knowledge"
+  questions:
+  - content: "Which of the following is true about the Semantic Kernel SDK?"
+    choices:
+    - content: "Developers should avoid using Semantic Kernel SDK as it adds unnecessary complexity."
+      isCorrect: false
+      explanation: "Incorrect. The Semantic Kernel SDK is designed to simplify the integration of AI."
+    - content: "Semantic Kernel SDK uses abstraction to reduce the learning curve of integration AI."
+      isCorrect: true
+      explanation: "Correct. Semantic Kernel SDK eases AI integration by providing abstraction and orchestration."
+    - content: "Semantic Kernel SDK is only suitable for advanced AI developers."
+      isCorrect: false
+      explanation: "Incorrect. The Semantic Kernel SDK is suitable for developers of all levels."
+  - content: "What is the main purpose of plugins in the Semantic Kernel SDK?"
+    choices:
+    - content: "To process large language models and generate responses."
+      isCorrect: false
+      explanation: "Incorrect. Plugins are not responsible for generating responses, but for executing custom functions."
+    - content: "To encapsulate functions that can be used by the AI."
+      isCorrect: true
+      explanation: "Correct. Plugins allow you to organize and expose functions to be invoked by the kernel."
+    - content: "To improve the accuracy of prompts in the AI model."
+      isCorrect: false
+      explanation: "Incorrect. Plugins are used to execute code and interact with external systems, not to improve prompt accuracy."
+  - content: "Which option assigns a role in a prompt to the large language model (LLM)?"
+    choices:
+    - content: "Using the `role` attribute in the `message` tag."
+      isCorrect: true
+      explanation: "Correct. You can assign a role to the LLM by using the `role` attribute in the `message` tag."
+    - content: "Using the `ChatHistory` object on the LLM response."
+      isCorrect: false
+      explanation: "Incorrect. The `ChatHistory` object is used to store the conversation history."
+    - content: "Using the `assignRole` attribute in the `chat` tag."
+      isCorrect: false
+      explanation: "Incorrect. You can assign a role to the LLM by using the `role` attribute in the `message` tag."

learn-pr/wwl-azure/guided-project-create-sk-assistant/4-summary.yml

@@ -0,0 +1,13 @@
+### YamlMime:ModuleUnit
+uid: learn.wwl.guided-project-create-sk-assistant.summary
+title: Summary
+metadata:
+  title: Summary
+  description: This unit summarizes the key concepts covered in the module, including key features and how to use Semantic Kernel SDK.
+  ms.date: 04/28/2025
+  author: wwlpublish
+  ms.author: buzahid
+  ms.topic: unit
+durationInMinutes: 3
+content: |
+  [!include[](includes/4-summary.md)]

learn-pr/wwl-azure/guided-project-create-sk-assistant/includes/1-introduction.md

@@ -0,0 +1,29 @@
+Suppose you're a developer for Contoso Solutions, a leading provider of enterprise software and cloud-based services for businesses around the world. Contoso specializes in helping organizations modernize their infrastructure, automate workflows, and accelerate software delivery with innovative DevOps practices. With a focus on agility and reliability, Contoso is constantly exploring new technologies to streamline development operations and improve deployment processes.
+
+To further enhance their internal DevOps pipelines, Contoso is piloting the use of cutting-edge AI to assist developers and operations teams. They envision an AI assistant that can help automate common DevOps tasks—like building environments, creating branches, deploying applications, and reviewing logs—making their workflows more efficient and reducing manual errors.
+
+You're tasked with creating a proof of concept for this DevOps Assistant, demonstrating its ability to interact with users in natural language, understand DevOps-related requests, and perform basic operations. To power the assistant's intelligence and task execution, you choose to use the Semantic Kernel SDK.
+
+This module guides you through the steps required to develop an AI DevOps assistant using the Semantic Kernel SDK. By the end of this module, you will complete a small assistant application that can interpret user requests, simulate DevOps actions with mock functions, and showcase how AI can enhance software development operations.
+
+> [!NOTE] 
+> This is a guided project module where you complete an end-to-end project by following step-by-step instructions.  
+
+## Learning objectives
+
+In this module, you practice how to: 
+
+- Create plugins for the Semantic Kernel.
+- Create prompts to elicit the best responses from the large language model.
+- Use the chat history to guide generated responses.
+- Automatically invoke the correct plugins to complete tasks.
+- Create function filters.
+
+## Prerequisites 
+
+- Experience programming in C#.
+- Visual Studio Code IDE installed.
+- Familiarity with Azure and the Azure portal.
+- Access to Azure OpenAI Services.
+- Experience creating plugins using the Semantic Kernel SDK.
+- Experience using Semantic Kernel auto function calling.

learn-pr/wwl-azure/guided-project-create-sk-assistant/includes/2-exercise.md

@@ -0,0 +1,12 @@
+This module is a guided project where you use Visual Studio Code to develop a proof-of-concept artificially intelligent DevOps assistant. The project demonstrates how the Semantic Kernel SDK can interface with a large language model (LLM) to process and retrieve information, and integrate native code to perform specialized tasks. In this project, you develop the functionality to assist users with their travel plans. Let's start by setting up your development environment!
+
+## Project overview
+
+In this project, you apply what you learned about the Semantic Kernel SDK. You're provided a project with some basic starter code that you edit in the Azure Cloud Shell. This project demonstrates how the Semantic Kernel SDK can be used to create artificially intelligent agents that can automate custom tasks. 
+
+Launch the exercise and follow the instructions.
+
+[![Button to launch exercise.](../media/launch-exercise.png)](https://go.microsoft.com/fwlink/?linkid=2318601&azure-portal=true)
+
+> [!TIP]
+> After completing the exercise, if you're finished exploring with Semantic Kernel, delete the Azure resources that you created during the exercise.

learn-pr/wwl-azure/guided-project-create-sk-assistant/includes/4-summary.md

@@ -0,0 +1 @@
+In this module, you developed a proof-of-concept AI DevOps assistant using the Semantic Kernel SDK. You practiced creating plugins, functions, and prompts that define the tasks the agent should perform. You practiced using templates, chat history, and function filters. Great work!

learn-pr/wwl-azure/guided-project-create-sk-assistant/index.yml

@@ -0,0 +1,40 @@
+### YamlMime:Module
+uid: learn.wwl.guided-project-create-sk-assistant
+metadata:
+  title: Guided project - Create a DevOps Assistant with the Semantic Kernel SDK
+  description: Develop a proof of concept AI DevOps assistant chatbot using the Semantic Kernel SDK.
+  ms.date: 04/28/2025
+  author: wwlpublish
+  ms.author: buzahid
+  ms.topic: module
+  ms.service: semantic-kernel
+  ai-usage: human-only
+title: Guided project -  Create a DevOps Assistant with the Semantic Kernel SDK
+summary: This module guides you through the steps required to develop a proof-of-concept AI DevOps assistant with the Semantic Kernel SDK.
+abstract: |
+  By the end of this module, you'll be able to:
+  - Create plugins for the Semantic Kernel.
+  - Create prompts to elicit the best responses from the large language model (LLM).
+  - Embed expressions in prompts to manually invoke functions.
+  - Automatically invoke the correct plugins to complete tasks.
+  - Apply filters to plugin functions.
+prerequisites: |
+  -   Experience programming in C#.
+  -   Familiarity with Azure and the Azure portal.
+  -   Access to Azure OpenAI services.
+iconUrl: /training/achievements/generic-badge.svg
+levels:
+- intermediate
+roles:
+- developer
+products:
+- dotnet
+- vs-code
+- azure-openai
+units:
+- learn.wwl.guided-project-create-sk-assistant.introduction
+- learn.wwl.guided-project-create-sk-assistant.exercise
+- learn.wwl.guided-project-create-sk-assistant.knowledge-check
+- learn.wwl.guided-project-create-sk-assistant.summary
+badge:
+  uid: learn.wwl.guided-project-create-sk-assistant.badge