Partilhar via


Registrar um bot com o Azure

APLICA-SE A: SDK v4

Se você não hospeda atualmente seu bot no Azure, ainda pode disponibilizá-lo no Azure e usar o Azure para conectar seu bot a canais. Para fazer isso, insira no Azure o endereço da Web onde seu bot está hospedado.

Este artigo mostra como registrar esse bot com o Serviço de Bot do Azure AI.

Importante

Você só precisa registrar um bot se ele não estiver hospedado no Azure. Os bots criados usando a CLI do Azure já estão registrados no Serviço de Bot do Azure AI.

Sua identidade de bot pode ser gerenciada no Azure de algumas maneiras diferentes.

  • Como uma identidade gerenciada atribuída pelo usuário, para que você não precise gerenciar as credenciais do bot por conta própria.
  • Como um aplicativo de locatário único.
  • Como um aplicativo multilocatário .

O suporte para a identidade gerenciada atribuída pelo usuário e os tipos de aplicativo de locatário único foi adicionado ao SDK do Bot Framework para C#, JavaScript e Python. Esses tipos de aplicativo não são suportados em outros idiomas ou no Bot Framework Composer, Bot Framework Emulator ou Dev Tunnels.

Tipo de aplicação Suporte
Identidade gerida atribuída pelo utilizador Serviço de Bot do Azure AI e os SDKs C#, JavaScript e Python
Inquilino único Serviço de Bot do Azure AI e os SDKs C#, JavaScript e Python
Multi-inquilino Serviço de Bot do Azure AI, todas as linguagens do SDK do Bot Framework, Composer, Emulador e Túneis de Desenvolvimento

Este artigo não descreve como criar ou implantar o bot para registrar. Para obter mais informações, consulte:

Criar o recurso

Crie o recurso de Bot do Azure, que permitirá que você registre seu bot no Serviço de Bot do Azure AI.

Gorjeta

Novos recursos de registro de Bot e Canais de Bot de Aplicativo Web não podem ser criados, no entanto, todos os recursos existentes configurados e implantados continuarão a funcionar. Os bots criados a partir de um modelo VSIX ou Yeoman do SDK versão 4.14.1.2 ou posterior contêm modelos ARM que gerarão um recurso de Bot do Azure.

  1. Aceda ao portal do Azure.

  2. No painel direito, selecione Criar um recurso.

  3. Na caixa de pesquisa, introduza bote, em seguida, prima Enter.

  4. Selecione o cartão de Bot do Azure.

    Selecione o recurso de bot do Azure

  5. Selecione Criar.

  6. Insira valores nos campos obrigatórios e revise e atualize as configurações.

    1. Forneça informações em Detalhes do projeto. Selecione se seu bot terá residência de dados global ou local. Atualmente, o recurso de residência de dados locais está disponível para recursos na região "Europa Ocidental" e "Centralíndia". Para obter mais informações, consulte Regionalização no Serviço de Bot do Azure AI.

      As configurações de detalhes do projeto para um recurso de Bot do Azure

    2. Forneça informações em ID do Aplicativo Microsoft. Selecione como sua identidade de bot será gerenciada no Azure e se deseja criar uma nova identidade ou usar uma existente.

      As configurações de ID do aplicativo Microsoft para um recurso de Bot do Azure

  7. Selecione Rever + criar.

  8. Se a validação for aprovada, selecione Criar.

  9. Quando a implantação for concluída, selecione Ir para o recurso. Você deve ver o bot e os recursos relacionados listados no grupo de recursos selecionado.

  10. Se você ainda não tiver o SDK do Bot Framework, selecione Baixar do GitHub para saber como consumir os pacotes para seu idioma preferido.

    Criar bot no SDK

Agora você está pronto para criar seu bot com o SDK do Bot Framework.

Gorjeta

Quando o Azure cria um novo recurso de Bot do Azure de locatário único ou multilocatário com uma nova ID de aplicativo, ele também gera uma senha.

Informações de identidade do bot

Siga estas etapas para adicionar informações de identidade ao arquivo de configuração do bot. O arquivo difere dependendo da linguagem de programação que você usa para criar o bot.

Importante

A versão Java do SDK do Bot Framework suporta apenas bots multilocatário. As versões C#, JavaScript e Python suportam os três tipos de aplicativos para gerenciar a identidade do bot.

Idioma Nome de ficheiro Notas
C# appsettings.json Suporta os três tipos de aplicativos para gerenciar a identidade do seu bot.
JavaScript .env Suporta os três tipos de aplicativos para gerenciar a identidade do seu bot.
Java application.properties Suporta apenas bots multilocatário.
Python config.py Suporta os três tipos de aplicativos para gerenciar a identidade do seu bot.

As informações de identidade que você precisa adicionar dependem do tipo de aplicativo do bot. Forneça os seguintes valores no arquivo de configuração.

Disponível para bots C#, JavaScript e Python.

Property valor
MicrosoftAppType UserAssignedMSI
MicrosoftAppId A ID do cliente da identidade gerenciada atribuída pelo usuário.
MicrosoftAppPassword Não aplicável. Deixe isso em branco para um bot de identidade gerenciado atribuído pelo usuário.
MicrosoftAppTenantId A ID do locatário da identidade gerenciada atribuída pelo usuário.

Para atualizar o serviço de aplicativo

Se você tiver um recurso existente do Serviço de Aplicativo (aplicativo Web) para seu bot e seu bot for um aplicativo de identidade gerenciado atribuído pelo usuário, talvez seja necessário atualizar o serviço de aplicativo do bot:

  1. Vá para a folha Serviço de Aplicativo do aplicativo Web do seu bot.
  2. Em Configurações, selecione Identidade.
  3. Na folha Identidade, selecione a guia Usuário atribuído e Adicionar (+).
  4. Na folha Adicionar identidade gerenciada atribuída ao usuário:
    1. Selecione a sua subscrição.

    2. Em Identidades gerenciadas atribuídas ao usuário, selecione a identidade gerenciada para seu bot. Se a identidade gerenciada foi gerada automaticamente para você, ela terá o mesmo nome do seu bot.

    3. Selecione Adicionar para usar essa identidade para seu bot.

      A folha Identidade do Serviço de Aplicativo com a identidade gerenciada para o bot selecionada.

Para obter seu aplicativo ou ID de locatário

Para obter o aplicativo ou a ID de locatário do seu bot:

  1. Vá para a folha de recursos do Bot do Azure para seu bot.
  2. Vá para a folha Configuração do bot. Nessa folha, você pode copiar a ID do Aplicativo Microsoft ou a ID do Locatário do Aplicativo do bot.

Para gerar uma nova senha

Os bots de locatário único e multilocatário têm um segredo de aplicativo ou senha que você precisa para algumas operações. O Serviço de Bot do Azure AI oculta o segredo do bot. No entanto, o proprietário do recurso do Serviço de Aplicativo do bot pode gerar uma nova senha:

  1. Vá para a folha de recursos do Bot do Azure para seu bot.
  2. Vá para a folha Configuração do bot.
  3. Selecione Gerenciar, ao lado de ID do Aplicativo Microsoft, para ir para a folha Certificados + segredos do serviço de aplicativo.
  4. Siga as instruções na folha para criar um novo segredo do cliente e registrar o valor em um local seguro.

Registo manual da aplicação

É necessário um registo manual quando:

  • Você não consegue fazer os registros em sua organização e precisa de outra parte para criar a ID do aplicativo para o bot que está criando.
  • Você precisa criar manualmente seu próprio ID de aplicativo e senha.

Atualizar o bot

Para atualizar o arquivo de configuração do bot para incluir o ID e a senha do aplicativo, consulte ID e senha do aplicativo em como definir as configurações de registro do bot.

Informações adicionais

Consulte estes artigos para obter mais informações sobre os aplicativos do Azure em geral.

Assunto Artigo
Registo de aplicações Início Rápido: Registar uma aplicação na plataforma de identidade da Microsoft
Identidades geridas O que são identidades geridas para recursos do Azure?
Aplicativos de locatário único e multilocatário Arrendamento no Microsoft Entra ID

Próximos passos

Manage a bot (Gerir um bot)