From 2a823077519ca6cf748fff08a66cbe937535371d Mon Sep 17 00:00:00 2001 From: KirtiJha-MSFT Date: Sat, 13 Sep 2025 23:30:44 +0530 Subject: [PATCH 1/2] Updated --- .../teams-conversational-ai/assistants-api-quick-start.md | 4 ++-- .../teams-conversational-ai/conversation-ai-quick-start.md | 2 +- .../how-conversation-ai-core-capabilities.md | 6 +++--- .../how-conversation-ai-get-started.md | 2 +- 4 files changed, 7 insertions(+), 7 deletions(-) diff --git a/msteams-platform/bots/how-to/teams-conversational-ai/assistants-api-quick-start.md b/msteams-platform/bots/how-to/teams-conversational-ai/assistants-api-quick-start.md index d502423bf5f..3e0e0926cbf 100644 --- a/msteams-platform/bots/how-to/teams-conversational-ai/assistants-api-quick-start.md +++ b/msteams-platform/bots/how-to/teams-conversational-ai/assistants-api-quick-start.md @@ -190,9 +190,9 @@ You can also use the following tools to run and set up a sample: 1. **Microsoft 365 Agents Toolkit CLI** (previously known as Teams Toolkit CLI): You can use Agents Toolkit CLI to create and manage Microsoft Teams apps from the command line. For more information, see [Agents Toolkit CLI set up instructions](https://github.com/microsoft/teams-ai/blob/main/getting-started/OTHER/TEAMS-TOOLKIT-CLI.md). -1. **Bot Framework Emulator**: The [Bot Framework Emulator](https://github.com/microsoft/BotFramework-Emulator) is a desktop application that allows you to test and debug your bot locally. You can connect to your bot by entering the bot’s endpoint URL and Microsoft app ID and password. You can then send messages to your bot and see its responses in real-time. For more information, see [Bot Framework Emulator set up instructions](https://github.com/microsoft/teams-ai/blob/main/getting-started/OTHER/BOTFRAMEWORK-EMULATOR.md). +2. **Agents Emulator**: The [Bot Framework Emulator](https://github.com/microsoft/BotFramework-Emulator) is a desktop application that allows you to test and debug your bot locally. You can connect to your bot by entering the bot’s endpoint URL and Microsoft app ID and password. You can then send messages to your bot and see its responses in real-time. For more information, see [Bot Framework Emulator set up instructions](https://github.com/microsoft/teams-ai/blob/main/getting-started/OTHER/BOTFRAMEWORK-EMULATOR.md). -1. **Manual setup**: If you prefer to set up your resources manually, you can do so by following the instructions provided by the respective services. For more information, see [manual set up instructions](https://github.com/microsoft/teams-ai/blob/main/getting-started/OTHER/MANUAL-RESOURCE-SETUP.md). +3. **Manual setup**: If you prefer to set up your resources manually, you can do so by following the instructions provided by the respective services. For more information, see [manual set up instructions](https://github.com/microsoft/teams-ai/blob/main/getting-started/OTHER/MANUAL-RESOURCE-SETUP.md). ## Next step diff --git a/msteams-platform/bots/how-to/teams-conversational-ai/conversation-ai-quick-start.md b/msteams-platform/bots/how-to/teams-conversational-ai/conversation-ai-quick-start.md index aa92d449471..f67ba12a0b9 100644 --- a/msteams-platform/bots/how-to/teams-conversational-ai/conversation-ai-quick-start.md +++ b/msteams-platform/bots/how-to/teams-conversational-ai/conversation-ai-quick-start.md @@ -434,7 +434,7 @@ You can also use the following tools to run and set up a sample: 1. **Microsoft 365 Agents Toolkit CLI** (previously known as Teams Toolkit CLI): You can use Agents Toolkit CLI to create and manage Teams apps from the command line. For more information, see [Agents Toolkit CLI set up instructions](https://github.com/microsoft/teams-ai/blob/main/getting-started/OTHER/TEAMS-TOOLKIT-CLI.md). -1. **Bot Framework Emulator**: The [Bot Framework Emulator](https://github.com/microsoft/BotFramework-Emulator) is a desktop application that allows you to test and debug your bot locally. You can connect to your bot by entering the bot’s endpoint URL and Microsoft app ID and password. You can then send messages to your bot and see its responses in real-time. For more information, see [Bot Framework Emulator set up instructions](https://github.com/microsoft/teams-ai/blob/main/getting-started/OTHER/BOTFRAMEWORK-EMULATOR.md). +1. **Agents Emulator**: The [Bot Framework Emulator](https://github.com/microsoft/BotFramework-Emulator) is a desktop application that allows you to test and debug your bot locally. You can connect to your bot by entering the bot’s endpoint URL and Microsoft app ID and password. You can then send messages to your bot and see its responses in real-time. For more information, see [Bot Framework Emulator set up instructions](https://github.com/microsoft/teams-ai/blob/main/getting-started/OTHER/BOTFRAMEWORK-EMULATOR.md). 1. **Manual setup**: If you prefer to set up your resources manually, you can do so by following the instructions provided by the respective services. For more information, see [manual set up instructions](https://github.com/microsoft/teams-ai/blob/main/getting-started/OTHER/MANUAL-RESOURCE-SETUP.md). diff --git a/msteams-platform/bots/how-to/teams-conversational-ai/how-conversation-ai-core-capabilities.md b/msteams-platform/bots/how-to/teams-conversational-ai/how-conversation-ai-core-capabilities.md index 685d519244f..c23b4044de4 100644 --- a/msteams-platform/bots/how-to/teams-conversational-ai/how-conversation-ai-core-capabilities.md +++ b/msteams-platform/bots/how-to/teams-conversational-ai/how-conversation-ai-core-capabilities.md @@ -32,7 +32,7 @@ You need to use the AI library to scaffold bot and Adaptive Card handlers in you ### Send or receive message -This capability shows how to send and receive messages using the Bot Framework. The sample listens for user messages, deletes the conversation state upon receipt, tracks the number of messages in a conversation, and echoes back the user's message with the count. +This capability shows how to send and receive messages using the Agents SDK. The sample listens for user messages, deletes the conversation state upon receipt, tracks the number of messages in a conversation, and echoes back the user's message with the count. # [.NET](#tab/dotnet6) @@ -94,7 +94,7 @@ async def on_message(context: TurnContext, _state: TurnState): ### Message extensions -This section demonstrates setting up Message Extensions in the Bot Framework SDK's `TeamsActivityHandler`. The sample shows how the app listens for search actions and item taps. It formats search results as Hero Cards displaying package information and shows them in the messaging extension. +This section demonstrates setting up Message Extensions in the Agents SDK's `TeamsActivityHandler`. The sample shows how the app listens for search actions and item taps. It formats search results as Hero Cards displaying package information and shows them in the messaging extension. # [.NET](#tab/dotnet5) @@ -565,7 +565,7 @@ elif config.AZURE_OPENAI_KEY and config.AZURE_OPENAI_ENDPOINT: ### Message extension query -The Teams AI library provides an intuitive way to create handlers for message extension query commands. This functionality works alongside the existing Teams Bot Framework SDK. +The Teams AI library provides an intuitive way to create handlers for message extension query commands. This functionality works alongside the existing Teams Agents SDK. The following example shows how to structure the code to handle a message extension query for the `searchCmd` command. diff --git a/msteams-platform/bots/how-to/teams-conversational-ai/how-conversation-ai-get-started.md b/msteams-platform/bots/how-to/teams-conversational-ai/how-conversation-ai-get-started.md index 7b8202b736f..54195fe85a0 100644 --- a/msteams-platform/bots/how-to/teams-conversational-ai/how-conversation-ai-get-started.md +++ b/msteams-platform/bots/how-to/teams-conversational-ai/how-conversation-ai-get-started.md @@ -14,7 +14,7 @@ The Teams AI library simplifies building intelligent Microsoft Teams application ## Initial setup -Teams AI library is built on top of the Bot Framework SDK. It extends the capabilities of the Bot Framework by importing core functionalities. As part of the initial setup, import the Bot Framework SDK components. The adapter class that handles connectivity with the channels is imported from [Bot Framework SDK](/azure/bot-service/bot-builder-basics?view=azure-bot-service-4.0&preserve-view=true#the-bot-adapter). +Teams AI library is built on top of the Agents SDK. It extends the capabilities of the Agents SDK by importing core functionalities. As part of the initial setup, import the Agents SDK components. The adapter class that handles connectivity with the channels is imported from [Bot Framework SDK](/azure/bot-service/bot-builder-basics?view=azure-bot-service-4.0&preserve-view=true#the-bot-adapter). # [.NET](#tab/dotnet1) From c001ff84cb509e37a638baed62dcda5b7fd38edf Mon Sep 17 00:00:00 2001 From: KirtiJha-MSFT Date: Mon, 22 Sep 2025 10:12:19 +0530 Subject: [PATCH 2/2] Updated --- .../assistants-api-quick-start.md | 2 +- .../conversation-ai-quick-start.md | 2 +- .../how-conversation-ai-core-capabilities.md | 6 +++--- .../how-conversation-ai-get-started.md | 12 ++++++------ 4 files changed, 11 insertions(+), 11 deletions(-) diff --git a/msteams-platform/bots/how-to/teams-conversational-ai/assistants-api-quick-start.md b/msteams-platform/bots/how-to/teams-conversational-ai/assistants-api-quick-start.md index 56c1410ba25..484b0144220 100644 --- a/msteams-platform/bots/how-to/teams-conversational-ai/assistants-api-quick-start.md +++ b/msteams-platform/bots/how-to/teams-conversational-ai/assistants-api-quick-start.md @@ -190,7 +190,7 @@ You can also use the following tools to run and set up a sample: 1. **Microsoft 365 Agents Toolkit CLI** (previously known as Teams Toolkit CLI): You can use Agents Toolkit CLI to create and manage Microsoft Teams apps from the command line. For more information, see [Agents Toolkit CLI set up instructions](https://github.com/microsoft/teams-ai/blob/main/getting-started/OTHER/TEAMS-TOOLKIT-CLI.md). -2. **Agents Emulator**: The [Bot Framework Emulator](https://github.com/microsoft/BotFramework-Emulator) is a desktop application that allows you to test and debug your bot locally. You can connect to your bot by entering the bot’s endpoint URL and Microsoft app ID and password. You can then send messages to your bot and see its responses in real-time. For more information, see [Bot Framework Emulator set up instructions](https://github.com/microsoft/teams-ai/blob/main/getting-started/OTHER/BOTFRAMEWORK-EMULATOR.md). +2. **Microsoft 365 Agents SDK (previously known as Bot Framework SDK) Emulator**: The [Bot Framework Emulator](https://github.com/microsoft/BotFramework-Emulator) is a desktop application that allows you to test and debug your bot locally. You can connect to your bot by entering the bot’s endpoint URL and Microsoft app ID and password. You can then send messages to your bot and see its responses in real-time. For more information, see [Bot Framework Emulator set up instructions](https://github.com/microsoft/teams-ai/blob/main/getting-started/OTHER/BOTFRAMEWORK-EMULATOR.md). 3. **Manual setup**: If you prefer to set up your resources manually, you can do so by following the instructions provided by the respective services. For more information, see [manual set up instructions](https://github.com/microsoft/teams-ai/blob/main/getting-started/OTHER/MANUAL-RESOURCE-SETUP.md). diff --git a/msteams-platform/bots/how-to/teams-conversational-ai/conversation-ai-quick-start.md b/msteams-platform/bots/how-to/teams-conversational-ai/conversation-ai-quick-start.md index f67ba12a0b9..9947926b86d 100644 --- a/msteams-platform/bots/how-to/teams-conversational-ai/conversation-ai-quick-start.md +++ b/msteams-platform/bots/how-to/teams-conversational-ai/conversation-ai-quick-start.md @@ -434,7 +434,7 @@ You can also use the following tools to run and set up a sample: 1. **Microsoft 365 Agents Toolkit CLI** (previously known as Teams Toolkit CLI): You can use Agents Toolkit CLI to create and manage Teams apps from the command line. For more information, see [Agents Toolkit CLI set up instructions](https://github.com/microsoft/teams-ai/blob/main/getting-started/OTHER/TEAMS-TOOLKIT-CLI.md). -1. **Agents Emulator**: The [Bot Framework Emulator](https://github.com/microsoft/BotFramework-Emulator) is a desktop application that allows you to test and debug your bot locally. You can connect to your bot by entering the bot’s endpoint URL and Microsoft app ID and password. You can then send messages to your bot and see its responses in real-time. For more information, see [Bot Framework Emulator set up instructions](https://github.com/microsoft/teams-ai/blob/main/getting-started/OTHER/BOTFRAMEWORK-EMULATOR.md). +1. **Microsoft 365 Agents SDK (previously known as Bot Framework SDK) Emulator**: The [Bot Framework Emulator](https://github.com/microsoft/BotFramework-Emulator) is a desktop application that allows you to test and debug your bot locally. You can connect to your bot by entering the bot’s endpoint URL and Microsoft app ID and password. You can then send messages to your bot and see its responses in real-time. For more information, see [Bot Framework Emulator set up instructions](https://github.com/microsoft/teams-ai/blob/main/getting-started/OTHER/BOTFRAMEWORK-EMULATOR.md). 1. **Manual setup**: If you prefer to set up your resources manually, you can do so by following the instructions provided by the respective services. For more information, see [manual set up instructions](https://github.com/microsoft/teams-ai/blob/main/getting-started/OTHER/MANUAL-RESOURCE-SETUP.md). diff --git a/msteams-platform/bots/how-to/teams-conversational-ai/how-conversation-ai-core-capabilities.md b/msteams-platform/bots/how-to/teams-conversational-ai/how-conversation-ai-core-capabilities.md index c23b4044de4..02ebb82ab68 100644 --- a/msteams-platform/bots/how-to/teams-conversational-ai/how-conversation-ai-core-capabilities.md +++ b/msteams-platform/bots/how-to/teams-conversational-ai/how-conversation-ai-core-capabilities.md @@ -32,7 +32,7 @@ You need to use the AI library to scaffold bot and Adaptive Card handlers in you ### Send or receive message -This capability shows how to send and receive messages using the Agents SDK. The sample listens for user messages, deletes the conversation state upon receipt, tracks the number of messages in a conversation, and echoes back the user's message with the count. +This capability shows how to send and receive messages using the Microsoft 365 Agents SDK (previously known as Bot Framework SDK). The sample listens for user messages, deletes the conversation state upon receipt, tracks the number of messages in a conversation, and echoes back the user's message with the count. # [.NET](#tab/dotnet6) @@ -94,7 +94,7 @@ async def on_message(context: TurnContext, _state: TurnState): ### Message extensions -This section demonstrates setting up Message Extensions in the Agents SDK's `TeamsActivityHandler`. The sample shows how the app listens for search actions and item taps. It formats search results as Hero Cards displaying package information and shows them in the messaging extension. +This section demonstrates setting up Message Extensions in the Microsoft 365 Agents SDK's (previously known as Bot Framework SDK) `TeamsActivityHandler`. The sample shows how the app listens for search actions and item taps. It formats search results as Hero Cards displaying package information and shows them in the messaging extension. # [.NET](#tab/dotnet5) @@ -565,7 +565,7 @@ elif config.AZURE_OPENAI_KEY and config.AZURE_OPENAI_ENDPOINT: ### Message extension query -The Teams AI library provides an intuitive way to create handlers for message extension query commands. This functionality works alongside the existing Teams Agents SDK. +The Teams AI library provides an intuitive way to create handlers for message extension query commands. This functionality works alongside the existing Teams Microsoft 365 Agents SDK (previously known as Bot Framework SDK). The following example shows how to structure the code to handle a message extension query for the `searchCmd` command. diff --git a/msteams-platform/bots/how-to/teams-conversational-ai/how-conversation-ai-get-started.md b/msteams-platform/bots/how-to/teams-conversational-ai/how-conversation-ai-get-started.md index 54195fe85a0..4d6df153bd4 100644 --- a/msteams-platform/bots/how-to/teams-conversational-ai/how-conversation-ai-get-started.md +++ b/msteams-platform/bots/how-to/teams-conversational-ai/how-conversation-ai-get-started.md @@ -56,7 +56,7 @@ builder.Services.AddSingleton(sp => sp.GetService()); [Sample code reference](https://github.com/microsoft/teams-ai/blob/main/js/samples/04.ai-apps/a.teamsChefBot/src/index.ts#L9) -### JavaScript Code: Adapter Setup and Bot Framework Authentication +### JavaScript Code: Adapter Setup and Microsoft 365 Agents SDK Authentication ```javascript // Import required bot services. @@ -139,7 +139,7 @@ import { VectraDataSource } from './VectraDataSource'; ## Create AI components -You can create AI components in an existing bot app or in a new Bot Framework app. The main components include: +You can create AI components in an existing bot app or in a new Microsoft 365 Agents SDK (previously known as Bot Framework SDK) app. The main components include: * **OpenAIModel**: Provides access to the OpenAI API—or any service following the OpenAI REST format. It works with both OpenAI and Azure OpenAI language models. * **Prompt Manager**: Manages prompt creation. It inserts functions, conversation state, and user state into the prompt automatically. @@ -889,7 +889,7 @@ To support Microsoft 365 Copilot Chat, update your app manifest: ## Elevate your conventional bot to use AI -You can update your existing conventional bot to be powered by AI. Adding an AI layer enhances your bot with LLM-driven features. Below is an example of integrating the AI layer using the Bot Framework adapter and the `app` object. +You can update your existing conventional bot to be powered by AI. Adding an AI layer enhances your bot with LLM-driven features. Below is an example of integrating the AI layer using the Microsoft 365 Agents SDK (previously known as Bot Framework SDK) adapter and the `app` object. ### JavaScript Code: Elevating a Conventional Bot to Use AI @@ -974,16 +974,16 @@ server.post('/api/messages', async (req, res) => { ## Migrate your bot to use Teams AI library -If you built your bot using the Bot Framework SDK, you can migrate to the Teams AI library to unlock advanced AI features. Migrating offers these benefits: +If you built your bot using the Microsoft 365 Agents SDK (previously known as Bot Framework SDK) SDK, you can migrate to the Teams AI library to unlock advanced AI features. Migrating offers these benefits: * Advanced AI system for building complex Teams applications powered by LLM. * Integrated user authentication for accessing third-party user data. -* Leverages familiar Bot Framework SDK tools and concepts. +* Leverages familiar Microsoft 365 Agents SDK (previously known as Bot Framework SDK) SDK tools and concepts. * Supports the latest LLM tools and APIs. Choose the relevant migration guide for your bot's language: -| Migrate a Bot Framework SDK app ... | To use Teams AI library ... | +| Migrate a Microsoft 365 Agents SDK (previously known as Bot Framework SDK) app ... | To use Teams AI library ... | | ------------------------------------|-----------------------------| | A bot app built using JavaScript | [Migrate](https://github.com/microsoft/teams-ai/blob/b34bbd14e9d13aed140686e4f91dbb673982b1cf/getting-started/MIGRATION/01.JS.md) | | A bot app built using C# | [Migrate](https://github.com/microsoft/teams-ai/blob/b34bbd14e9d13aed140686e4f91dbb673982b1cf/getting-started/MIGRATION/02.DOTNET.md) |