Skill oficial · IA na prática
Preparar documentos para busca com IA
Prepara documentos para um assistente de IA que faz buscas neles: inventário, responsáveis, cópias desatualizadas removidas, permissões, seções boas para chunks, metadados e perguntas de teste.
Funciona no Claude, no ChatGPT e em agentes de programação. Nos planos Team e Business, a skill oficial no seu pod se atualiza sozinha quando a melhoramos.
Quando usar
- Você vai carregar documentos em um chatbot, GPT personalizado ou projeto do Claude
- O assistente responde com documentos desatualizados ou errados
O que você passa para ela
- A lista de documentos com responsáveis e datas
- Para que serve o assistente
- Quem pode ver o quê
- Perguntas reais que as pessoas fazem
O que você recebe
Um inventário com ações de manter/tirar/corrigir, conflitos a resolver, uma lista de reorganização, campos de metadados e perguntas de teste com as fontes esperadas.
Como funciona
- Inventário Uma linha por documento: título, responsável (uma pessoa), última atualização, público e status (vigente, rascunho, arquivado). Documento sem responsável ganha um antes de entrar; se não ganhar, fica de fora.
- Remova duplicatas e versões desatualizadas Mantenha uma versão vigente por assunto. Tire os rascunhos, as cópias “v2-final-FINAL” e tudo o que não foi revisado em 12 meses, a não ser que o responsável confirme que continua valendo (limite padrão desta skill). Quando dois documentos vigentes se contradizem, não carregue nenhum dos dois até o responsável resolver.
- Verifique as permissões Agrupe os documentos por quem pode vê-los. Se a ferramenta não consegue filtrar por usuário, um documento restrito (faixas salariais, contratos, casos de RH, dados de clientes) fica totalmente fora de um assistente compartilhado. Nunca confie em dizer à IA “não revele isto”.
- Reorganize para os trechos Um assunto por seção, com um título que diga o assunto (“Reembolso em planos anuais”, e não “Outros”). Cada seção precisa fazer sentido sozinha: repita o nome do produto ou da política em vez de “ele” ou “conforme acima”. Transforme tabelas que ocupam várias páginas em uma tabela por assunto. Tire os fatos importantes de imagens e PDFs escaneados e passe para texto.
- Adicione metadados No topo de cada documento ou nos campos da ferramenta: título, responsável, data da última revisão, público, produto ou área e status. Com eles, as ferramentas de busca conseguem filtrar e a IA consegue citar a fonte.
- Escreva perguntas de teste com a fonte esperada De 10 a 20 perguntas, cada uma com o documento e a seção que devem respondê-la e a resposta correta em uma linha. Inclua de 2 a 3 perguntas que as fontes não devem responder (o assistente precisa dizer que não sabe).
- Rode os testes e corrija as fontes Faça cada pergunta e anote se a seção certa foi citada e se a resposta estava correta. Corrija as falhas primeiro nos documentos (título, fato que faltava, cópia contraditória) e rode de novo. Rode o conjunto inteiro outra vez sempre que documentos forem adicionados ou alterados.
Compartilhe com a sua equipe
Adicione a skill a um AI Skill Pod e todo mundo da equipe, prestadores de serviço incluídos, usa a mesma versão na própria IA. Veja as melhores formas de compartilhar skills de IA com uma equipe
Adicionar ao pod da minha equipe
Histórico de mudanças
- v1.0.1 · · Example: 10 test questions, 3 of them out of scope, with every question beyond the input's one marked [draft].
- v1.0.0 · · First release.
Fontes
- Chunk Documents - Azure AI Search | Microsoft Learn (lida em 2026-11-04)
- Contextual retrieval in AI systems | Anthropic (lida em 2026-11-04)
- Evaluation best practices | OpenAI API (lida em 2026-11-04)