agente-de-pesquisa-abrangente

Melhores Práticas para Agente de Pesquisa Abrangente

Este skill aborda falhas comuns em tarefas de pesquisa com várias etapas: erros de ferramenta não tratados, validação ausente, raciocínio opaco e conclusões prematuras. Ele fornece protocolos estruturados para validação de fontes, recuperação de erros e transparência de raciocínio, melhorando significativamente a qualidade e confiabilidade da pesquisa.

Quando Ativar

• A tarefa envolve pesquisa na web com operações de busca, leitura de URL ou fetch
• A tarefa requer coleta de informações de várias fontes
• A tarefa possui requisitos explícitos de completude ou verificação
• A tarefa inclui operações com arquivos que precisam de validação (salvar, escrever, ler)
• Qualquer fluxo de trabalho de pesquisa ou coleta de informações com mais de 3 interações com ferramentas

Conceitos Principais

• Pontos de Verificação de Validação: Etapas de verificação explícitas nas transições de fase para confirmar saídas de ferramentas, relevância das fontes e completude das informações antes de prosseguir
• Protocolos de Recuperação de Erros: Reconhecimento e tratamento obrigatórios de falhas de ferramentas com estratégias alternativas, em vez de continuação silenciosa
• Rastreabilidade de Fontes: Manter um registro claro de quais fontes foram realmente recuperadas versus referenciadas a partir de conhecimento prévio para evitar alucinações
• Blocos de Pensamento Substanciais: Traços de raciocínio detalhados que documentam insights, conexões, lacunas e a lógica das decisões em cada etapa
• Validação Cruzada de Fontes: Verificar afirmações-chave contra múltiplas fontes e anotar explicitamente consensos, contradições e lacunas de informação

Padrões a Evitar

• Falha Silenciosa de Ferramenta: Uma chamada de ferramenta retorna um erro (404, timeout, URL inválido), mas o agente prossegue sem reconhecê-lo, potencialmente perdendo informações críticas. Sempre registre falhas e tente recuperação ou documente a lacuna.
• Alegações Vagas de Completude: O agente declara 'Tenho informações suficientes' ou 'a pesquisa é abrangente' sem especificar o que foi aprendido, quais fontes apoiam as afirmações ou quais lacunas permanecem. Substitua por resumos específicos da cobertura.
• Seleção de Fonte Não Validada: O agente lê URLs dos resultados de busca sem primeiro avaliar relevância, credibilidade ou atualidade. Isso desperdiça chamadas de ferramenta em fontes de baixa qualidade. Sempre classifique e priorize fontes antes da leitura aprofundada.
• Blocos de Pensamento Genéricos: O pensamento contém apenas descrições da próxima ação ('Agora vou pesquisar por X') sem análise do que foi aprendido, como isso se conecta ao objetivo ou quais perguntas permanecem. O pensamento deve ser substancial e reflexivo.
• Erro no Método de Verificação: Usar list_directory para verificar a criação de arquivos pode produzir falsos negativos devido ao cache. Sempre use read_file para verificação real do conteúdo.
• Citação Sem Recuperação: Citar fontes (URLs, títulos de artigos) no relatório final que nunca foram buscadas ou lidas com sucesso. Rastreie fontes explicitamente e proíba citar conteúdo não recuperado.
• Chamadas Redundantes de Ferramentas: Fazer buscas sobrepostas ou ler fontes sem rastrear o que já foi obtido. Mantenha um rastreador de 'recursos encontrados' para evitar duplicação.

Práticas Recomendadas

• Implementar Avaliação de Fonte Pré-Leitura: Antes de ler URLs, classifique os resultados da busca por relevância, credibilidade, atualidade e autoridade. Documente a lógica de seleção em blocos de pensamento.
• Usar Blocos de Pensamento Estruturados: Cada bloco de pensamento deve incluir: (a) o que foi aprendido com a fonte/ação, (b) como se conecta ao objetivo da pesquisa, (c) quaisquer contradições/lacunas identificadas, (d) decisões estratégicas tomadas. Evite declarações genéricas de próxima ação.
• Adicionar Reconhecimento Obrigatório de Erro: Quando qualquer ferramenta falhar, o próximo bloco de pensamento deve abordá-lo explicitamente: anote o tipo de falha, proponha uma estratégia de recuperação (repetição, fonte alternativa ou lacuna documentada) e explique a abordagem escolhida.
• Criar Lista de Verificação de Validação Pré-Conclusão: Antes de declarar a pesquisa concluída, verifique: todas as seções necessárias têm evidências específicas, todas as fontes foram recuperadas com sucesso, as principais afirmações são validadas cruzadamente e as lacunas estão documentadas.
• Implementar Validação Cruzada de Fontes: Após coletar informações de várias fontes, compare explicitamente as descobertas. Anote onde as fontes concordam, onde se contradizem e o que permanece não verificado. Use isso para avaliar a confiança geral.
• Manter Tabela de Rastreamento de Fontes: Crie uma tabela simples no pensamento mostrando quais URLs foram buscadas, quais falharam e quais foram usadas para afirmações específicas. Nunca cite fontes não recuperadas.
• Usar Read_File para Verificação: Ao confirmar escritas de arquivos, use read_file para verificar o conteúdo real em vez de list_directory, que pode ter problemas de cache causando falsos negativos.
• Adicionar Fase de Validação Explícita: Após ler as fontes, escreva uma breve síntese que confirme a utilidade, anote a relevância para os objetivos da pesquisa e identifique as lacunas restantes antes de prosseguir para a próxima fase.

Diretrizes

1. Após cada chamada de ferramenta, verifique explicitamente erros na resposta e reconheça falhas no próximo bloco de pensamento com estratégia de recuperação
2. Antes de ler URLs, classifique as fontes por relevância/credibilidade e documente a lógica de seleção - nunca leia resultados sem avaliação
3. Blocos de pensamento devem ter no mínimo 3 a 5 frases e incluir: o que foi aprendido, conexões com o objetivo, lacunas/contradições e próximos passos
4. Crie uma lista de verificação pré-conclusão verificando: todos os requisitos cobertos, fontes recuperadas, afirmações validadas, lacunas documentadas
5. Mantenha rastreamento de fontes - cite apenas URLs que foram buscadas com sucesso; proíba citar fontes não recuperadas
6. Ao escrever relatórios finais, inclua uma seção de 'Limitações e Lacunas' documentando o que foi tentado, mas falhou, ou o que permanece não verificado
7. Use read_file (não list_directory) para verificar o conteúdo do arquivo após operações de salvamento
8. Valide cruzadamente afirmações-chave em pelo menos 2 fontes quando possível; anote explicitamente consenso ou contradições
9. Rastreie informações coletadas para evitar buscas redundantes - implemente um rastreador de 'recursos encontrados' para pesquisas em várias fases
10. Substitua declarações vagas de 'abrangente' por resumos específicos: 'Cobriu X fontes sobre o tópico Y; faltando aspectos Z'

Exemplos

• *Antes (Antipadrão): 'Pesquisei por engenharia de contexto e encontrei vários resultados. Agora vou ler algumas URLs e depois escrever o relatório. Tenho informações suficientes para prosseguir.'

Depois (Padrão): 'A busca retornou 15 resultados sobre engenharia de contexto. Avaliando relevância: Liu et al. (2024) parece o mais autoritário sobre o fenômeno 'perdido no meio'; a documentação da Anthropic provavelmente tem as especificações atuais da janela de contexto; Patel (2023) aborda as melhores práticas de RAG. Classificando estes como as 3 principais prioridades. Lendo o primeiro resultado primeiro. Se a fonte primária falhar (erro de URL), tentará uma busca de backup pelo URL da documentação correta e anotará a lacuna no relatório final.'

• *Antes (Antipadrão): A ferramenta retorna erro 404 para a URL das janelas de contexto da Anthropic. O agente continua sem reconhecimento. Posteriormente cita 'Claude tem janela de contexto de 200K' sem mostrar a fonte. O relatório final cita um artigo do Google Research que nunca foi buscado.

Depois (Padrão): A ferramenta retornou 404 para a URL da Anthropic. Pensamento: 'Fonte primária falhou. Plano alternativo: pesquisar URL alternativa da documentação da Anthropic ou encontrar versão arquivada. Se indisponível, anotar dados da janela de contexto apenas de fontes secundárias e adicionar aviso sobre status de verificação.' Em seguida: 'Validou cruzadamente a janela de contexto do Claude: o blog da Anthropic (lido com sucesso) e duas fontes de documentação do desenvolvedor concordam com 200K. Confiante nesta afirmação.' A tabela de rastreamento de fontes mostra: URL da Anthropic (falhou, backup usado), Blog (sucesso), Documentação do desenvolvedor (sucesso).

---

Expectativas de Pontuação

Tarefas de pesquisa complexas com múltiplas ferramentas (6+) e cadeias de raciocínio de várias etapas geralmente alcançam pontuações na faixa de 65 a 75. Isso não é uma limitação do prompt, mas reflete:

• Variabilidade inerente nas saídas das ferramentas afetando os caminhos de raciocínio
• Múltiplas abordagens válidas levando a diferentes pontuações intermediárias
• Natureza estocástica da execução de agentes de longo horizonte

Foco na melhoria relativa e eliminação de padrões em vez de pontuações absolutas. Uma melhoria de 5 a 10% com a otimização é significativa para tarefas complexas.

---

Metadados do Skill

Gerado: 2026-01-11 Fonte: Otimizador de Traço de Raciocínio Iterações de Otimização: 10 Melhor Pontuação Alcançada: 72/100 (iteração 4) Pontuação Final: 70,0/100 Melhoria de Pontuação: 67,6 → 70,0 (+3,6%)