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.

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.

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

• O início rápido Criar um bot
• O tutorial Implantar um bot básico

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.

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.

   

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.

      

   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.

      

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.

    

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

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.

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.

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.

      

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.

Próximos passos