Partilhar via

Visão geral do Bot Framework Composer

  • Artigo

Importante

As capacidades e os recursos do Power Virtual Agents agora fazem parte do Microsoft Copilot Studio após investimentos significativos em IA generativa e integrações aprimoradas no Microsoft Copilot.

Alguns artigos e capturas de tela podem fazer referência ao Power Virtual Agents enquanto atualizamos a documentação e o conteúdo do treinamento.

Observação

Agora o Microsoft Copilot Studio oferece suporte estes recursos sem o Composer.

Aprimore seu bot desenvolvendo tópicos personalizados com o Bot Framework Composer e, em seguida, adicione-os ao seu copiloto do Microsoft Copilot Studio.

O Composer está integrado ao Microsoft Copilot Studio para permitir que os desenvolvedores e os usuários de negócios criem bots juntos. O Composer permite estender o bot com a funcionalidade do Bot Framework, incluindo:

  • Caixas de diálogo adaptáveis
  • Geração de Linguagem (LG)
  • Expressões regulares (RegEx)
  • Cartões Adaptáveis

O uso do Composer com o Microsoft Copilot Studio permite acessar a memória e o contexto conversacionais, incluindo as variáveis definidas no Microsoft Copilot Studio. Essa memória e esse contexto permitem criar tópicos para lidar com interrupções, cancelamentos e alternância de contexto. Também é possível adicionar Cartões Adaptáveis para exibir elementos interativos, como imagens e vídeos, formulários e muito mais no bot.

Há várias funções e expressões predefinidas no Composer para você usar e a possibilidade de definir diversas variações de uma frase para o bot selecionar aleatoriamente em runtime.

Os tópicos personalizados adicionados com o Composer são implantados, hospedados e executados juntamente com o restante do conteúdo do copiloto do Microsoft Copilot Studio e não exigem hospedagem adicional do Azure.

Importante

A integração do Composer não está disponível para usuários que têm somente a licença do Teams do Microsoft Copilot Studio. É necessário ter uma licença de avaliação ou integral do Microsoft Copilot Studio.

Pré-requisitos

Entenda os principais termos do Composer

O Composer usa um conjunto diferente de termos para descrever conceitos semelhantes usados no Microsoft Copilot Studio. Estes são alguns dos principais termos a serem entendidos:

  • diálogo: Os diálogos são o bloco de construção básico no Composer e servem como contêineres para gatilhos. Cada caixa de diálogo representa uma parte da funcionalidade do bot que contém instruções sobre o que o bot faz e como reage à entrada do usuário. Para saber mais sobre diálogos, consulte Diálogos como blocos de construção de conversas no Composer.

  • caixa de diálogo principal: A caixa de diálogo principal de um bot é a primeira caixa de diálogo exibida no explorador de bots e é criada quando você importa o copiloto do Microsoft Copilot Studio para o Composer. A caixa de diálogo principal nunca deve ser excluída, pois corresponde ao seu copiloto do Microsoft Copilot Studio.

  • gatilho: Os gatilhos são o principal componente de um diálogo e permitem capturar e responder a eventos. Cada gatilho tem uma condição e uma coleção de ações a serem executadas quando a condição é atendida. Você pode pensar em gatilhos como o equivalente a tópicos no Microsoft Copilot Studio. Para aprender mais sobre os gatilhos, consulte Gatilhos.

  • ação: As ações são os principais componentes de um gatilho que permitem enviar uma resposta, criar e atribuir valores a propriedades, lidar com o fluxo da conversa, gerenciar diálogos e muitas outras atividades. Você pode pensar em ações como o equivalente a nós no Microsoft Copilot Studio.

Recursos do Composer não compatíveis com o Microsoft Copilot Studio

Os recursos a seguir do Composer não são compatíveis com o Microsoft Copilot Studio:

Recurso sem suporte Informações adicionais
Reconhecedor do LUIS (reconhecimento de linguagem) O reconhecedor padrão no Composer está definido como reconhecimento de linguagem natural (NLU) do Microsoft Copilot Studio.
Bot Framework Orchestrator Não há suporte ao Bot Framework Orchestrator no Composer para o Microsoft Copilot Studio.
Reconhecedor personalizado Não há suporte ao reconhecedor personalizado no Composer do Microsoft Copilot Studio.
Habilidades de bot Não é possível invocar habilidades de bot no conteúdo do Composer destinado ao Microsoft Copilot Studio.
QnA Maker Esse recurso não está disponível no Composer para o Microsoft Copilot Studio.
Logon do OAuth e saída dos usuários Não há suporte a esses tipos de ações no Composer para o Microsoft Copilot Studio.
Entradas e saídas de diálogo Não há suporte a entradas e saídas de diálogo no Composer para o Microsoft Copilot Studio.
Detecção de entidade em fases de gatilho no Composer Não é possível usar # getUserName my name is {username=userName} no Composer.
Testando no Bot Framework Emulator Todo o conteúdo do Composer deve ser publicado e testado no Microsoft Copilot Studio.

Diretrizes para criar conteúdo para o Microsoft Copilot Studio no Composer

Existem algumas diretrizes importantes a serem seguidas ao usar o Composer para criar seu conteúdo para o Microsoft Copilot Studio:

  • Os tópicos do seu bot do Microsoft Copilot Studio são exibidos no Composer como caixas de diálogos. Não é possível editar essas caixas de diálogos no Composer; selecioná-los abre os tópicos relevantes no Microsoft Copilot Studio para edição.

    Captura de tela da lista de tópicos no Composer que foram importados de um copiloto do Microsoft Copilot Studio.

  • As variáveis globais do Microsoft Copilot Studio são acessadas no Composer usando o escopo virtualagent. Esse escopo não aparece no menu de referência de propriedades do Composer, mas você pode acessá-lo inserindo uma expressão diretamente.

  • A publicação de conteúdo no Composer torna as mudanças disponíveis para teste, mas não publica automaticamente o seu copiloto do Microsoft Copilot Studio. Para publicar as alterações do copiloto em canais, use o recurso Publicar no Microsoft Copilot Studio.

  • Use uma ação de Iniciar um tópico do Microsoft Copilot Studio para chamar tópicos do Microsoft Copilot Studio no Composer.

    Captura de tela do menu Adicionar ação do Composer.

  • É possível adicionar novos gatilhos do Composer de qualquer tipo no diálogo principal (também conhecido como "raiz").

  • Você pode enviar mensagens e fazer perguntas a partir desses gatilhos do Composer.

  • Não é possível usar o Reconhecedor de expressão regular no diálogo principal. Usar o Reconhecedor de expressão regular na caixa de diálogo principal impedirá a publicação do conteúdo do Composer no Microsoft Copilot Studio. No entanto, é possível usar o Reconhecedor de expressão regular em outro diálogo do Composer.

  • É possível adicionar nenhum evento e gatilho do Composer a diálogos recém-criados.

  • Na página Respostas de Bot, a seção Comum deve estar vazia. O uso de qualquer ativo resulta em erros de validação e impede a publicação do conteúdo do Composer no Microsoft Copilot Studio.

    Captura de tela da seção comum de respostas de bot vazia.

  • Cada diálogo do Composer tem seus próprios recursos de resposta de bot (.lg) e reconhecimento de linguagem (.lu). Por exemplo, um bot que fala inglês (EUA) e tem uma caixa de diálogo nomeada dialog1 tem um arquivo dialog1.en-us.lg e um arquivo dialog1.en-us.lu.

  • A caixa de diálogo principal no Composer nunca deve ser excluída, pois corresponde ao copiloto do Microsoft Copilot Studio. O diálogo principal pode ter zero ou mais gatilhos.

  • Você pode capturar telemetria em diálogos e gatilhos do Composer e usar Application Insights para analisá-la com Consultas do Kusto para diálogos adaptativos. Para obter mais informações, consulte Capturar telemetria com o Application Insights.

Para aprofundar-se sobre diálogos, eventos e gatilhos do Composer e saber como criar conteúdo avançado de bot com o Bot Framework, consulte os seguintes recursos:

Referências

Para saber mais sobre como desenvolver no Composer, consulte estes recursos: