Conhecimento do agente no Copilot Studio: SharePoint, Dataverse e o que dá errado

Um agente de políticas internas de uma rede de varejo com 4.000 funcionários respondia certo sobre férias, banco de horas e benefícios. Sobre reembolso de despesas, respondia com os valores da política de 2021. A política vigente era de 2025 e estava na mesma biblioteca do SharePoint. O que aconteceu: a versão de 2021 continuava em uma pasta chamada "Antigas", dentro do site cadastrado como fonte, e o nome do arquivo não dizia o ano. Para a busca, eram dois documentos igualmente válidos. O modelo escolheu o que respondia melhor à pergunta.

Esse é o erro típico do Copilot Studio: ele raramente inventa um número, e com frequência pega o número certo do lugar errado. Este post mostra como a resposta generativa é montada, o que cada fonte de conhecimento respeita e custa, e um roteiro de diagnóstico para quando a resposta sai errada.

Como a resposta generativa é montada

Todo agente novo no Copilot Studio nasce com orquestração generativa. Quando chega uma pergunta, o orquestrador decide entre acionar um tópico, chamar uma ferramenta ou buscar nas fontes de conhecimento. Para escolher a fonte, ele lê a descrição que você escreveu para cada uma; acima de 25 fontes, um modelo interno filtra quais consultar. A busca roda em cada fonte do jeito dela: SharePoint pelo índice de busca do próprio SharePoint, Dataverse pelo Dataverse search, arquivos enviados pelo índice vetorial guardado no Dataverse, sites públicos pelo Bing. Os trechos encontrados vão para o modelo junto com as instruções do agente, e a resposta volta com as citações.

Duas configurações de IA generativa definem o que acontece quando a busca volta vazia. Com a opção de respostas sem fundamento ("Allow ungrounded responses") desligada, o agente bloqueia qualquer resposta em que não usou fonte nem ferramenta e dispara o tópico de fallback; uma resposta vinda de fonte só é entregue se tiver citação no texto. A moderação de conteúdo vem em "Alta" por padrão e pode ser ajustada por agente ou por nó. Na orquestração clássica, o mesmo trabalho é feito pelo tópico de sistema "Conversational boosting", com um nó de respostas generativas e limites menores: quatro URLs de SharePoint e quatro sites, por exemplo.

A permissão é aplicada na etapa de busca. Agentes criados no Copilot Studio e no Teams vêm com "Autenticar com a Microsoft"; com isso, a consulta ao SharePoint, ao Dataverse e aos Copilot connectors (antes Graph connectors) é feita em nome de quem pergunta, e só volta o que aquela pessoa pode abrir. Se não pode, a resposta é a mesma de quando o conteúdo não existe. Com autenticação manual, você registra um app no Entra com os escopos Sites.Read.All e Files.Read.All; com "Sem autenticação", o agente não lê SharePoint.

As fontes lado a lado

O diálogo de adicionar conhecimento tem duas opções chamadas SharePoint, e a diferença importa. A da seção principal conecta ao site e consulta o índice do SharePoint em tempo real, sem copiar nada, com filtros por autor e data de modificação e suporte a rótulos de sensibilidade. A da seção de upload copia arquivos e pastas para o Dataverse, indexa como vetores, sincroniza a cada quatro a seis horas e dá citação por página em PDF. Nos projetos, a primeira fica com bibliotecas grandes e conteúdo que muda todo dia; a segunda, com um conjunto fechado de documentos em que a busca semântica compensa o atraso.

Por que a resposta sai errada

Em diagnósticos de agentes já publicados, as causas se repetem:

• Documento em três versões. O caso do reembolso. A busca não sabe qual é a vigente; o modelo escolhe o trecho que melhor combina com a pergunta.
• PDF escaneado sem camada de texto. O indexador lê texto. Em um PDF que é só imagem, não há o que ler, e o agente responde que não encontrou ou busca em outro documento. No upload, imagem só conta quando está dentro de um PDF e tem texto alternativo.
• Tabela em imagem. A tabela de valores colada como figura no Word some da busca. O texto em volta aparece; o número, não.
• Política antiga sem arquivar. Pasta "Antigas" dentro do site cadastrado é fonte válida. Arquive em uma biblioteca fora do escopo do agente.
• Fonte ampla demais. Cadastrar o endereço raiz de um site inclui todos os subcaminhos, com rascunhos e projetos encerrados. Aponte a biblioteca.
• Instrução sem escopo. Sem dizer o que recusar e o que fazer quando não encontra, o modelo completa com conhecimento geral, ainda mais com respostas sem fundamento ligadas.
• Arquivo que o indexador não abre. Rótulo de sensibilidade que criptografa, senha, página clássica ou página moderna com componente SPFx: aparecem como prontos e devolvem nada. Perguntas pelo nome do arquivo também ficam sem resposta.

Instruções que reduzem alucinação

As instruções do agente vão para o modelo junto com os trechos encontrados. Elas definem escopo, recusa, formato e o que fazer com documentos concorrentes. O bloco abaixo é o que usamos como ponto de partida em agentes de políticas; cada linha corresponde a um erro que já vimos em produção.

Você é o agente de políticas internas da empresa.
Responda apenas com base nas fontes de conhecimento conectadas.
Se não encontrar a resposta nas fontes, diga que não encontrou
e ofereça abrir um chamado para o RH. Não complete com
conhecimento geral.
Inclua a citação do documento de origem em cada afirmação.
Quando houver mais de um documento sobre o mesmo tema, use o de
data de vigência mais recente e informe essa data na resposta.
Não responda sobre casos individuais (salário, avaliação ou
afastamento de uma pessoa). Oriente a falar com o RH.
Responda em português do Brasil, em até seis frases, com o valor
ou o prazo na primeira frase.

Duas regras que vêm da própria documentação. Peça citação em toda afirmação: com respostas sem fundamento desligadas, uma resposta correta sem marca de citação é retida, e o pedido explícito torna a citação mais consistente. E evite formatos rígidos de saída, como "responda só em JSON" ou "não inclua referências", porque eles suprimem as marcas de citação e o agente passa a dizer que não encontrou nada.

Diagnóstico em cinco passos

O conjunto fixo de perguntas é a peça que mais falta nos agentes que chegam para a gente. São 30 a 50 perguntas reais, cada uma com a resposta esperada e o documento esperado como citação. Toda mudança de fonte ou de instrução roda o conjunto inteiro no painel de teste antes de publicar. Depois de publicado, o painel de análise do Copilot Studio mostra a taxa de respostas geradas e a qualidade por fonte de conhecimento, o que indica qual fonte revisar primeiro.

No agente da rede de varejo, a correção levou uma tarde: a pasta "Antigas" foi movida para uma biblioteca de arquivo fora do escopo, a fonte passou do site para a biblioteca de políticas vigentes, e as instruções ganharam a regra de data de vigência. As 40 perguntas do conjunto de teste voltaram a passar, e a de reembolso passou a citar a política de 2025 com a data na primeira frase.

O próximo passo prático é inventariar as fontes do seu agente e, para cada uma, responder: quem pode abrir, quantas versões existem e quando foi atualizada. Se o agente ainda vai nascer, comece por primeiro agente em Copilot Studio, que organiza as fontes antes de criar o agente. Antes de apontar o agente para o SharePoint da empresa, leia o que o Copilot vê na sua empresa: a permissão protege, mas só o que já estava protegido. Para dados que moram fora do Microsoft 365, Copilot connectors e grounding mostra como trazê-los com permissão respeitada.