Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion msteams-platform/bots/design/bots.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@ ms.date: 01/23/2025
---
# Designing your Microsoft Teams bot

Bots are conversational apps that perform a specific set of tasks. Based on the <a href="https://dev.botframework.com/" target="_blank">Microsoft Bot Framework</a>, bots communicate with users, respond to their questions, and proactively notify them about changes and other events. They're a great way to reach out.
Bots are conversational apps that perform a specific set of tasks. Based on the [Teams AI library](/microsoftteams/platform/teams-ai-library/), bots communicate with users, respond to their questions, and proactively notify them about changes and other events. They're a great way to reach out.

> [!IMPORTANT]
> Bots are available in [Government Community Cloud (GCC), GCC High, Department of Defense (DoD)](../../concepts/cloud-overview.md), and [Teams operated by 21Vianet](../../concepts/sovereign-cloud.md) environments.
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -14,7 +14,7 @@ Microsoft Entra ID provides app users access to your bot or message extension ap

## SSO configuration in Microsoft Entra admin center

The bot and message extension apps use Bot Framework for communicating with app users and implementing authentication.
The bot and message extension apps use Teams AI library for communicating with app users and implementing authentication.

To configure single sign-on (SSO) for your bot or message extension app, you'll need to:

Expand Down Expand Up @@ -421,7 +421,7 @@ For a bot to support SSO, you must update its OAuth connection settings. This pr
* Tenant ID
* Scope and permissions

With the app (client) ID and client secret provided, the Bot Framework Token Store exchanges the token for a graph token with defined permissions.
With the app (client) ID and client secret provided, the Teams AI library Token Store exchanges the token for a graph token with defined permissions.
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I don't think this should be a simple working swap. @MSFTRickyCastaneda what is the equivalent token names here?

Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

agree started GC with engineering to help clarify

Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@MSFTRickyCastaneda any update on this comment?


### To update OAuth connection

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -190,8 +190,6 @@ 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).

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).

## Next step
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -95,7 +95,7 @@ In the **Configure** section, you can see the following components to manage and
* **Permissions**: This section allows you to give **Device permissions**, **Team Permissions**, **Chat/Meeting permissions**, and **User Permissions** for your app.
> [!NOTE]
> The maximum limit for RSC permissions is 16.
* **Single sign-on**: Bot registered on Microsoft Entra ID supports single sign-on (SSO). If a bot is registered on Bot Framework portal (or within the Developer Portal under **Bot management**), then a bot doesn't support SSO, and you have to register your bot on Microsoft Entra ID to support SSO. For a bot registered on Microsoft Entra ID, add the **Application ID URI**. To get **Application ID URI** from Microsoft Entra ID, see [how to use SSO authentication for bots](../../bots/how-to/authentication/auth-aad-sso-bots.md).
* **Single sign-on**: Bot registered on Microsoft Entra ID supports single sign-on (SSO). If a bot is registered on the Developer Portal under **Bot management**, then a bot doesn't support SSO, and you have to register your bot on Microsoft Entra ID to support SSO. For a bot registered on Microsoft Entra ID, add the **Application ID URI**. To get **Application ID URI** from Microsoft Entra ID, see [how to use SSO authentication for bots](../../bots/how-to/authentication/auth-aad-sso-bots.md).
* **Languages**: This section allows you to set up or change the language of your app.
* **Domain**: This section allows you to add the domains to load your apps in the Teams client, such as *.example.com.

Expand Down Expand Up @@ -258,8 +258,6 @@ To add a bot:

:::image type="content" source="../../assets/images/tdp/Add_new_bot.PNG" alt-text="Add a new bot by using bot management option." lightbox="../../assets/images/tdp/Add_new_bot.PNG":::

From the Developer Portal, you can go to Bot Framework portal and configure your bot to update icon and other properties.

> [!NOTE]
> Bot ID doesn't support environment variables.

Expand Down