Adicione busca web em tempo real ao DeepSeek Harness em 2 comandos

O DeepSeek Harness é o runtime de agentes open-source que a DeepSeek lançou como developer preview na semana passada: modelos, ferramentas, sessões e até o próprio loop do agente são todos plugins. O que ele não trazia era uma busca web de nível de produção — até agora. O anysearch-dsh conecta o AnySearch ao perfil web do Harness em dois comandos: sem servidor MCP para implantar, sem chave de API para começar. Este post apresenta a instalação, as ferramentas disponíveis e como ajustá-lo para workloads de agentes voltados a pesquisa.

O que o plugin AnySearch adiciona

O plugin se instala no perfil web e atualiza o web_search nativo do Harness para o índice em tempo real do AnySearch, além de adicionar três ferramentas extras:

web_search — a ferramenta nativa, agora com o AnySearch como backend; retorna títulos, snippets e URLs de origem para que o agente possa citar e verificar.
anysearch_capabilities — descoberta em tempo real de domínios, tags verticais e parâmetros suportados. O agente chama esta ferramenta primeiro ao enfrentar uma tarefa especializada, em vez de você precisar embutir tags no prompt.
anysearch_search — busca vertical ou parametrizada (direito, finanças, segurança, acadêmico, código e mais) usando as tags e os parâmetros descobertos acima.
anysearch_batch_search — executa de uma a cinco buscas independentes simultaneamente; uma falha isolada não derruba o lote.

Pré-requisitos

Node.js 22.19+ (ou 24+) e pnpm 11.7+ no PATH — o comando de plugins do DSH usa o pnpm para gerenciar as dependências do perfil.
O próprio DeepSeek Harness (npx -y @deepseek-ai/dsh o baixa sob demanda).

Instalação em dois comandos

Passo 1 — adicione o plugin ao perfil web:

npx -y @deepseek-ai/dsh plugin --profile web add @anysearch/anysearch-dsh

Passo 2 — inicie o Harness:

npx -y @deepseek-ai/dsh web

É só isso. Pergunte algo ao agente que dependa de informações recentes, por exemplo: “Busque as últimas atualizações do DeepSeek Harness e cite as fontes.” A camada de perfil incluída automaticamente configura o AnySearch como provedor do ctx.web e monta as ferramentas avançadas — nenhuma configuração adicional é necessária.

Opcional: configurar uma chave de API

A cota anônima funciona para um teste rápido. Para uso contínuo, registre-se em anysearch.com (1.000 buscas gratuitas por dia para usuários registrados) e armazene a chave em $DSH_HOME/.credentials.yaml (~/.dsh/.credentials.yaml por padrão):

ANYSEARCH_API_KEY: "as_sk_your_key"

O plugin resolve a credencial gerenciada a cada operação, então a rotação de chaves vale já para a próxima requisição, sem reiniciar o DSH. Uma variável de ambiente ANYSEARCH_API_KEY exportada tem prioridade. Inspecione o perfil composto sem expor o valor da chave:

npx -y @deepseek-ai/dsh --profile web --dump-config

Personalize o provedor de busca

Para sobrescrever os padrões, substitua a entrada web-search-anysearch incluída na camada de configuração de usuário do perfil — mantenha o id, substitua a configuração inteira e não adicione um segundo provedor AnySearch com outro id:

- id: web-search-anysearch
  config:
    apiKeyEnv: ANYSEARCH_API_KEY
    baseURL: https://api.anysearch.com
    maxRenderedContentChars: 12000

maxRenderedContentChars limita quantos caracteres do conteúdo limpo da página são renderizados para o modelo por chamada de ferramenta avançada (padrão: 12.000) — aumente para agentes de deep research, diminua para economizar tokens.

Dicas práticas para quem constrói agentes

Use busca em lote para agentes de pesquisa. Pesquisa multi-fonte, checagem de fatos e varreduras competitivas são exatamente o caso de uso do anysearch_batch_search: dispare até cinco consultas de uma vez e deixe o modelo sintetizar.
Descubra antes de embutir no código. Domínios, tags e parâmetros mudam com o tempo; faça o modelo chamar anysearch_capabilities primeiro, em vez de enviar tags desatualizadas no prompt.
Mantenha o plugin atualizado: npx -y @deepseek-ai/dsh plugin --profile web update @anysearch/anysearch-dsh (troque update por remove para desinstalar).
Atenção ao aviso de preview. O Harness está em developer preview e pode introduzir mudanças incompatíveis, então planeje as atualizações do plugin. Se você também busca desempenho com modelos abertos, confira nosso guia sobre como rodar o Qwen3.8-27B com eficiência.

Recursos

GitHub: anysearch-team/anysearch-dsh
npm: @anysearch/anysearch-dsh
DeepSeek Harness: deepseek-ai/deepseek-harness
AnySearch: anysearch.com