Definir 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

Configurações de perfil de bot.

Abaixo está a lista dos campos de perfil de bot :

Campo Descrição
ícone um ícone personalizado para identificar visualmente seu bot em canais e como o ícone para o bot em Microsoft Teams ou 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 o bot. Esse valor não pode ser alterado depois de criar seu bot com o Serviço de Bot.
Description Uma descrição do bot. Alguns canais exibem a descrição. Você pode alterar esse valor mais tarde.

Para salvar suas alterações, selecione aplicar na parte inferior da folha.

Configuração

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

Abaixo está 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 do esquema de bot a ser usada para este bot. para obter mais informações, consulte Conexão um bot para 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 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 suas alterações, selecione aplicar na parte inferior da folha.

ID do aplicativo e senha

A ID e a senha do aplicativo de recursos do bot do Azure são atribuídas às variáveis do bot MicrosoftAppID e MicrosoftAppPassword contidas no arquivo de configuração do projeto bot. O arquivo difere dependendo da linguagem de programação que você usa para criar o bot, conforme mostrado na tabela a seguir.

Idioma Nome do Arquivo
C# appsettings.json
Java application.properties
JavaScript .env
Python config.py

Observação

O recurso de bot tem uma ID de aplicativo, mas como não há nenhum serviço de aplicativo associado a ele, não há senha. Para gerar a senha, siga as etapas na próxima seção.

Obter a senha de registro

Um recurso de bot do Azure tem uma ID de aplicativo (ID do aplicativo) e uma senha associada a ele. O serviço de bot do Azure atribui uma ID de aplicativo exclusiva ao aplicativo. Você pode obter a senha seguindo as etapas descritas abaixo.

  1. Em seu navegador, navegue até o portal do Azure.

  2. Na lista de recursos, clique no nome do aplicativo de registro.

  3. no painel direito, vá para a seção gerenciamento de Bot e clique em Configurações. a página de Configurações do aplicativo de registro será exibida.

  4. Selecione o link gerenciar ao lado de ID do aplicativo da Microsoft.

    Link para usar para abrir o painel certificados e segredos

  5. No painel certificados & segredos , clique no botão novo segredo do cliente .

    segredos do aplicativo de registro de bot

  6. Adicione a descrição, selecione a hora de expiração e clique no botão Adicionar.

    criar senha de registro de bot

    Isso irá gerar uma nova senha para o seu bot. Copie esta senha e salve-a em um arquivo. Esta é a única vez que você verá a senha. Se você não tiver a senha completa salva, será preciso repetir o processo para criar uma nova senha caso precise dela posteriormente.

Informações adicionais

Você pode usar az bot update para atualizar as configurações de bot por meio da linha de comando.