Como criar um assistente de pesquisa documental no Microsoft Copilot
Este tutorial mostra como criar um assistente de pesquisa documental no Microsoft Copilot que procura em ficheiros internos, responde a perguntas em linguagem natural e devolve citações e ligações de referência — útil para equipas que precisam de respostas rápidas e verificáveis sem procurar manualmente pelos ficheiros.
Pré-requisitos
- Conta Microsoft com permissões para Microsoft Copilot e Copilot Studio
- Conjunto de documentos armazenados acessíveis (OneDrive, SharePoint, ou fonte suportada)
- Conhecimentos básicos de prompt engineering e de fluxo lógico
- Navegador moderno e acesso a chaves de API ou integrações, se necessário
Passo 1: Definir o objetivo e o âmbito da pesquisa documental
Antes de configurar, descreve claramente o que o assistente deve responder: tipos de documentos (políticas, manuais, contratos), formato da resposta (resumo + citações) e limites de confidencialidade. Isto evita respostas vagas e ajuda a criar prompts precisos.
Passo 2: Preparar e indexar os documentos
Organiza os ficheiros numa localização suportada (ex.: SharePoint). Se necessário, converte PDFs em texto e assegura metadados úteis (data, autor, título). Em Copilot Studio ou na integração que uses, cria uma fonte de dados que indexe esses ficheiros para pesquisa semântica.
Passo 3: Criar um agente no Copilot Studio
No Copilot Studio, cria um novo agente e liga a fonte de dados que contém os documentos. Define as capacidades do agente: pesquisa semântica, extração de citações e limitações de segurança.
// Exemplo conceptual de ligação (pseudocódigo de configuração)
agentConfig = {
name: "AssistentePesquisaDocumental",
dataSources: ["SharePoint:DocsEquipe"],
features: ["semanticSearch", "sourceAttribution"],
maxContextTokens: 1500
}
createAgent(agentConfig)
Passo 4: Escrever prompts e modelos de resposta
Cria um prompt principal que instrua o modelo a procurar, resumir e citar fontes. Inclui instruções para formatar a resposta: breve resumo, pontos-chave e lista de referências com títulos e ligações.
System: "És um assistente de pesquisa documental. Procura nas fontes fornecidas e responde em 3 secções: 1) Resumo curto (2-3 linhas). 2) Pormenores relevantes (bullet points). 3) Referências (título, autor, ano, ligação). Se não encontrares informação, indica isso e sugere termos de pesquisa alternativos."
User (template): "Pergunta: {user_question}\nLimite de fontes: 3\nFormato: resumo + bullets + referências"
Passo 5: Configurar a extração de citações e a verificação de fontes
Activa a funcionalidade de atribuição de origem (source attribution) no agente para que cada afirmação importante inclua uma referência. Define um limite de confiança: se a resposta for gerada sem evidência suficiente, o agente deve indicar incerteza.
Passo 6: Testar com exemplos reais e ajustar prompts
Testa o agente com perguntas típicas e analisa as respostas: precisão, utilidade das citações e concisão. Ajusta o prompt para reduzir hallucinations e para forçar a inclusão de excertos citados quando necessário.
// Exemplos de teste
Pergunta: "Quais os passos para solicitar licença parental segundo a política interna?"
Pergunta: "Onde está o procedimento de escalonamento para incidentes de segurança?"
Passo 7: Integrar o assistente no fluxo de trabalho
Decide como os utilizadores acedem ao assistente: chat no Teams, widget no SharePoint, ou interface web. Configura permissões para garantir que apenas utilizadores autorizados veem documentos sensíveis.
Verificar o resultado
Faz perguntas de validação e confirma que as respostas incluem: um resumo correto, bullets com factos relevantes, e referências com títulos e ligações. Verifica amostras onde a resposta deveria dizer "sem evidência" — isso indica que o mecanismo de verificação está a funcionar.
Conclusão
Depois de validar, implementa o assistente para um grupo piloto e recolhe feedback para melhorar prompts, relevância da pesquisa e segurança. Passo seguinte: automatizar a actualização do índice de documentos e adicionar controlos de versão. Dica: começa com regras simples de atribuição de fontes e só depois adiciona lógica mais complexa para reconciliar respostas contraditórias.