Usar um chatbot clássico como uma habilidade em um bot do Serviço de Bot

Quando você utiliza um chatbot clássico como uma skill com um bot do Serviço de Bot, o bot do Serviço de Bot determina se algo que o usuário diz corresponde às frases de ativação do chatbot clássico. Se houver uma correspondência, o bot do Serviço de Bot poderá passar a conversa para o chatbot clássico. O chatbot clássico extrai quaisquer entidades e dispara o tópico correspondente.

Para configurar o chatbot clássico como uma habilidade:

1. Adicione o bot do Serviço de Bot à lista de permissões do chatbot clássico.

2. Baixe o manifesto de habilidade do chatbot clássico.

3. Conectar a uma habilidade do Copilot Studio do seu bot.

4. Confirme se o bot funciona como uma habilidade.

Pré-requisitos

• Entenda como funcionam as habilidades de serviço de bot.
• Obtenha o ID do aplicativo do seu bot do Serviço de Bot.

Adicionar seu bot de Serviço de Bot à lista de permissões para seu chatbot clássico

Adicione a ID do aplicativo do Serviço de Bot bot à lista de permissões para o chatbot clássico que você deseja usar como uma habilidade. Os bots precisam estar no mesmo locatário.

1. Obtenha a ID do aplicativo da Microsoft para o bot dos Serviços de Bot. Você pode encontrar essas informações no portal do Azure ou nas configurações de bot.

2. No Copilot Studio, abra o chatbot clássico que você deseja usar como uma habilidade.

3. Vá em Configurações, selecione Segurança e depois selecione Lista de Permissões.

4. Selecione Adicionar chamador permitido.

5. Cole a ID do app do Serviço de Bot e selecione Próximo.

   Cuidado

   Um chatbot clássico não pode funcionar como uma função de outros chatbots clássicos. Se você tentar adicionar um ID de app que pertença a um chatbot clássico à lista de permitidos, recebe um erro. Você só pode adicionar uma ID de aplicativo para um bot de Serviço de Bot.

   O Copilot Studio valida a ID do aplicativo do bot do Serviço de Bot e confirma se ele pertence a um bot no mesmo locatário.

6. (Opcional) Adicione um nome de exibição para o bot que você adicionou à lista de permitidos.

7. Clique em Salvar.

O bot do Serviço de Bot será exibido pelo nome de exibição se você inseriu um, ou pela ID do aplicativo se você não inseriu um nome de exibição. Para excluí-lo ou editá-lo a qualquer momento, selecione o ícone à direita do nome de exibição do bot ou do ID do aplicativo.

Baixe o manifesto de habilidades do seu chatbot clássico

Bots do Serviço de Bot podem usar um manifesto de habilidade do Copilot Studio para configurar uma conexão com o chatbot clássico que produziu o manifesto.

Todos os chatbots clássicos têm manifestos de habilidade. Um manifesto de habilidade é um arquivo JSON que tem o nome, a interface e as frases de gatilho de uma habilidade.

Um bot Serviço de Bot usa um manifesto de habilidade para saber quando disparar o chatbot clássico (por exemplo, em resposta a algo que um usuário diz).

os manifestos de habilidade do Copilot Studio seguem version 2.2 do esquema de manifesto de habilidade Serviço de Bot e consistem em arquivos intents.lu e manifest.json.

Com base nos dados do manifesto, um bot de Serviço de Bot pode decidir que um chatbot clássico deve lidar com a solicitação do usuário. O bot repassa tudo o que o usuário disse para o chatbot. Depois, o chatbot associa o que o usuário disse a um tópico, extrai quaisquer entidades necessárias para preencher o slot e aciona o tema.

Copilot Studio gera e atualiza automaticamente manifestos de habilidade. Um chatbot clássico tem dois manifestos de habilidade:

• Test manifest: permite que o bot Serviço de Bot se conecte à versão de teste do seu chatbot clássico. Use o manifesto de teste para validar as mudanças em sua habilidade antes de publicá-la.

  • O manifesto de teste está imediatamente disponível para cada chatbot clássico criado.
  • Ele é atualizado automaticamente para refletir mudanças toda vez que você salva seu chatbot clássico.

• Published manifest: permite que o bot Serviço de Bot se conecte à versão publicada do seu chatbot clássico.

  • O manifesto publicado está disponível apenas para os chatbots clássicos que foram publicados pelo menos uma vez.
  • Ele é atualizado automaticamente para refletir mudanças toda vez que você publicar seu chatbot clássico.

Ambos os manifestos de habilidades aparecem no painel Gerenciar Lista de Permissões .

Os manifestos de habilidades também aparecem na página de Detalhes do chatbot. Vá em Configurações e selecione Detalhes. A página de Detalhes mostra outros metadados, incluindo ID de Ambiente, ID de Inquilino e ID do aplicativo Bot.

Para baixar um manifesto, selecione-o. Ele é baixado como um arquivo .zip denominado _<bot name>manifest para o Manifesto publicado, ou <bot name>test__manifest para o Manifesto de teste.

Conectar-se a uma habilidade do Copilot Studio a partir do seu bot

Use as informações do manifesto de habilidade do Copilot Studio para criar uma conexão de habilidade em seu bot de Serviço de Bot.

Para mais informações sobre a estrutura do manifesto de habilidades, veja Manifesto de Habilidades.

A seção de atividades do manifesto de habilidade contém os tópicos disponíveis em seu chatbot clássico.

Você pode implementar um consumidor de habilidades em seu bot Serviço de Bot para chamar um chatbot clássico como uma habilidade.

Testar seu chatbot clássico como uma habilidade com um bot do Serviço de Bot

Use o emulador Serviço de Bot para testar se o bot Serviço de Bot está chamando corretamente um chatbot clássico como uma habilidade.

Atualizar um bot do Serviço de Bot de múltiplos locatários para um bot de locatário único

A ilustração a seguir mostra o cenário em que um bot do Serviço de Bot chama um chatbot clássico para utilizá-lo como habilidade.

Tanto o bot do Serviço de Bot quanto o chatbot clássico possuem um registro de aplicativo Microsoft Entra ID, ao qual as instâncias do bot do Azure fazem referência. Você cria esses registros de aplicativo do Microsoft Entra ID como multilocatário. O bot Serviço de Bot solicita um token do locatário Serviço de Bot e usa esse token para autenticar no Copilot Studio usando Azure Serviço de Bot. Copilot Studio usa o mesmo mecanismo para entrar em contato com o bot Serviço de Bot.

Como o registro do aplicativo do chatbot do Copilot Studio agora é de locatário único, essa comunicação não funciona mais. Microsoft Entra ID se recusa a criar tokens para registros de aplicações de locatário único que não estejam no mesmo locatário.

Além disso, o Copilot Studio valida o token de entrada e rejeita solicitações de inquilinos que ele não espera, como o ID do inquilino no qual o registro de aplicativo do chatbot clássico foi criado.

Para resolver esse problema, siga as orientações que se aplicam à sua situação:

• Chatbots clássicos no mesmo inquilino que o Bot do Serviço de Bot — Em cenários em que o Chatbot do Copilot Studio já está implantado no mesmo inquilino que o Bot do Serviço de Bot e é usado apenas por esse Bot, atualize o bot para a configuração de inquilino único e reimplante o Bot do Serviço de Bot. Para obter mais informações sobre como configurar um bot de Serviço de Bot para locatário único, consulte Provisionar e publicar um bot.

• Chabot do Copilot Studio que não pode ser atualizado para locatário único — Em cenários em que o chatbot do Copilot Studio já está implantado no mesmo locatário que o Serviço de Bot bot, mas o bot não pode ser atualizado para locatário único, atualize o código no Serviço de Bot bot para criar o token para se comunicar com o chatbot do Copilot Studio. O token precisa ser criado para o tenant em que o chatbot do Copilot Studio foi criado também. Além disso, a resposta deve ser aceita, o que provavelmente requer que você siga as etapas em Converter um recurso existente de multilocatário para locatário único.

Informações relacionadas

• Visão geral de habilidades
• Manifesto de habilidades
• Teste uma habilidade no Emulator