Skip to content

Commit 79533cf

Browse files
vikasalmal0201v-shalinirobSharanGarcha-MSFT
authored
Go Live 07/04 (#14255)
* Merge pull request #14014 from MicrosoftDocs/agents-toolkit-update-PR2 [Doc Improvement][Agents Toolkit update - PR2][5001299] * Update browser-device-permissions, app-permission.png, enable-access.png (#14251) * Update browser-device-permissions, app-permission.png, enable-access.png * Update documentation via Content Mentor Quick Workspace * update content * Update add-incoming-webhook.md (#14184) * Update add-incoming-webhook.md * workflows updated content * Update add-incoming-webhook.md * Added content * Update add-incoming-webhook.md * Update add-incoming-webhook.md * updated content * Updated content * updates made as needed * Update add-incoming-webhook.md * Update add-incoming-webhook.md * updates * updates --------- Co-authored-by: v-shalinirob <[email protected]> Co-authored-by: Sharan Garcha <[email protected]>
2 parents a309efb + 8fd56ec commit 79533cf

43 files changed

Lines changed: 222 additions & 268 deletions

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

msteams-platform/TOC.yml

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -48,9 +48,11 @@
4848
- name: Build apps using Agents Toolkit
4949
href: toolkit/build-environments.md
5050
items:
51-
- name: Prerequisites to create Teams app
51+
- name: Prerequisites to create Teams agent or app
5252
href: toolkit/tools-prerequisites.md
5353
displayName: accounts to build your Teams app
54+
- name: Create new Teams agent project
55+
href: agents-in-teams/build-first-agent.md
5456
- name: Create new Teams app project
5557
href: toolkit/create-new-project.md
5658
- name: Develop your app in VSC

msteams-platform/agents-in-teams/build-first-agent.md

Lines changed: 16 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -16,42 +16,43 @@ To build an agent in Microsoft Teams, ensure you have the following:
1616

1717
| Install | For using... |
1818
| --- | --- |
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. |
2020
| [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. |
2222
| [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. |
2525

2626
## Set up your environment
2727

2828
1. Install the latest versions of Visual Studio Code, Node.js, and Microsoft 365 Agents Toolkit.
2929
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.
3030

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).
3536
3637
## Create an agent using Microsoft 365 Agents Toolkit
3738

3839
1. Open Visual Studio Code.
3940
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**.
4041
1. Select **Create a New Agent/App**.
4142

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":::
4344

4445
1. From the **New Project** menu, select **Teams Agents and Apps**.
4546

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":::
4748

4849
1. Select **General Teams Agent** to create an agent.
4950

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":::
5152

5253
1. Select a service to access Large Language Model (LLM) for your agent.
5354

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":::
5556

5657
Choose one of the following options:
5758

@@ -69,19 +70,19 @@ For more information about setting up Azure OpenAI services, see:
6970

7071
1. Select the **Default folder** as the **Workspace Folder** for your agent project.
7172

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":::
7374

7475
1. Enter the agent name and then select **Enter**.
7576

7677
:::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":::
7778

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**.
7980

8081
:::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.":::
8182

8283
### Take a tour of the agent source code
8384

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:
8586

8687
| Folder | Contents |
8788
| --- | --- |
63.5 KB
Loading
58.8 KB
Loading
50.4 KB
Loading
59.9 KB
Loading
20.6 KB
Loading
145 KB
Loading
233 KB
Loading
53 KB
Loading

0 commit comments

Comments
 (0)