Merge branch 'main' into pranjalb-teamssdk-sample-code-updation-11

Author: SharanGarcha-MSFT

.openpublishing.redirection.json

@@ -1560,6 +1560,11 @@
         "source_path": "msteams-platform/bots/how-to/create-a-bot-commands-menu.md",
         "redirect_url": "/microsoftteams/platform/agents-in-teams/agent-slash-commands",
         "redirect_document_id": false
+      },
+      {
+        "source_path": "msteams-platform/agents-in-teams/build-first-agent.md",
+        "redirect_url": "quickstart-create-agent-teams-sdk",
+        "redirect_document_id": false
       }
     ]
 }

msteams-platform/TOC.yml

@@ -6,16 +6,13 @@
 - name: What's new?
   href: whats-new.md
   displayName: Teams platform features, latest updates, RSS feed, deprecated, announcement, preview
-- name: Glossary
-  href: get-started/glossary.md
-  displayName: App tray, terminologies, definitions, welcome, new word, meaning
+- name: "Quickstart: Create and chat with an agent"
+  href: agents-in-teams/quickstart-create-agent-teams-sdk.md
+  displayName: Get started, chat, start, introduction, tutorial, demo, SDK, Teams, bot, developer, CLI, agent, sideload, devtunnel
 - name: Build agents using Teams SDK
   items:
   - name: Agents in Teams
     href: agents-in-teams/overview.md
-  - name: Build your first agent
-    href: agents-in-teams/build-first-agent.md
-    displayName: create, run, first agent, Teams AI library, Teams SDK, custom engine agent, AI bot, JavaScript, Python, C#, code sample
   - name: Agents user experience
     href: bots/how-to/teams-conversational-ai/ai-ux.md
     displayName: AI bot user experience, AI bot UX, custom engine agent, AI label, citation, feedback loop            
@@ -67,7 +64,7 @@
           href: toolkit/tools-prerequisites.md
           displayName: accounts to build your Teams app
         - name: Create new Teams agent project
-          href: agents-in-teams/build-first-agent.md  
+          href: agents-in-teams/build-agent-toolkit.md
         - name: Create new Teams app project
           href: toolkit/create-new-project.md
       - name: Develop your app in VSC
@@ -1191,6 +1188,9 @@
     displayName: Purchase, Teams apps, License, manage, buy subscriptions, ISVs, Manage, License, third party, SaaS, Partner Center
 - name: Frequently asked questions
   href: teams-faq.md 
+- name: Glossary
+  href: get-started/glossary.md
+  displayName: App tray, terminologies, definitions, new word, meaning
 - name: Support and feedback
   href: feedback.md
   displayName: Developer community help, questions, suggestions, contact, issues

msteams-platform/agents-in-teams/agent-reactions.md

@@ -3,7 +3,7 @@ title: Build Agents that Use Emoji Reactions in Teams Chat
 description: Reactions are emoji markers on messages in Teams chat. Learn how to make an agent that adds, removes, and listens reactions with practical code examples.
 #customer intent: As a Teams agent developer, I want to add emoji reactions to chat messages so that my agent can acknowledge messages without interrupting the conversation.
 ms.localizationpriority: high
-ms.date: 07/01/2026
+ms.date: 07/10/2026
 author: nickwalkmsft
 ms.author: nickwalk
 ms.reviewer: nickwalk
@@ -13,10 +13,6 @@ zone_pivot_groups: teams-sdk-languages
 
 # Use emoji reactions in Teams chat
 
-> [!NOTE]
->
-> Support for agent reactions in Teams is available in [public developer preview](../resources/dev-preview/developer-preview-intro.md).
-
 In Teams chat, reactions are lightweight emoji markers that participants can attach to anyone's messages. Agents can use reactions to acknowledge messages, display workflow status, and present other information without interrupting the flow of the conversation. Agents can also listen for and respond to reactions.
 
 # [Desktop](#tab/desktop)
@@ -72,11 +68,11 @@ The following example illustrates adding a reaction to a received message, then
 ```typescript
 app.on('message', async ({ activity, api }) => {
 // First, add a reaction
-  await api.conversations.reactions.add(activity.conversation.id, activity.id, '1f44b_wavinghand');
+  await api.reactions.add(activity.conversation.id, activity.id, '1f44b_wavinghand');
 
   // Wait a bit, then remove it
   await new Promise((resolve) => setTimeout(resolve, 2000));
-  await api.conversations.reactions.delete(activity.conversation.id, activity.id, '1f44b_wavinghand');
+  await api.reactions.delete(activity.conversation.id, activity.id, '1f44b_wavinghand');
 });
 ```
 
@@ -96,15 +92,15 @@ import asyncio
 @app.on_message
 async def handle_message(ctx: ActivityContext[MessageActivity]):
     # First, add a reaction
-    await ctx.api.conversations.reactions.add(
+    await ctx.api.reactions.add(
         ctx.activity.conversation.id,
         ctx.activity.id,
         '1f44b_wavinghand'
     )
 
     # Wait a bit, then remove it
     await asyncio.sleep(2)
-    await ctx.api.conversations.reactions.delete(
+    await ctx.api.reactions.delete(
         ctx.activity.conversation.id,
         ctx.activity.id,
         '1f44b_wavinghand'

…orm/agents-in-teams/build-first-agent.md …m/agents-in-teams/build-agent-toolkit.mdmsteams-platform/agents-in-teams/build-first-agent.md renamed to msteams-platform/agents-in-teams/build-agent-toolkit.md msteams-platform/agents-in-teams/build-first-agent.md renamed to msteams-platform/agents-in-teams/build-agent-toolkit.md

@@ -1,12 +1,14 @@
 ---
-title: Create your first agent
-description: Learn how to build your agent in Microsoft Teams with the help of GitHub codespaces that opens Toolkit extension and step-by-step guides.
-ms.localizationpriority: high
-ms.date: 12/11/2024
-ms.topic: reference
+title: Build a Teams Agent with Microsoft 365 Agents Toolkit
+description: Build a Teams agent using Microsoft 365 Agents Toolkit. Follow a step-by-step guide to create, run, and deploy your AI agent in Teams.
+ms.date: 07/06/2026
+author: nickwalkmsft
+ms.author: nickwalk
+ms.reviewer: nickwalk
+ms.topic: quickstart
 ---
 
-# Build your first agent
+# Build a Teams agent with Microsoft 365 Agents Toolkit
 
 Agents utilize AI to automate and execute business processes, functioning alongside or on behalf of a person, team, or organization. Agents range from simple prompt-and-response agents to more advanced, fully autonomous agents.
 
@@ -111,36 +113,6 @@ Microsoft 365 Agents Toolkit creates and scaffolds the agent project workspace.
 
 Congratulations! You've created and ran your first agent in Microsoft Teams.
 
-## Choose your programming language
-
-Teams SDK is available for JavaScript, C#, and Python (dev preview). It provides a simplified SDK, support for Model Context Protocol (MCP), Agent-to-Agent communication (A2A), and streamlined tools to enable developers to build intelligent agents for Microsoft Teams.
-
-:::row:::
-   :::column:::
-      **Description**
-   :::column-end:::
-   :::column span="3":::
-                  **Choose your build environment**
-   :::column-end:::
-:::row-end:::
-:::row:::
-   :::column:::
-      Build with ...
-   :::column-end:::
-   :::column:::
-      > [!div class="nextstepaction"]
-      > [C#](/microsoftteams/platform/teams-ai-library/getting-started/quickstart?pivots=csharp)
-   :::column-end:::
-   :::column:::
-      > [!div class="nextstepaction"]
-      > [TypeScript](/microsoftteams/platform/teams-ai-library/getting-started/quickstart?pivots=typescript)
-   :::column-end:::
-   :::column:::
-      > [!div class="nextstepaction"]
-      > [Python](/microsoftteams/platform/teams-ai-library/getting-started/quickstart?pivots=python)
-   :::column-end:::
-:::row-end:::
-
 ## Code sample
 
 | Sample name | Description | .NET | Node.js | Python |

msteams-platform/agents-in-teams/includes/dotnet-quickstart.md

@@ -0,0 +1,44 @@
+## Prerequisites
+
+- Node.js 24 or later ([installer download](https://nodejs.org))
+- .NET 10 or later ([installer download](https://dotnet.microsoft.com/download))
+- Teams, with a Microsoft 365 work or school account that has permissions to install custom Teams apps (you'll confirm these permissions at the very beginning of the quickstart)
+
+If you don't have a Microsoft 365 work or school account, see [Microsoft 365 Developer Program](/office/developer-program/microsoft-365-developer-program) for information about getting a developer sandbox subscription that you can use to try your agent in Teams.
+
+## Install tools, log in and confirm permissions
+
+Install the Teams developer CLI and Microsoft 365 Agents Playground, then log in to the developer CLI.
+
+```console
+npm install -g @microsoft/teams.cli
+teams login
+```
+
+The CLI will confirm your login, your account's permissions to install custom apps ("sideloading"), and check for the presence of an Azure CLI installation (not required for this quickstart).
+
+```output
+✔ Logged in as user@contoso.com
+✔ Sideloading: enabled
+
+Azure CLI: installed, not logged in
+```
+
+**To continue with this quickstart, sideloading must be enabled.** If it is disabled, you will need your organization's Microsoft 365 administrator to enable it for your account. See [Allow users to upload custom apps](/microsoftteams/teams-custom-app-policies-and-settings#allow-users-to-upload-custom-apps) for administrator instructions for enabling this permission.
+
+## Create code for an agent
+
+1. Use `teams project new` to create the code for a new agent from a template.
+
+    ```console
+    teams project new csharp EchoBot
+    cd EchoBot/EchoBot
+    ```
+
+1. Start the agent to confirm it runs. Once it's running, you'll see a confirmation that it's running on port 3978.
+
+    ```console
+    dotnet run
+    ```
+
+1. Use <kbd>Ctrl+C</kbd> in the console window to stop your agent. Leave the console window open, you'll need it again soon.

msteams-platform/agents-in-teams/includes/python-quickstart.md

@@ -0,0 +1,110 @@
+## Prerequisites
+
+This quickstart is divided into two sections. In the first section, you'll need:
+
+- Node.js 24 or later ([installer download](https://nodejs.org))
+- Python 3.12 or later ([installer download](https://python.org/downloads))
+- Visual Studio Code ([installer download](https://code.visualstudio.com/download))
+
+In the second part, you'll also need Teams, with a Microsoft 365 work or school account that has permissions to install custom Teams apps.
+
+If you don't have an account, or you aren't sure about your permissions, you can still begin. The quickstart will address those requirements when they're needed.
+
+## Create code for an agent and try it in Microsoft 365 Agents Playground
+
+1. Install the Teams developer CLI and Microsoft 365 Agents Playground.
+
+    ```console
+    npm install -g @microsoft/teams.cli @microsoft/m365agentsplayground
+    ```
+
+1. Use `teams project new` to create the code for a new agent from a template and open it in Visual Studio Code.
+
+    ```console
+    teams project new python echo-bot
+    cd echo-bot
+    code .
+    ```
+
+1. Open `src/main.py`. Find the line that reads `app = App()` and modify it to read:
+
+    ```python
+    app = App(skip_auth=True)
+    ```
+
+    This is a temporary modification to enable Microsoft 365 Agents Playground to communicate with the agent.
+
+1. Start the agent. Once it's running, you'll see a confirmation that it's running on port 3978.
+
+   ### [Bash](#tab/bash)
+
+    ```bash
+    python -m venv .venv
+    source .venv/bin/activate
+    pip install -e .
+    python src/main.py
+    ```
+
+   ### [PowerShell](#tab/powershell)
+
+    ```powershell
+    python -m venv .venv
+    .\.venv\Scripts\Activate.ps1
+    pip install -e .
+    python src/main.py
+    ```
+
+   ### [Cmd](#tab/cmd)
+
+    ```cmd
+    python -m venv .venv
+    .venv\Scripts\activate.bat
+    pip install -e .
+    python src/main.py
+    ```
+
+    ---
+
+1. In a new console window, start Microsoft 365 Agents Playground.
+
+    ```console
+    agentsplayground
+    ```
+
+    This will connect Agents Playground to your agent and open the interface in a new browser tab.
+
+1. Use the compose box to send your agent a message and see it respond in the chat. Your agent's up and running locally!
+
+    :::image type="content" source="../../assets/images/agents-in-teams/agents-playground-interaction.png" alt-text="Screenshot of a short agent interaction in Microsoft 365 Agents Playground." lightbox="../../assets/images/agents-in-teams/agents-playground-interaction.png":::
+
+1. Close the Agents Playground tab in your browser, and use <kbd>Ctrl+C</kbd> in both console windows to stop Agents Playground and your agent. Leave open the console window you used to create your agent, you'll need it again soon.
+
+1. In your editor, undo the modification you made in step 3. This will ensure a secure connection with Teams in the next steps.
+
+    ```python
+    app = App()
+    ```
+
+## Log in and confirm permissions
+
+> [!NOTE]
+> The next part of this quickstart requires Teams, logged in to a Microsoft 365 work or school account with permissions to install custom Teams apps. This step will check for that permission.
+>
+>If you don't have a Microsoft 365 account, you can proceed to [Next steps](#next-steps) to continue working on your agent's code and complete the rest of this quickstart later. See [Microsoft 365 Developer Program](/office/developer-program/microsoft-365-developer-program) for information about getting a developer sandbox subscription that you can use to try your app in Teams.
+
+Log in to your Microsoft 365 account from the Teams developer CLI.
+
+```console
+teams login
+```
+
+The CLI will confirm your login, your account's permissions to install custom apps ("sideloading"), and check for the presence of an Azure CLI installation (not required for this quickstart).
+
+```output
+✔ Logged in as user@contoso.com
+✔ Sideloading: enabled
+
+Azure CLI: installed, not logged in
+```
+
+**To continue with this quickstart, sideloading must be enabled.** If it is disabled, you will need your organization's Microsoft 365 administrator to enable it for your account. See [Allow users to upload custom apps](/microsoftteams/teams-custom-app-policies-and-settings#allow-users-to-upload-custom-apps) for administrator instructions for enabling this permission. In the meantime, you can proceed to [Next steps](#next-steps) to continue working on your agent's code