Share via

Provision agent resources in Azure Bot Service using User-Assigned Managed Identity

This article shows how to register an agent with Azure AI Bot Service using User Assigned Managed Identity.

Note

User-Assigned Managed Identity will not work for local debugging via devtunnels.

Create the resource

Create the Azure Bot resource. This allows you to register your agent with the Azure AI Bot Service.

  1. Go to the Azure portal.

  2. In the right pane, select Create a resource.

  3. Find and select the Azure Bot card.

    Screenshot of the Azure Bot resource card in the Azure portal marketplace.

  4. Select Create.

  5. Enter values in the required fields and review and update settings.

    a. Provide information under Project details. Select whether your agent will have global or local data residency. Currently, the local data residency feature is available for resources in the "westeurope" and "centralindia" region. For more information, see Regionalization in Azure AI Bot Service.

    Screenshot of the Azure Bot project details configuration page showing subscription, resource group, and region settings.

    b. Provide information under Microsoft App ID. Select how your agent identity will be managed in Azure and whether to create a new identity or use an existing one.

    Screenshot of the Azure Bot Microsoft App ID configuration section with identity management options.

  6. Select Review + create.

  7. If the validation passes, select Create.

  8. Once the deployment is completed, select Go to resource. You should see the agent and related resources listed in the resource group you selected.

  9. If this is a Teams or M365 agent

    1. Select Settings on the left sidebar, then Channels.
    2. Select Microsoft Teams from the list and choose appropriate options.

Important

Store the ClientID of the User Managed Identity. You need the information later when configuring your agent configuration.

Next Steps