You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: msteams-platform/agents-in-teams/build-first-agent.md
+16-15Lines changed: 16 additions & 15 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -16,42 +16,43 @@ To build an agent in Microsoft Teams, ensure you have the following:
16
16
17
17
| Install | For using... |
18
18
| --- | --- |
19
-
|[Visual Studio Code](https://code.visualstudio.com/download)| JavaScript, TypeScript, or Python build environments. Use the latest version. |
19
+
|[Visual Studio Code](https://code.visualstudio.com/download)| JavaScript, TypeScript, or Python (in public preview) build environments. Use the latest version. |
20
20
|[Teams SDK](/microsoftteams/platform/teams-ai-library/teams/overview)| A simplified SDK for building intelligent agents. Now GA for JavaScript and C#, and in public preview for Python. |
21
-
|[Microsoft 365 Agents Toolkit](https://marketplace.visualstudio.com/items?itemName=TeamsDevApp.ms-teams-vscode-extension)| Microsoft Visual Studio Code extension that creates a project scaffolding for your agent. Use the latest version.|
21
+
|[Microsoft 365 Agents Toolkit](https://marketplace.visualstudio.com/items?itemName=TeamsDevApp.ms-teams-vscode-extension)| Microsoft Visual Studio Code extension that creates a project scaffolding for your agent. Use the latest version.|
22
22
|[Node.js](https://nodejs.org/en/download/)| Back-end JavaScript runtime environment. For more information, see [Node.js version compatibility table for project type](~/toolkit/build-environments.md#nodejs-version-compatibility-table-for-project-type).|
23
-
|[Microsoft Teams](https://www.microsoft.com/microsoft-teams/download-app)| Microsoft Teams to collaborate with everyone you work with through agents and apps for chat, meetings, and calls all in one place.|
24
-
|[Azure OpenAI](https://oai.azure.com/portal)| First create your OpenAI API key to use OpenAI's Generative Pretrained Transformer (GPT). If you want to host your agent or access resources in Azure, you must create an Azure OpenAI service.|
23
+
|[Microsoft Teams](https://www.microsoft.com/microsoft-teams/download-app)| Microsoft Teams to collaborate with everyone you work with through agents and apps for chat, meetings, and calls all in one place.|
24
+
|[Azure OpenAI](https://oai.azure.com/portal)|OpenAI API key to use OpenAI's Generative Pretrained Transformer (GPT). If you want to host your agent or access resources in Azure, you must create an Azure OpenAI service.|
25
25
26
26
## Set up your environment
27
27
28
28
1. Install the latest versions of Visual Studio Code, Node.js, and Microsoft 365 Agents Toolkit.
29
29
1. If you want to use Azure OpenAI service to access Large Language Model (LLM) for your agent, create an Azure OpenAI service on the [Azure portal](https://ms.portal.azure.com/#home) and obtain your API key.
30
30
31
-
For more information about setting up Azure OpenAI services, see:
32
-
33
-
-[Create and deploy an Azure OpenAI in Azure AI Foundry Models resource](/azure/ai-foundry/openai/how-to/create-resource?pivots=web-portal).
34
-
-[Create an Azure OpenAI Resource and Deploy a Model](/microsoft-cloud/dev/tutorials/openai-acs-msgraph/02-openai-create-resource).
31
+
> [!NOTE]
32
+
> For more information about setting up Azure OpenAI services, see:
33
+
>
34
+
> -[Create and deploy an Azure OpenAI in Azure AI Foundry Models resource](/azure/ai-foundry/openai/how-to/create-resource?pivots=web-portal).
35
+
> -[Create an Azure OpenAI Resource and Deploy a Model](/microsoft-cloud/dev/tutorials/openai-acs-msgraph/02-openai-create-resource).
35
36
36
37
## Create an agent using Microsoft 365 Agents Toolkit
37
38
38
39
1. Open Visual Studio Code.
39
40
1. Select the Microsoft 365 Agents Toolkit :::image type="icon" source="~/assets/icons/m-365-agents-toolkit-icon.png" border="false"::: icon in the Visual Studio Code **Activity Bar**.
40
41
1. Select **Create a New Agent/App**.
41
42
42
-
:::image type="content" source="../assets/images/agents-in-teams/first-agent-qsg/create-new-agent.png" alt-text="Screenshot shows the location of the option to create a new agent using Microsoft 365 Agents Toolkit sidebar." lightbox="../assets/images/agents-in-teams/first-agent-qsg/create-new-agent.png":::
43
+
:::image type="content" source="../assets/images/agents-in-teams/first-agent-qsg/create-new-agent.png" alt-text="Screenshot shows the option to create a new agent." lightbox="../assets/images/agents-in-teams/first-agent-qsg/create-new-agent.png":::
43
44
44
45
1. From the **New Project** menu, select **Teams Agents and Apps**.
45
46
46
-
:::image type="content" source="../assets/images/agents-in-teams/first-agent-qsg/teams-agents.png" alt-text="Screenshot shows the location of the option to create a new agent or app in Teams." lightbox="../assets/images/agents-in-teams/first-agent-qsg/teams-agents.png":::
47
+
:::image type="content" source="../assets/images/agents-in-teams/first-agent-qsg/teams-agents.png" alt-text="Screenshot shows the option to create a new agent or app project in Teams." lightbox="../assets/images/agents-in-teams/first-agent-qsg/teams-agents.png":::
47
48
48
49
1. Select **General Teams Agent** to create an agent.
49
50
50
-
:::image type="content" source="../assets/images/agents-in-teams/first-agent-qsg/general-teams-agent.png" alt-text="Screenshot shows the location of the option to create a new agent in Teams." lightbox="../assets/images/agents-in-teams/first-agent-qsg/general-teams-agent.png":::
51
+
:::image type="content" source="../assets/images/agents-in-teams/first-agent-qsg/general-teams-agent.png" alt-text="Screenshot shows the option to create a new agent in Teams." lightbox="../assets/images/agents-in-teams/first-agent-qsg/general-teams-agent.png":::
51
52
52
53
1. Select a service to access Large Language Model (LLM) for your agent.
53
54
54
-
:::image type="content" source="../assets/images/agents-in-teams/first-agent-qsg/access-llm.png" alt-text="Screenshot shows the location of the option to select an appropriate LLM for your agent." lightbox="../assets/images/agents-in-teams/first-agent-qsg/access-llm.png":::
55
+
:::image type="content" source="../assets/images/agents-in-teams/first-agent-qsg/access-llm.png" alt-text="Screenshot shows the option to select an appropriate LLM for your agent." lightbox="../assets/images/agents-in-teams/first-agent-qsg/access-llm.png":::
55
56
56
57
Choose one of the following options:
57
58
@@ -69,19 +70,19 @@ For more information about setting up Azure OpenAI services, see:
69
70
70
71
1. Select the **Default folder** as the **Workspace Folder** for your agent project.
71
72
72
-
:::image type="content" source="../assets/images/agents-in-teams/first-agent-qsg/select-workspace.png" alt-text="Screenshot shows the field to select the workspace folder for your agent project." lightbox="../assets/images/agents-in-teams/first-agent-qsg/select-workspace.png":::
73
+
:::image type="content" source="../assets/images/agents-in-teams/first-agent-qsg/select-workspace.png" alt-text="Screenshot shows the field to select the project workspace folder for your agent." lightbox="../assets/images/agents-in-teams/first-agent-qsg/select-workspace.png":::
73
74
74
75
1. Enter the agent name and then select **Enter**.
75
76
76
77
:::image type="content" source="../assets/images/agents-in-teams/first-agent-qsg/add-agent-name.png" alt-text="Screenshot shows the field to add the agent name." lightbox="../assets/images/agents-in-teams/first-agent-qsg/add-agent-name.png":::
77
78
78
-
The toolkit displays a message that the agent has been successfully created. You can also provision the agent at this time or later. If the toolkit displays a message to confirm if you trust the author, select **Yes, I trust the authors**.
79
+
The toolkit displays a message that the agent workspace has been successfully created. You can provision the agent at this time or later. If the toolkit displays a message to confirm that you trust the author, select **Yes, I trust the authors**.
79
80
80
81
:::image type="content" source="../assets/images/agents-in-teams/first-agent-qsg/trust-author.png" alt-text="Screenshot shows the message for confirming if you trust the authors of the agent.":::
81
82
82
83
### Take a tour of the agent source code
83
84
84
-
Microsoft 365 Agents Toolkit creates your agent project and scaffolds the project workspace. Here's a look at the folder structure:
85
+
Microsoft 365 Agents Toolkit creates and scaffolds the agent project workspace. Here's a look at the folder structure:
0 commit comments