Pesquisa na Web

Quando Usar

• Use quando uma tarefa do Agente Pi precisar de informações atuais da web, buscas de páginas, PDFs, YouTube ou conteúdo do GitHub.
• Use quando o Pi deve usar seu próprio pacote de acesso à web em vez de outra ferramenta de navegador de agente.

O pacote pi-web-access é instalado globalmente. Configuração zero via Exa MCP (sem chave de API), com fallback Exa → Perplexity → Gemini.

CRÍTICO: sempre passe workflow: "none"

Cada chamada web_search DEVE incluir workflow: "none". Isso pula o pop-up interativo do curador do navegador (o usuário não quer que ele abra). Sem exceções — consulta única ou queries em lote, sempre defina workflow: "none".

web_search({ queries: ["query 1", "query 2"], workflow: "none" })

Ferramentas

• web_search — pesquisa na web; retorna respostas sintetizadas com citações. Pode ser chamado várias vezes por turno. Sempre passe workflow: "none".
• code_search — contexto de código Exa sem chave. Use para pesquisas de bibliotecas/APIs/código em vez do web_search genérico.
• fetch_content — busca URL(s) → markdown; lida com PDFs, YouTube, GitHub.
• get_search_content — páginas grandes (>30k caracteres) são truncadas nas respostas, mas armazenadas na íntegra; chame esta para puxar o restante sob demanda para que não estourem o contexto.

Detalhes do fetch_content

• URLs do GitHub são clonadas, não raspadas — você obtém arquivos reais + um caminho local para explorar com read/bash (repositórios privados precisam do CLI gh). Use isso para trabalho de desenvolvimento.
• PDFs → extraídos automaticamente para markdown em ~/Downloads/, legíveis em seções (apenas texto, sem OCR).
• YouTube/vídeo → transcrições brutas completas + extração de quadros. Precisa de um GEMINI_API_KEY (não é configuração zero); a extração de quadros também precisa de ffmpeg/yt-dlp.

Roteamento — combine com a formulação do usuário

Sempre use a ferramenta web_search. Essas contagens são MÍNIMOS RÍGIDOS — conte suas consultas antes de responder e não pare antes:

• "pesquisa na web" → pelo menos 2 consultas, palavras-chave/ângulos variados, depois sintetize.
• "pesquisa web extensiva" → pelo menos 4 consultas, palavras-chave e ângulos totalmente diferentes.
• "pesquisa profunda" → pelo menos 8 consultas, palavras-chave e ângulos totalmente diferentes, executadas em 2–3 lotes sucessivos (refine os ângulos após cada lote), para aprender o máximo possível sobre o tópico.

Uma única chamada web_search em lote conta cada consulta em queries[] para o total. Se seu primeiro lote estiver abaixo do mínimo, envie outro lote antes de sintetizar.

Fallback / alternativa: Pesquisa web DeepAPI

Se a cadeia Exa → Perplexity → Gemini falhar, ou você precisar de resultados classificados com URLs:

test -n "$DEEPAPI_API_KEY" || { echo "DEEPAPI_API_KEY is not set"; exit 1; }
curl -s --max-time 60 "https://deepapi.co/v1/search/web" \
  -H "Authorization: Bearer $DEEPAPI_API_KEY" -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"query": "your search terms", "maxResults": 5, "maxCostUsd": "0.05"}'

Os resultados estão em .output (título, url, trecho por item). Consulta com menos de 500 caracteres. Detalhes completos: habilidade deepapi.

Limitações

• Adaptado de davidondrej/skills; verifique caminhos locais, ferramentas, credenciais e recursos do agente antes de agir.
• Para comandos, acesso remoto, agendamento, automação de navegador ou fluxos de trabalho de alteração de arquivos, obtenha aprovação explícita do usuário e confirme o ambiente de destino primeiro.