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

Quando você usa um chatbot clássico como uma habilidade 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 gatilho 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 de correspondência.

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. Conecte-se 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 a ID do aplicativo do bot do Serviço de Bot.

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

Adicione a ID do aplicativo do bot do Serviço de Bot à lista de permissões do 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. No menu de navegação, acesse Configurações e selecione Segurança. Depois, selecione Lista de permitidos.

4. Selecione Adicionar chamador permitido.

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

   Cuidado

   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 permitidos, receberá um erro. Você só pode adicionar uma ID de aplicativo para um bot de bot.

   O Copilot Studio valida a 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 de exibição ao bot que você adicionou à lista de permitidos.

7. Selecione Salvar.

O bot do Serviço de Bot será exibido pelo nome de exibição se você inseriu um ou por sua 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 habilidade do chatbot clássico para 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 tem o nome, a interface e as frases de gatilho de uma habilidade.

Um bot do Serviço de Bot pode usar um manifesto de habilidade para saber quando disparar 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 do 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 ao chatbot clássico. Em seguida, o chatbot clássico corresponde o que o usuário disse para um tópico do Copilot Studio, extrai quaisquer entidades necessárias para preencher o slot, e aciona o tópico do Copilot Studio.

Todos os manifestos de habilidades 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 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 as mudanças sempre que você salvar 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 está disponível apenas para os chatbots clássicos que foram publicados pelo menos uma vez.
  • Ele é atualizado automaticamente para refletir as mudanças sempre que você publicar seu agente.

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

Os manifestos de habilidades também são exibidos na página de Detalhes do chatbot. No menu de navegação, selecione Configurações e Detalhes. A página Detalhes mostra outros metadados, incluindo o ID do ambiente, ID do Inquilino e ID do aplicativo do 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 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 o manifesto 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 do 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

Você pode o Emulador do Serviço de Bot para testar se o bot do Serviço de Bot está chamando corretamente um chatbot clássico como uma habilidade.

Atualizar um bot do 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 do Serviço de Bot chama um chatbot clássico para usá-lo como uma habilidade.

O bot do Serviço de Bot e o chatbot clássico têm um registro de aplicativo do Microsoft Entra ID, que é referenciado pelas instâncias do Bot do Azure. Esses registros de aplicativo do 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. O Copilot Studio usa o mesmo mecanismo para entrar em contato com o bot do Serviço de Bot.

O registro do aplicativo do chatbot do Copilot Studio agora é criado como um único locatário, portanto, essa comunicação não funciona mais. O Microsoft Entra ID se recusa a criar tokens para registros de aplicativos de locatário único que não estão no mesmo locatário.

Além disso, o Copilot Studio valida o token de entrada e rejeita solicitações de locatários que ele não espera, como a ID do locatário na 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 só é usado 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 do Serviço de Bot para locatário único, consulte Provisionar e publicar um bot.

O chatbot 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 bot do Serviço de Bot, mas o bot não pode ser atualizado para locatário único, 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 locatário único.

Saiba mais

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