Use um chatbot clássico como uma habilidade em um bot do Bot Framework

Quando você usa um chatbot clássico como um habilidade com um Bot Framework bot, o Bot Framework bot determina se algo que o usuário diz corresponde às frases Gatilho do chatbot clássico. Se There for uma correspondência, o Bot Framework bot passa a conversa para o chatbot clássico. O chatbot clássico extrai quaisquer entidades e aciona o tópico correspondente.

Você também pode passar uma variável para um Copilot Studio habilidade tópico como uma entrada do Bot Framework Composer e usar as saídas que ela retorna.

Para configurar seu chatbot clássico como um habilidade:

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

2. Baixe o manifesto habilidade para o chatbot clássico.

3. Use o manifesto habilidade baixado no Bot Framework Composer para criar uma conexão entre os bots.

4. Use o Bot Framework Emulador para confirmar se o bot funciona como um habilidade.

Pré-requisitos

• Entenda como as habilidades do Bot Framework funcionam.
• Entenda como usar o Bot Framework Composer.
• Entenda como usar as habilidades no Bot Framework Composer.
• Obtenha a ID do aplicativo do bot do Bot Framework.

Adicione seu Bot Framework bot à lista de permissões do seu chatbot clássico

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

1. No Bot Framework Compositor, abra o bot que usará a habilidade. Selecionar Configurar e, em seguida, selecione Recursos de desenvolvimento. Copie o ID em ID do Aplicativo da Microsoft.

2. Em Copilot Studio, abra o chatbot clássico que você deseja usar como 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 Bot Framework e selecione Avançar.

   Cuidado

   Um chatbot clássico não pode atuar como um 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 do Bot Framework.

   Copilot Studio valida o ID do aplicativo Bot Framework 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 permissões.

7. Selecione Salvar.

O bot do Bot Framework é mostrado por seu nome de exibição, caso você tenha inserido um, ou por seu ID de aplicativo, caso você não tenha. 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 clássico do chatbot habilidade para seu chatbot clássico

Bot Framework Os bots podem usar um manifesto Copilot Studio habilidade para configurar uma conexão com o chatbot clássico que produziu o manifesto.

Todos os chatbots clássicos têm manifestos habilidade. Esses são arquivos JSON que incluem o nome, a interface e as frases de gatilho de uma habilidade.

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

Copilot Studio Os manifestos habilidade seguem a versão 2.2 do Bot Framework esquema do manifesto habilidade e consistem nos arquivos intents.lu e manifest.json .

A Bot Framework bot pode decidir que o chatbot clássico deve lidar com a solicitação do usuário, com base nos dados do manifesto. Ele passa para o chatbot clássico tudo o que o usuário disse. Em seguida, o chatbot clássico compara o que o usuário disse a um Copilot Studio tópico, extrai quaisquer entidades necessárias para preenchimento de slots e aciona o Copilot Studio tópico.

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

• Manifesto de teste: permite que o Bot Framework 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 fica imediatamente disponível para cada chatbot clássico recém-criado.
  • Ele é atualizado automaticamente para refletir as alterações toda vez que você sálvia seu chatbot clássico.

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

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

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

Os manifestos de habilidade também são mostrados na página Detalhes do copiloto. 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 rotulado _<bot nome>manifesto para o manifesto publicado ou <bot nome>test__manifest para o manifesto de teste.

Conecte-se a um Copilot Studio habilidade no Composer

Use Copilot Studio manifestos habilidade para criar uma conexão habilidade em seu Bot Framework bot no Composer.

1. Em um projeto do Bot Framework Composer, selecione Adicionar e então Conectar-se a uma habilidade.

2. Navegue até e Select um Copilot Studio arquivo manifest .zip e depois Select Avançar.

3. Select os tópicos, ou intenções, no seu chatbot clássico que você deseja adicionar ao seu Bot Framework bot e depois Select Próximo.

4. Revise e edite as frases Gatilho para seu chatbot clássico e depois Select Avançar.

5. Certifique-se de que a opção Usar o Orchestrator para projetos com vários bots esteja selecionado e selecione Continuar.

6. Verifique se o Copilot Studio habilidade foi adicionado ao seu Bot Framework bot corretamente e se um novo Gatilho com o nome do seu chatbot clássico aparece no projeto no Composer.

Localizar o tópico no manifesto de habilidade

Use um evento para Gatilho a Copilot Studio tópico no habilidade. Para chamar um tópico específico do Composer, consulte o tópico pelo nome do evento associado no manifesto da habilidade.

1. Selecione a ação Conectar a uma habilidade.

2. Em Nome do diálogo da habilidade, selecione Mostrar manifesto de habilidade.

3. Encontrar atividades no manifesto. Esta propriedade contém propriedades aninhadas que representam os tópicos disponíveis no seu chatbot clássico.

4. Encontre o tópico que deseja chamar e procure sua propriedade nome. Quando o Copilot Studio habilidade recebe um evento com este nome, ele aciona o tópico.

   Neste exemplo, o nome da atividade do evento é dispatchTo_new_topic_87609dabd86049f7bc6507c6f7263aba_33d.

Ligue para Copilot Studio habilidade tópico

Em vez de confiar no que um usuário diz para Gatilho a Copilot Studio habilidade tópico, você pode chamá-lo diretamente. Você só pode chamar diretamente Copilot Studio tópicos listados no manifesto habilidade.

1. Na tela de criação do Composer, selecione Adicionar, depois Acessar recursos externos e então Conectar-se a uma habilidade.

2. Na lista habilidade Nome do diálogo , Select seu chatbot clássico.

3. Encontre o nome da atividade do evento para o chatbot clássico tópico que você deseja chamar. Copie o valor, omitindo as aspas, e salve-o para usar nas próximas etapas.

4. Selecione Fechar.

5. Na seção Atividade, selecione Mostrar código.

6. Digite ou cole o código a seguir. Substitua TOPIC_ACTIVITY_NAME pelo o nome da atividade de evento do seu tópico. Certifique-se de que não há aspas na propriedade nome.

   [Activity
       type = event
       name = TOPIC_ACTIVITY_NAME
   ]
   

Passe uma variável de entrada para a Copilot Studio habilidade tópico

Bot Framework O compositor pode passar uma variável para a Copilot Studio habilidade tópico como uma entrada. Para aprender a criar Copilot Studio tópicos que aceitam variáveis de entrada, consulte Trabalhar com variáveis.

Se um Copilot Studio tópico que pode receber uma variável de entrada estiver listado no seu manifesto habilidade, você pode passar uma variável do Composer para ele.

1. Na tela de criação do Composer, selecione Adicionar, depois Acessar recursos externos e então Conectar-se a uma habilidade.

2. Na lista habilidade Nome do diálogo , Select seu chatbot clássico.

3. Encontre o nome da atividade do evento para o chatbot clássico tópico que você deseja chamar. Copie o valor, omitindo as aspas, e salve-o para usar nas próximas etapas.

4. Encontre a propriedade valor do tópico. A propriedade valor contém uma propriedade $ref. Copie esse valor e salve-o para usar na próxima etapa.

   Aviso

   Se um Copilot Studio tópico não tiver entradas, ele não terá uma propriedade value .

5. Encontre a propriedade definições e, em seguida, procure uma propriedade aninhada que corresponda ao valor $ref encontrado na etapa anterior. Observe os nomes e tipos de entradas do Copilot Studio tópico. Você os usará nas próximas etapas.

6. Selecione Fechar.

7. Na seção Atividade, selecione Mostrar código.

8. Digite ou cole o código a seguir. Substitua estes valores:

   1. Substitua TOPIC_ACTIVITY_NAME pelo o nome da atividade de evento do seu tópico.
   2. Substitua PVA_INPUT_VARIABLE por uma variável de entrada do seu tópico.
   3. Substitua COMPOSER_INPUT_VARIABLE por uma variável do Composer que fornecerá um valor.

   [Activity
       Type = event
       Name = TOPIC_ACTIVITY_NAME
       Value = ${addProperty(json("{}"), 'PVA_INPUT_VARIABLE', COMPOSER_INPUT_VARIABLE)}
   ]
   

   Neste exemplo, a variável Composer dialog.storeLocation fornece um valor para a variável de entrada pva_StoreLocation no chatbot clássico tópico dispatchTo_new_topic_127cdcdbbb4a480ea113c5101f309089_21a34f16.

Receba uma variável de saída de a Copilot Studio habilidade tópico

É possível receber saídas de um Copilot Studio habilidade tópico no Composer. Para aprender a criar Copilot Studio tópicos que retornam saídas, consulte Trabalhar com variáveis.

1. Na tela de criação do Composer, selecione Adicionar, depois Acessar recursos externos e então Conectar-se a uma habilidade.

2. Na lista habilidade Nome do diálogo , Select seu chatbot clássico.

3. Encontre o nome da atividade do evento para o seu chatbot clássico tópico que você deseja chamar. Copie o valor, omitindo as aspas, e salve-o para usar nas próximas etapas.

4. Encontre a propriedade resultValue do tópico. A propriedade resultValue contém uma propriedade $ref. Copie esse valor e salve-o para usar na próxima etapa.

   Aviso

   Se um Copilot Studio tópico não tiver saídas, ele não terá uma propriedade resultValue .

5. Encontre a propriedade definições e, em seguida, procure uma propriedade aninhada que corresponda ao valor $ref encontrado na etapa anterior. Observe os nomes e tipos das variáveis de saída do Copilot Studio tópico. Você os usará nas próximas etapas.

   Neste exemplo, o Copilot Studio tópico retorna duas saídas do tipo String, pva_State e pva_Item.

6. Selecione Fechar.

7. Na seção Atividade, selecione Mostrar código.

8. Digite ou cole o código a seguir. Substitua TOPIC_ACTIVITY_NAME pelo o nome da atividade de evento do seu tópico. Certifique-se de que não há aspas na propriedade nome.

   [Activity
       type = event
       name = TOPIC_ACTIVITY_NAME
   ]
   

9. Na área de código, defina Propriedade como uma variável do Composer para receber e armazenar os valores de saída de Copilot Studio habilidade tópico.

10. Na tela de criação do Composer, selecione Adicionar, em seguida, selecione Gerenciar propriedades e, em seguida, selecione Definir propriedades.

11. Defina Propriedade como o valor do Composer que deve armazenar o valor extraído. Em seguida, defina Valor como a variável Composer na qual você armazenou as saídas do tópico.

    Neste exemplo, os valores de saída de dialog.skillResult.pvaState e dialog.skillResult.pvaItem são extraídos em novas variáveis do Composer dialog.State e dialog.Item.

Teste seu chatbot clássico como um habilidade com um Bot Framework bot

Use o Bot Framework Emulador para testar se seu Bot Framework bot está chamando corretamente um chatbot clássico como um habilidade.

Saiba mais

• Visão geral de habilidades
• Manifesto de habilidades
• Documentação do Bot Framework Composer
• Habilidades no Composer
• Conectar-se a uma habilidade remota no Composer
• Teste uma habilidade no Emulator