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.
- Para saber como criar um bot, confira o guia de início rápido Criar um bot com o SDK do Bot Framework.
- Para obter informações sobre como provisionar e publicar um bot no Azure, confira como Implantar seu bot no 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# e JavaScript na versão 4.15.0. Esses tipos de aplicativos não são compatíveis com outras linguagens ou com o Bot Framework Composer, o Bot Framework Emulator ou o ngrok.
| Tipo de aplicativo | Suporte |
|---|---|
| Identidade gerenciada atribuída pelo usuário | Serviço de Bot de IA do Azure e os SDKs C# e JavaScript |
| Locatário único | Serviço de Bot de IA do Azure e os SDKs C# e JavaScript |
| Multilocatário | Serviço de Bot de IA do Azure, todas as linguagens do SDK do Bot Framework, Composer, Emulator e ngrok |
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.
Vá para o Portal do Azure.
No painel à direita, selecione Criar um recurso.
Na caixa de pesquisa, insira
bote pressione Enter.Selecione o cartão do Bot do Azure.
Selecione Criar.
Insira valores nos campos obrigatórios e revise e atualize as configurações.
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 locais está disponível para recursos na região "westeurope" e "centralindia". Para obter mais informações, confira como Regionalização no Serviço de Bot de IA do Azure.
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.
Selecione Examinar + criar.
Se os testes de validação forem aprovados, selecione Criar.
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.
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.
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
As versões Java e Python do SDK do Bot Framework oferecem suporte apenas a bots multilocatário. As versões para C# e para JavaScript oferecem suporte a todos os três tipos de aplicativos para o gerenciamento da 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 | Suporta apenas bots multilocatário. Forneça as propriedades de identidade como argumentos para as chamadas de método os.environ.get. |
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 somente para bots em C# e JavaScript.
| 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:
- Acesse a folha Serviço de Aplicativo do aplicativo Web do bot.
- Em Configurações, selecione Identidade.
- Na folha Identidade, selecione a guia Atribuído pelo usuário e Adicionar (+).
- Na folha Adicionar a identidade gerenciada atribuída pelo usuário:
Selecione sua assinatura.
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.
Selecione Adicionar para usar essa identidade para o bot.
Como obter a ID do aplicativo ou do locatário
Para obter a ID do aplicativo ou do locatário do bot:
- Acesse a folha de recursos do Bot do Azure para seu bot.
- 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:
- Acesse a folha de recursos do Bot do Azure para seu bot.
- Acesse a folha Configuração do bot.
- Selecione Gerenciar, ao lado da ID do Aplicativo da Microsoft, para acessar a folha Certificados + segredos do serviço de aplicativo.
- Siga as instruções na folha para criar um novo segredo do cliente e registrar o valor em um local seguro.
Informações adicionais
- Para obter informações sobre gerenciamento de identidades com o Microsoft Entra ID, confira O que é o Microsoft Entra ID?.
- Para obter informações sobre o Serviço de Aplicativo do Azure e os planos do Serviço de Aplicativo, confira a visão geral do Serviço de Aplicativo.
- Para obter informações sobre os recursos do Azure e como eles são gerenciados em geral, confira a visão geral do Azure Resource Manager.
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.