Copilot Studio Generative Answers: respostas com fontes e fluxo controlado

ANÁLISE EDITORIAL

A Skill Add Generative Answers, mantida no repositório oficial microsoft/skills-for-copilot-studio, ensina um agente de programação a montar trechos YAML de tópicos do Microsoft Copilot Studio para pesquisar fontes e gerar respostas. Ela não é um conector pronto, não cria uma base de conhecimento sozinha e não garante que uma resposta esteja correta. O valor está em organizar decisões que costumam ficar misturadas: como reescrever a pergunta, onde pesquisar, se o modelo pode recorrer ao conhecimento geral e se o texto deve ser enviado automaticamente ou processado antes.

Esta análise fixa a origem no commit 920f419696221b7960b88024982aa6bca4575cf6, consultado em 26 de agosto de 2026. Naquela consulta, o repositório completo tinha 418 estrelas no GitHub. Esse número descreve o repositório, não prova adoção desta Skill específica. A licença MIT foi conferida no arquivo raiz. O pacote local oferecido pelo Bastidores da IA é documental e contém somente os cinco arquivos de texto permitidos.

Ilustração editorial exclusiva do Bastidores da IA. A capa desta página não é captura de tela, interface real, logotipo da Microsoft, resposta executada nem prova de acesso ao Copilot Studio.

O que esta Skill faz de verdade

O SKILL.md auditado funciona como um guia de autoria. Ele orienta o agente a escolher e combinar quatro tipos de nó: CreateSearchQuery, SearchAndSummarizeContent, SearchKnowledgeSources e AnswerQuestionWithAI. A sequência mais importante começa com a criação de uma consulta contextual, porque usar somente a frase mais recente do usuário pode perder informações de mensagens anteriores.

Depois da consulta, há duas famílias de fluxo. A primeira procura e responde em uma mesma etapa, com SearchAndSummarizeContent. A segunda separa recuperação e síntese: SearchKnowledgeSources busca resultados estruturados, e AnswerQuestionWithAI redige a resposta usando esses resultados. Separar as etapas é útil quando o autor precisa inspecionar, filtrar, registrar ou enriquecer os resultados antes da mensagem final.

A Skill também manda ler settings.mcs.yml para descobrir se ações generativas estão habilitadas. Esse detalhe muda o lugar em que uma ação de recuperação deve ser criada. Portanto, ela não deve ser tratada como um bloco universal para colar em qualquer agente.

Para quem serve

Ela serve principalmente a quem mantém tópicos em código para agentes do Copilot Studio e precisa construir respostas fundamentadas em fontes de conhecimento. O público natural inclui desenvolvedores, arquitetos de automação, equipes de suporte e responsáveis por governança que revisam mudanças em repositório antes de importá-las para um ambiente do Microsoft 365.

Também é útil como checklist para quem já trabalha no editor visual, mas quer entender quais escolhas existem por baixo de um nó de resposta generativa. Ela ajuda a formular perguntas de revisão: a busca está ampla demais, o conhecimento geral está habilitado, a saída será enviada sem uma etapa humana e as fontes preservam as permissões esperadas?

Não é uma introdução completa ao Copilot Studio. Quem ainda não configurou agente, ambiente, autenticação ou fonte de conhecimento deve começar pela visão oficial de fontes de conhecimento no Copilot Studio.

Compatibilidade e pré-requisitos

O repositório documenta instalação como plugin para Claude Code e GitHub Copilot CLI. Para o uso funcional, é necessário carregar o repositório completo, porque a Skill declara dependência do agente copilot-studio-author e do utilitário scripts/schema-lookup.bundle.js. O ZIP do Bastidores da IA não inclui esses componentes e, por isso, não substitui a instalação oficial.

Antes de usar, tenha uma cópia versionada do agente ou trabalhe em uma ramificação descartável. Identifique o arquivo settings.mcs.yml, a pasta do agente e as fontes de conhecimento permitidas. Confirme também qual cliente realmente interpreta os campos de frontmatter usados pelo projeto, como agente associado, contexto separado e ferramentas permitidas. Um cliente capaz apenas de ler Markdown pode aproveitar as orientações, mas não necessariamente executar todo o fluxo.

No lado do produto, a disponibilidade de uma fonte depende do ambiente, da autenticação e da configuração do agente. A documentação oficial explica que fontes corporativas, como SharePoint, devem respeitar o acesso do usuário. Isso é uma proteção importante, mas não dispensa o teste com contas de permissões diferentes.

Instalação recomendada

O caminho documentado no README fixado no commit auditado registra o marketplace e instala o plugin:

/plugin marketplace add microsoft/skills-for-copilot-studio
/plugin install copilot-studio@skills-for-copilot-studio

Faça isso primeiro em um projeto de teste. Depois, confira os arquivos adicionados, a origem remota e o commit efetivamente recebido. A instalação pode expor outras Skills e ferramentas do mesmo repositório, então a revisão não deve se limitar à pasta add-generative-answers.

Se a política da equipe não permite plugins, clone o repositório oficial em uma pasta de análise e consulte os arquivos sem habilitar execução automática. O pacote local desta página é apropriado para auditoria documental, comparação futura e validação de checksum. Ele não contém instalador, dependências, binários, credenciais ou o utilitário de schema.

Configuração antes do primeiro uso

Comece por quatro decisões explícitas. Primeiro, defina se a busca pode percorrer todas as fontes configuradas ou apenas uma lista aprovada. Segundo, decida se o modelo pode complementar a resposta com conhecimento geral. Terceiro, escolha entre envio automático e processamento intermediário. Quarto, estabeleça qual identidade fará a consulta e quais documentos ela realmente pode ler.

Para uma resposta diretamente ligada a uma pergunta, a Skill recomenda criar a consulta com CreateSearchQuery antes do nó de busca. Esse passo usa o contexto da conversa para produzir uma consulta autocontida. Ao limitar fontes, use os nomes internos corretos e confirme no schema atual se o valor deve incluir ou omitir a extensão .mcs.yml.

Se a equipe conecta uma fonte própria, leia a orientação de fontes de conhecimento personalizadas. O guia deixa claro que recuperação, autenticação e resposta precisam ser desenhadas em conjunto. Para SharePoint, consulte também a página específica sobre adicionar SharePoint como conhecimento.

Primeiro uso seguro

1. Duplique um agente não produtivo e trabalhe em uma ramificação exclusiva.
2. Escolha uma fonte pequena, não sensível e com documentos cujo conteúdo você conhece.
3. Peça ao agente de programação para mostrar o plano e o diff antes de gravar qualquer YAML.
4. Confirme a existência de CreateSearchQuery antes do nó de busca quando houver contexto conversacional.
5. Valide os nomes das propriedades com o utilitário de schema do repositório completo.
6. Teste uma pergunta direta, uma continuação que dependa da mensagem anterior, uma pergunta sem resposta e uma consulta a conteúdo restrito.
7. Se o envio automático estiver desligado, verifique qual etapa envia ou transforma a resposta.
8. Inspecione citações e referências antes de promover o tópico para outro ambiente.

O objetivo não é apenas obter uma resposta convincente. É comprovar que a resposta veio da fonte pretendida, que a ausência de evidência é tratada de forma legível e que um usuário não recebe material fora de seu escopo.

Resultado esperado

Ao final, o autor deve ter um diff YAML revisável com uma consulta contextual, um nó de recuperação compatível com a configuração atual e uma decisão clara sobre síntese e envio. Em um fluxo de duas etapas, os resultados da busca ficam disponíveis para validação antes de AnswerQuestionWithAI. Em um fluxo direto, SearchAndSummarizeContent reduz a quantidade de nós, mas também deixa menos espaço para tratamento intermediário.

Uma boa validação registra a pergunta, as fontes disponíveis, a identidade usada, o comportamento esperado quando nada é encontrado e o conteúdo final exibido. A orientação de RAG no Copilot Studio ajuda a separar qualidade de recuperação, qualidade de síntese e desenho de fallback.

Resultado esperado não significa resultado garantido. Documentos desatualizados, permissões inconsistentes, consulta ruim ou uma propriedade que mudou de versão podem produzir saída incompleta ou incorreta.

Permissões e riscos

A Skill é texto, mas seu uso real pode ler e gravar arquivos do agente, alterar tópicos, ampliar o conjunto de fontes consultadas e mudar o que é enviado ao usuário. Quando o conhecimento geral é permitido, a resposta pode trazer conteúdo não recuperado das fontes corporativas. Quando o envio automático está ativo, uma etapa de revisão ou filtragem pode ser pulada.

Fontes de conhecimento também são entrada não confiável. Um documento pode conter instruções maliciosas, informações antigas ou conteúdo escrito para induzir o modelo. Use fontes administradas, registre a procedência e teste respostas adversariais. Não confunda citação com veracidade: uma referência mostra de onde veio um trecho, mas não prova que o documento está correto.

Em ambientes corporativos, valide permissões com mais de um perfil. A descrição oficial de conhecimento enfatiza as fontes suportadas e o uso da identidade do usuário, porém uma configuração ampla pode expor metadados ou respostas inesperadas. Mantenha promoção, publicação e alterações de autenticação sob aprovação separada.

Erros comuns

Usar somente a última frase do usuário

Enviar System.Activity.Text diretamente à busca pode perder o contexto de uma pergunta de continuação. Crie a consulta contextual primeiro.

Criar um tópico dedicado sem necessidade

Quando a busca é apenas uma etapa de um fluxo maior, o nó pode permanecer no tópico existente. Criar tópicos intermediários aumenta navegação e manutenção sem benefício automático.

Confundir nomes de fonte e arquivos

O nome usado na propriedade de fontes pode não aceitar a extensão .mcs.yml. Verifique o schema e os nomes internos do projeto em vez de adivinhar.

Desligar o envio automático sem enviar a resposta depois

Com autoSend desativado, a saída precisa ser processada e enviada por outro nó. Sem essa etapa, o usuário pode não ver resultado algum.

Ignorar a configuração de ações generativas

O valor GenerativeActionsEnabled influencia onde a ação deve ser definida. Ler o arquivo de configuração é um bloqueio, não uma sugestão estética.

Copiar um exemplo com propriedade divergente

Na versão auditada, o quarto padrão de patterns.md passa Topic.SearchQuery a SearchKnowledgeSources, enquanto o SKILL.md e a referência de propriedades recomendam usar o campo SearchQuery do resultado criado por CreateSearchQuery. Trate isso como divergência documental. Consulte o schema atual e revise o diff antes de aceitar o exemplo.

Remover citações para simplificar a interface

Ocultar referências pode reduzir a capacidade de revisar e contestar a resposta. Se a experiência exigir outro formato, preserve a rastreabilidade em uma etapa acessível.

Versão auditada e download local

Origem: microsoft/skills-for-copilot-studio, pasta add-generative-answers. Commit: 920f419696221b7960b88024982aa6bca4575cf6. Licença: MIT. Consulta de popularidade: 418 estrelas no repositório completo em 26 de agosto de 2026.

O ZIP local contém SKILL.md, patterns.md, property-reference.md, LICENSE e ORIGEM.md. Não contém scripts, o agente auxiliar, o utilitário de schema, dependências, binários, tópicos de usuário, segredos ou credenciais. SHA-256: b7d39df2e7ccb21a8db72a63263cb0c9a1478f740f3d82608a56fbeb1c5ff706.

Use o card de download desta página para conferir o pacote documental. O botão do repositório oficial é uma ação separada e deve ser usado para instalar ou consultar a versão completa. Para entender o padrão geral antes de adotar uma Skill, veja o guia de Skills para Claude, Codex e Gemini.

Resultado esperado e limite final

Esta Skill pode tornar a autoria de respostas generativas mais disciplinada porque obriga o fluxo a explicitar consulta, fontes, conhecimento geral e envio. O limite é igualmente importante: o material auditado ensina a escrever YAML, mas não demonstra que um agente específico foi executado, não confirma acesso a um tenant e não substitui testes no ambiente de destino.

Como o schema e a documentação do produto evoluem, mantenha o commit registrado, compare a versão instalada e rode a validação do repositório completo antes de importar mudanças. Se o exemplo divergir da referência, pare e confirme a propriedade atual. A curadoria aqui preserva o que foi lido e licenciado, sem transformar documentação em promessa de compatibilidade futura.

Fontes primárias

• Repositório oficial microsoft/skills-for-copilot-studio
• Commit auditado
• SKILL.md fixado
• Padrões oficiais da Skill
• Referência de propriedades
• Licença MIT do repositório
• README e instalação oficial
• Visão geral de fontes de conhecimento
• Fontes de conhecimento personalizadas
• Orientação de recuperação aumentada por geração
• SharePoint como fonte de conhecimento
• Nó de respostas generativas