Definir as configurações de registro de bot
APLICA-SE A: SDK v4
As configurações de recurso do Bot do Azure, como nome de exibição, ícone e descrição, podem ser exibidas e modificadas no painel Perfil do Bot. As configurações de recurso do Bot do Azure, como ponto de extremidade de mensagens, ID do aplicativo da Microsoft e Application Insights, podem ser exibidas e modificadas no painel de Configuração.
Perfil de Bot
Veja abaixo a lista dos campos do perfil do Bot:
| Campo | Descrição |
|---|---|
| Ícone | Um ícone personalizado para identificar visualmente seu bot nos canais e como o ícone do seu bot aparece no Microsoft Teams e em outros serviços. |
| Nome de exibição | O nome do seu bot em canais e diretórios. Você pode alterar esse valor mais tarde. |
| Identificador de Bot | Um identificador exclusivo para seu bot. Esse valor não pode ser alterado depois de criar seu bot com o Serviço de Bot. |
| Descrição | Uma descrição do seu bot Alguns canais exibem a descrição. Você pode alterar esse valor mais tarde. |
Para salvar as alterações, selecione Aplicar na parte inferior da folha.
Configuração
Veja abaixo a lista dos campos de Configuração:
| Campo | Descrição |
|---|---|
| Ponto de extremidade de mensagens | O ponto de extremidade para se comunicar com seu bot. |
| ID do Aplicativo da Microsoft | Identificador exclusivo para seu bot. Esse valor não pode ser alterado. Você pode gerar uma nova senha clicando no link Gerenciar. |
| Versão de transformação de esquema | A versão de transformação de esquema de bot a ser usada para este bot. Para obter mais informações, confira Conectar um canal a canais. |
| Chave de instrumentação do Application Insights | Chave exclusiva para a telemetria de bot. Copie sua chave do Application Insights do Azure para esse campo se você quiser receber telemetria de bot para este bot. Esse valor é opcional. Para obter mais detalhes sobre esse campo, veja Chaves do Application Insights. |
| Chave de API do Application Insights | Chave exclusiva para a análise de bot. Copie sua chave de API do Application Insights do Azure para esse campo se você quiser exibir análises sobre seu bot no painel. Esse valor é opcional. Para obter mais detalhes sobre esse campo, veja Chaves do Application Insights. |
| ID do Aplicativo do Application Insights | ID exclusiva para a análise de bot. Copie sua chave da ID do Application Insights do Azure para esse campo se você quiser exibir análises sobre seu bot no painel. Esse valor é opcional. Para obter mais detalhes sobre esse campo, veja Chaves do Application Insights. |
Para salvar as alterações, selecione Aplicar na parte inferior da folha.
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 suporta apenas bots multilocatário. A versão Python do SDK do Bot Framework oferece suporte a bots multilocatários e de locatário único. 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 | Oferece suporte a bots multilocatários e de locatário único. Forneça as propriedades 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 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. |
Informações Adicionais
Você pode usar az bot update para atualizar as configurações de bot por meio da linha de comando.