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

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

Para configurar seu chatbot clássico como uma habilidade:

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

2. Faça o download do manifesto de habilidades para o chatbot clássico.

3. Conecte-se a uma habilidade do Copilot Studio a partir do seu bot.

4. Confirme se o bot funciona como uma habilidade.

Pré-requisitos

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

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

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

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

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

3. No menu de navegação, vá para Configurações e selecione Segurança. Em seguida, selecione Lista de permissões.

4. Selecione Adicionar chamador permitido.

5. Cole o ID do aplicativo do bot do Serviço de Bot e selecione Avançar.

   Atenção

   Um chatbot clássico não pode funcionar como uma habilidade para outros chatbots clássicos. Se você tentar adicionar uma ID de aplicativo que pertence a um bot do Power Virtual Agent à lista de permissões, receberá um erro. Você só pode adicionar um ID de aplicativo para um bot de Bot.

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

6. (Opcional) Adicione um Nome para exibição para o bot que você adicionou à lista de permissões.

7. Selecione Guardar.

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

Faça o download do manifesto de habilidade do chatbot clássico para o seu chatbot clássico

Os 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 inclui o nome, a interface e as frases de gatilho da habilidade.

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

Os manifestos de habilidade do Copilot Studio seguem a versão 2.2 do esquema de manifesto de habilidade do Serviço de Bot e consistem em arquivos intents.lu e manifest.json .

Um bot de Serviço de Bot pode decidir que um chatbot clássico deve lidar com a solicitação do usuário, com base nos dados do manifesto. Ele passa tudo o que o usuário disse para o chatbot clássico. Em seguida, o chatbot clássico corresponde ao que o usuário disse a um tópico do Copilot Studio, extrai todas as entidades necessárias para o preenchimento do slot e aciona o tópico do Copilot Studio.

Os manifestos de habilidade do Copilot Studio são gerados e atualizados automaticamente. Um chatbot clássico tem dois manifestos de habilidade:

• Manifesto de teste: Permite que o bot do Serviço de Bot se conecte à versão de teste do seu chatbot clássico. Use o manifesto de teste para validar as alterações em sua habilidade antes de publicá-lo.

  • O manifesto de teste está imediatamente disponível para cada chatbot clássico recém-criado.
  • Ele é atualizado automaticamente para refletir as alterações sempre que você salva seu chatbot clássico.

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

  • O manifesto publicado só está disponível para chatbots clássicos que foram publicados pelo menos uma vez.
  • Ele é atualizado automaticamente para refletir as alterações sempre que você publica seu agente.

Ambos os manifestos de habilidade são mostrados no painel Gerenciar lista de permissões .

Os manifestos de competências também são mostrados na página de Detalhes do chatbot. No menu de navegação, selecione Configurações e, em seguida, selecione Detalhes. A página Detalhes mostra outros metadados, incluindo ID do ambiente, ID do locatário e ID do aplicativo Bot.

Para baixar um manifesto, selecione-o. Ele é baixado como um arquivo de .zip chamado manifesto<> _bot para o manifesto Publicado ou <> de nome de bot para o manifesto de teste.

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

Você pode usar as informações do manifesto de habilidades do Copilot Studio para criar uma conexão de habilidade no bot do Serviço de Bot.

Para saber mais sobre a estrutura do manifesto de habilidades, consulte Manifesto de habilidades.

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

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

Teste seu chatbot clássico como uma habilidade com um bot de serviço de bot

Você pode usar o Bot Service Emulator para testar se o bot do Bot Service está chamando corretamente um chatbot clássico como uma habilidade.

Atualizar um bot de serviço de bot multilocatário para um bot de locatário único

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

Tanto o bot do Serviço de Bot quanto o chatbot clássico têm um registro do aplicativo Microsoft Entra ID, que é referenciado pelas instâncias do Bot do Azure. Esses registros do aplicativo Microsoft Entra ID foram criados como multilocatário. O bot do Serviço de Bot solicita um token do locatário do Serviço de Bot e usa esse token para autenticar no Copilot Studio usando o Serviço de Bot do Azure. Copilot Studio usa o mesmo mecanismo para entrar em contato com o bot Bot Service.

O registo da aplicação do chatbot Copilot Studio é agora criado como um inquilino único, pelo que esta comunicação já não funciona. O Microsoft Entra ID se recusa a criar tokens para registros de aplicativos 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 locatários que não espera, como o ID do locatário no qual o registro de aplicativo do chatbot clássico foi criado.

Para resolver esse problema, há duas correções possíveis.

Chatbots clássicos no mesmo locatário que o bot do Serviço de Bot

Em cenários em que o chatbot do Copilot Studio já está implantado no mesmo locatário que o bot do Serviço de Bot e é usado apenas por esse bot, atualize o bot para uma configuração de locatário ú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.

Chatbot do Copilot Studio que não pode ser atualizado para um único locatário

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

Saiba mais

• Visão geral de competências
• Manifesto de competências
• Teste uma habilidade no emulador