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.
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
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:
- 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.
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)