Compartilhar via


Use o portal do Azure para criar um recurso de Bot do Azure

APLICA-SE A: SDK v4

O recurso de Bot do Azure (recurso de bot) permite que você efetue o registro do bot no Serviço de Bot de IA do Azure e conecte o bot aos canais. É possível desenvolver, conectar e gerenciar bots para interagir com usuários independentemente de onde eles estejam, do aplicativo ou site até o Teams ou o Messenger, e muitos outros canais.

Este artigo descreve como criar um recurso de bot através do portal do Azure.

Gerenciando recursos

Quando você cria um recurso de bot, o Azure cria recursos associados. Alguns dos recursos criados dependem de como você decide gerenciar a identidade do seu bot.

Sua identidade de bot pode ser gerenciada no Azure de diversas maneiras.

  • Como uma identidade gerenciada atribuída pelo usuário, você não precisa 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 têm suporte em outras linguagens ou no Bot Framework Composer, no Bot Framework Emulator ou nos Dev Tunnels.

Tipo de aplicativo Suporte
Identidade gerenciada atribuída pelo usuário Serviço de Bot de IA do Azure e os SDKs de C#, JavaScript e Python
Locatário único Serviço de Bot de IA do Azure e os SDKs de C#, JavaScript e Python
Multilocatário Serviço de Bot de IA do Azure, todas as linguagens do SDK do Bot Framework, Composer, Emulador e Túneis de Desenvolvimento

Pré-requisitos

  • Se você não tiver uma assinatura do Azure, crie uma conta gratuita antes de começar.
  • O SDK do Bot Framework para C# ou para JavaScript versão 4.15.0, ou versões posteriores, para a identidade gerenciada atribuída pelo usuário e os bots de locatário único.

Criar o recurso

Crie o recurso Bot do Azure, que permitirá a você efetuar o registro do seu bot no Serviço de Bot de IA do Azure.

Dica

Não é possível criar novos recursos do Bot de aplicativo web e do Registro de Canais de Bot, no entanto, qualquer recurso existente que esteja configurado e implantado continuará a funcionar. Os bots criados usando um modelo VSIX ou Yeoman do SDK versão 4.14.1.2, ou versões posteriores, contêm modelos do ARM que gerarão um recurso de Bot do Azure.

  1. Acesse o portal do Azure.

  2. No painel à direita, selecione Criar um recurso.

  3. Na caixa de pesquisa, insira bot e pressione Enter.

  4. Selecione o cartão do 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 o bot terá residência de dados global ou local. Atualmente, o recurso de residência de dados local está disponível para recursos na região "europa ocidental" e "centralíndia". Para obter mais informações, confira como Regionalização no Serviço de Bot de IA do Azure.

      O projeto detalha as configurações de um recurso de Bot do Azure

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

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

  7. Selecione Examinar + criar.

  8. Se os testes de validação forem aprovados, selecione Criar.

  9. Assim que 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 tem o SDK do Bot Framework, selecione Fazer download usando o GitHub para saber como consumir os pacotes de seu idioma preferido.

    Criar bot no SDK

Agora, você está com tudo pronto para desenvolver o bot com o SDK do Bot Framework.

Dica

Quando o Azure cria um 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 usada para criar o bot.

Importante

A versão Java do SDK do Bot Framework dá suporte apenas a bots multilocatários. As versões C#, JavaScript e Python dão suporte a todos os três tipos de aplicativo para gerenciar a identidade do bot.

Idioma Nome do arquivo Observações
C# appsettings.json Oferece suporte a todos os três tipos de aplicativos para gerenciar a identidade do bot.
JavaScript .env Oferece suporte a todos os três tipos de aplicativos para gerenciar a identidade do bot.
Java application.properties Suporta apenas bots multilocatário.
Python config.py Oferece suporte a todos os três tipos de aplicativos para gerenciar a identidade do bot.

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

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

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

Para atualizar seu serviço de aplicativo

Se você tiver um recurso de serviço de aplicativo existente (aplicativo Web) para o bot e o bot for um aplicativo de identidade gerenciada atribuída pelo usuário, poderá ser necessário atualizar o serviço de aplicativo do bot:

  1. Acesse a folha Serviço de Aplicativo do aplicativo Web do bot.
  2. Em Configurações, selecione Identidade.
  3. Na folha Identidade, selecione a guia Atribuído pelo usuário e Adicionar (+).
  4. Na folha Adicionar a identidade gerenciada atribuída pelo usuário:
    1. Selecione sua assinatura.

    2. Para Identidades gerenciadas atribuídas pelo 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 o bot.

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

Como obter a ID do aplicativo ou do locatário

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

  1. Acesse a folha de recursos do Bot do Azure para seu bot.
  2. Acesse a folha Configuração do bot. Nessa folha, é possível copiar a ID do Aplicativo da Microsoft ou a ID do aplicativo do Locatário do bot.

Para gerar uma nova senha

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

  1. Acesse a folha de recursos do Bot do Azure para seu bot.
  2. Acesse a folha Configuração do bot.
  3. Selecione Gerenciar, ao lado da ID do Aplicativo da Microsoft, para acessar 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.

Informações adicionais

Observação

No momento, o Bot Framework Composer e o Bot Framework Emulator oferecem suporte somente para bots multilocatários. O SDK do Bot Framework para C# ou para JavaScript na versão 4.15.0, ou em versões posteriores, é necessário para a identidade gerenciada atribuída pelo usuário e para os bots de locatário único.

Suporte para habilidades

Alguns tipos de consumidores de habilidades não podem usar alguns tipos de bots de habilidades. A tabela a seguir descreve quais combinações são compatíveis.

  Habilidade de multilocatário Habilidade de locatário único Habilidade de identidade gerenciada atribuída pelo usuário
Consumidor de multilocatário Com suporte Sem suporte Sem suporte
Consumidor de locatário único Sem suporte Compatível se ambos os aplicativos pertencerem ao mesmo locatário Compatível se ambos os aplicativos pertencerem ao mesmo locatário
Consumidor de identidade gerenciada atribuída pelo usuário Sem suporte Compatível se ambos os aplicativos pertencerem ao mesmo locatário Compatível se ambos os aplicativos pertencerem ao mesmo locatário

Para obter informações sobre como configurar uma habilidade ou um consumidor de habilidades, confira Implementar uma habilidade ou Implementar um consumidor de habilidades.

Próximas etapas