Usar 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ê registre seu bot no Serviço de Bot de IA do Azure e conecte seu bot a canais. Você pode criar, conectar e gerenciar bots para interagir com seus usuários onde quer que eles estejam, desde seu aplicativo ou site até o Teams, 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, consulte 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, consulte como implantar seu bot no Azure.
Gestão de 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 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# e JavaScript na versão 4.15.0. Esses tipos de aplicativo não são suportados em outros idiomas ou no Bot Framework Composer, Bot Framework Emulator ou ngrok.
| Tipo de aplicação | Suporte |
|---|---|
| Identidade gerida atribuída pelo utilizador | Serviço de Bot do Azure AI e os SDKs C# e JavaScript |
| Inquilino único | Serviço de Bot do Azure AI e os SDKs C# e JavaScript |
| Multi-inquilino | Serviço de Bot do Azure AI, todas as linguagens do SDK do Bot Framework, Composer, o Emulador e ngrok |
Pré-requisitos
- Se não tiver uma subscrição do Azure, crie uma conta gratuita antes de começar.
- O SDK do Bot Framework para C# ou JavaScript versão 4.15.0 ou posterior, para identidade gerenciada atribuída pelo usuário e bots de locatário único.
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.
Aceda ao portal do Azure.
No painel direito, selecione Criar um recurso.
Na caixa de pesquisa, introduza
bote, em seguida, prima Enter.Selecione o cartão de 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 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.
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.
Selecione Rever + criar.
Se a validação for aprovada, selecione Criar.
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.
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.
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
As versões Java e Python do SDK do Bot Framework suportam apenas bots multilocatário. As versões C# e JavaScript 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 apenas bots multilocatário. Forneça as propriedades de identidade como argumentos para as chamadas de os.environ.get método. |
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 apenas para bots C# e JavaScript.
| 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:
- Vá para a folha Serviço de Aplicativo do aplicativo Web do seu bot.
- Em Configurações, selecione Identidade.
- Na folha Identidade, selecione a guia Usuário atribuído e Adicionar (+).
- Na folha Adicionar identidade gerenciada atribuída ao usuário:
Selecione a sua subscrição.
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.
Selecione Adicionar para usar essa identidade para seu bot.
Para obter seu aplicativo ou ID de locatário
Para obter o aplicativo ou a ID de locatário do seu bot:
- Vá para a folha de recursos do Bot do Azure para seu bot.
- 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:
- Vá para a folha de recursos do Bot do Azure para seu bot.
- Vá para a folha Configuração do bot.
- Selecione Gerenciar, ao lado de ID do Aplicativo Microsoft, para ir para 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 o gerenciamento de identidades com o Microsoft Entra ID, consulte 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, consulte 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, consulte a visão geral do Azure Resource Manager.
Nota
Atualmente, o Bot Framework Composer e o Bot Framework Emulator suportam apenas bots multilocatário. O SDK do Bot Framework para C# ou JavaScript versão 4.15.0 ou posterior é necessário para identidade gerenciada atribuída pelo usuário e bots de locatário único.
Apoio a competências
Alguns tipos de consumidores de habilidades não são capazes de usar alguns tipos de bots de habilidades. A tabela a seguir descreve quais combinações são suportadas.
| Habilidade multilocatária | Habilidade de inquilino único | Habilidade de identidade gerenciada atribuída pelo usuário | |
|---|---|---|---|
| Consumidor multilocatário | Suportado | Não suportado | Não suportado |
| Consumidor de inquilino único | Não suportado | Suportado se ambas as aplicações pertencerem ao mesmo inquilino | Suportado se ambas as aplicações pertencerem ao mesmo inquilino |
| Consumidor de identidade gerenciada atribuído pelo usuário | Não suportado | Suportado se ambas as aplicações pertencerem ao mesmo inquilino | Suportado se ambas as aplicações pertencerem ao mesmo inquilino |
Para obter informações sobre como configurar uma habilidade ou consumidor de habilidade, consulte Implementar uma habilidade ou Implementar um consumidor de habilidade.