Partilhar via


Definir configurações de registro de bot

APLICA-SE A: SDK v4

As configurações de recursos do Bot do Azure, como nome para exibição, ícone e descrição, podem ser exibidas e modificadas no painel de perfil do Bot. As configurações de recursos do Bot do Azure, como ponto de extremidade de mensagens, ID do aplicativo Microsoft e Application Insights, podem ser exibidas e modificadas no painel Configuração .

Perfil do bot

Configurações do perfil do bot.

Abaixo está a lista dos campos de perfil do Bot:

Campo Descrição
Ícone Um ícone personalizado para identificar visualmente seu bot em canais e como o ícone para seu bot no Microsoft Teams ou em outros serviços.
Nome a apresentar O nome do seu bot em canais e diretórios. Você pode alterar esse valor mais tarde.
Identificador do 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.
Description 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

Definições de configuração do bot.

Abaixo está a lista dos campos Configuração:

Campo Descrição
Ponto de extremidade de mensagens O ponto de extremidade para se comunicar com seu bot.
ID do aplicativo Microsoft Identificador exclusivo para seu bot. Não é possível alterar este valor. Você pode gerar uma nova senha clicando no link Gerenciar .
Versão de transformação de esquema A versão de transformação do esquema do bot a ser usada para esse bot. Para obter mais informações, consulte Conectar um bot a canais.
Chave de instrumentação do Application Insights Chave exclusiva para telemetria de bot. Copie sua chave do Azure Application Insights para este campo se quiser receber telemetria de bot para esse bot. Este valor é opcional. Para obter mais detalhes sobre esse campo, consulte Chaves do Application Insights.
Chave da API do Application Insights Chave exclusiva para análise de bots. Copie sua chave de API do Azure Application Insights para este campo se quiser exibir análises sobre seu bot no Painel. Este valor é opcional. Para obter mais detalhes sobre esse campo, consulte Chaves do Application Insights.
Application Insights Application ID ID exclusivo para análise de bots. Copie sua Chave de ID de Aplicativo do Azure Insights para este campo se quiser exibir análises sobre seu bot no Painel. Este valor é opcional. Para obter mais detalhes sobre esse campo, consulte 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 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.

Informações Adicionais

Você pode usar az bot update para atualizar as configurações do bot a partir da linha de comando.