O Microsoft Copilot Studio permite estender seu Copilot com lógica personalizada. Dois blocos de construção principais existem: Tópicos e Plugins. Muitos criadores confundem seus papéis e escolhem o errado para uma tarefa. Tópicos lidam com fluxos conversacionais com lógica de ramificação. Plugins conectam sistemas externos ou executam ações únicas. Este artigo explica a diferença entre Tópicos e Plugins e fornece regras claras sobre quando usar cada um.
Principais Conclusões: Tópicos vs Plugins no Copilot Studio
- Tópicos no Copilot Studio > Topics: Use para conversas de múltiplas etapas, perguntas e respostas e fluxos de solução de problemas guiados.
- Plugins no Copilot Studio > Plugins: Use para ações únicas, como chamadas de API, consultas a bancos de dados ou envio de e-mails.
- Abordagem combinada: Um Tópico chama um Plugin quando o usuário precisa de dados de um sistema externo durante uma conversa.
O Que São Tópicos e Plugins no Copilot Studio?
O Copilot Studio oferece dois mecanismos distintos para construir comportamentos personalizados do Copilot. Tópicos e Plugins servem a propósitos diferentes e têm restrições de design diferentes. Entender cada um é essencial antes de decidir qual construir.
Tópicos: Fluxos Conversacionais
Tópicos são a principal forma de definir um caminho de conversa. Um Tópico contém frases de gatilho, condições e mensagens de saída. Quando um usuário digita uma frase que corresponde a um gatilho de Tópico, o Copilot entra nesse Tópico. O Tópico pode fazer perguntas de acompanhamento, ramificar com base nas respostas do usuário e apresentar cartões adaptáveis ou formulários. Tópicos suportam variáveis, loops e nós de lógica. Eles são ideais para cenários onde o usuário precisa fornecer múltiplas informações ou onde o fluxo muda com base no contexto.
Plugins: Conectores de Ação
Plugins são conectores de propósito único que executam uma ação ou recuperam dados de uma fonte externa. Um Plugin pode chamar uma API REST, executar um fluxo do Power Automate, consultar um banco de dados ou executar um conector. Plugins não gerenciam estado de conversa ou ramificação. Eles recebem entrada, executam uma ação e retornam um resultado para o Copilot. Plugins são stateless. Eles não lembram de turnos anteriores. Eles são a ferramenta certa quando você precisa integrar com um serviço de terceiros ou executar uma tarefa discreta.
Quando Usar um Tópico vs um Plugin
A decisão depende da experiência do usuário que você deseja criar. Use um Tópico quando a interação exigir mais de uma troca. Use um Plugin quando a interação for uma única solicitação-resposta.
Casos de Uso para Tópicos
Tópicos são melhores para cenários que envolvem múltiplas etapas ou lógica condicional. Por exemplo, um Tópico de help desk que pergunta ao usuário para descrever seu problema, depois pergunta seu departamento e então o encaminha para a fila de suporte correta. Outro exemplo é um Tópico de solicitação de férias que pergunta as datas, aprovação do gerente e então submete a solicitação. Tópicos também podem lidar com recuperação de erros pedindo ao usuário para reformular ou fornecer informações faltantes.
Casos de Uso para Plugins
Plugins são melhores para tarefas de ação única. Por exemplo, um Plugin que verifica o clima para uma cidade específica. O usuário diz “Qual é o clima em Londres?” O Plugin chama uma API de clima e retorna o resultado. Outro exemplo é um Plugin que consulta um registro de cliente por ID e retorna o nome e status do cliente. Plugins não fazem perguntas de acompanhamento. Se o usuário não fornecer a entrada necessária, o Plugin falha ou retorna um erro.
Passos para Criar um Tópico no Copilot Studio
Criar um Tópico requer definir frases de gatilho e construir o fluxo da conversa.
- Abra o Copilot Studio e selecione seu Copilot
Vá para o Copilot Studio e abra o Copilot que deseja editar. Clique na guia Topics na navegação à esquerda. - Crie um novo Tópico
Clique no botão Add a topic e selecione From blank. Nomeie o Tópico com algo descritivo como “Perguntas de Integração de Funcionários”. - Adicione frases de gatilho
Na seção Trigger, digite frases que um usuário pode dizer para iniciar este Tópico. Por exemplo: “Preciso de ajuda com integração”, “guia do novo funcionário”, “primeiro dia no trabalho”. Adicione pelo menos 10 frases para correspondência confiável. - Construa o fluxo da conversa
Arraste nós para a tela. Use nós Question para pedir entrada. Use nós Condition para ramificar com base nas respostas do usuário. Use nós Message para exibir respostas. Teste o fluxo usando o painel Test à direita. - Salve e publique
Clique em Save no topo, depois clique em Publish para disponibilizar o Tópico para os usuários.
Passos para Criar um Plugin no Copilot Studio
Plugins são criados na guia Plugins. Você os conecta a um serviço externo por meio de um conector ou uma API personalizada.
- Abra a guia Plugins
No Copilot Studio, clique na guia Plugins na navegação à esquerda. Clique em Add a plugin. - Escolha um tipo de conector
Selecione da lista de conectores pré-construídos como Microsoft Dataverse, SharePoint ou Outlook. Ou selecione Custom connector para conectar à sua própria API. - Configure a ação
Defina os parâmetros de entrada que o Plugin espera. Para um Plugin de clima, a entrada é o nome da cidade. Defina a saída que o Plugin retorna, como temperatura e condições. - Teste o Plugin
Use o painel Test para enviar uma solicitação de exemplo. Verifique se o Plugin retorna os dados corretos. - Salve e habilite o Plugin
Clique em Save. O Plugin agora está disponível para ser chamado por Tópicos. Você não precisa publicar Plugins separadamente; eles são habilitados quando você publica o Copilot.
Erros Comuns e Equívocos
Criadores frequentemente usam Tópicos e Plugins de forma incorreta. Os erros mais frequentes envolvem colocar lógica demais em um Plugin ou tratar um Tópico como uma consulta simples.
Construir um Fluxo de Múltiplas Etapas Dentro de um Plugin
Um Plugin deve executar uma ação. Se você se pegar adicionando lógica condicional ou múltiplas chamadas de API dentro de um único Plugin, deve dividir isso em um Tópico que chama vários Plugins. Um Plugin que tenta lidar com três cenários diferentes se torna difícil de depurar e reutilizar.
Usar um Tópico Quando um Plugin Seria Suficiente
Se o usuário faz uma única pergunta e o Copilot retorna uma única resposta, um Plugin é a escolha certa. Construir um Tópico para uma consulta simples adiciona complexidade desnecessária. O Tópico requer frases de gatilho, nós de condição e mensagens de saída. Um Plugin lida com a mesma tarefa com menos manutenção.
Esquecer de Chamar o Plugin a Partir do Tópico
Um Plugin não faz nada sozinho. Ele só é executado quando um Tópico o chama. Se você criar um Plugin, mas não adicionar um nó Call an action em um Tópico, o Plugin permanece não utilizado. Sempre verifique se seu Tópico inclui um nó que chama o Plugin e manipula os dados retornados.
Tópicos vs Plugins: Principais Diferenças
| Item | Tópico | Plugin |
|---|---|---|
| Propósito | Fluxo conversacional de múltiplas etapas | Ação única ou recuperação de dados |
| Gerenciamento de estado | Mantém estado da conversa entre turnos | Stateless; sem memória de turnos anteriores |
| Método de gatilho | Frases do usuário correspondendo a frases de gatilho | Chamado por um nó de Tópico ou por detecção de intenção do usuário |
| Complexidade | Suporta ramificações, loops, variáveis | Apenas lógica simples de entrada-saída |
| Integração externa | Pode chamar Plugins, mas não se conecta diretamente a APIs | Conecta-se diretamente a APIs, bancos de dados e conectores |
| Exemplo | Criação de ticket de suporte de TI com validação e roteamento | Verificar se um usuário está em um grupo do Active Directory |
Combinando Tópicos e Plugins para Cenários Complexos
As experiências mais poderosas do Copilot combinam Tópicos e Plugins. Um Tópico gerencia o fluxo da conversa enquanto Plugins fornecem dados de sistemas externos. Por exemplo, um Tópico de relatório de despesas pergunta ao usuário o valor, a categoria e o recibo. Em seguida, chama um Plugin que submete a despesa a um sistema contábil. Outro exemplo é um Tópico de suporte ao cliente que pergunta a descrição do problema, depois chama um Plugin para consultar a conta do cliente e outro Plugin para verificar tickets abertos. Esse padrão mantém a lógica da conversa no Tópico e o acesso aos dados nos Plugins.
Agora você pode decidir se um Tópico ou um Plugin se adequa ao seu próximo projeto no Copilot Studio. Comece anotando a interação do usuário. Se o usuário precisar fornecer múltiplas entradas ou ver perguntas de acompanhamento, use um Tópico. Se o usuário fizer uma única pergunta e receber uma única resposta, use um Plugin. Para cenários avançados, construa um Tópico que chame um ou mais Plugins. Teste cada componente separadamente antes de combiná-los.