Como usar o DeepSeek Search e o Fetch no Hermes Agent

Por Cameron Voss e Marcus Bell · Documentação consultada em 9 de novembro de 2026

O Hermes pode responder usando um modelo DeepSeek, mas precisa de um serviço de busca configurado para pesquisar informações atuais e apresentar links. Este guia aborda o plugin comunitário deepseek-search-fetch, que conecta as ferramentas web do Hermes às APIs Search e Fetch do DeepSeek.

As instruções seguem a documentação publicada do plugin na versão 1.0.10. Elas não foram testadas em uma instalação real do Hermes para este artigo. Menus e comportamentos podem mudar com novas versões.

O que fazem o Search e o Fetch?

São serviços distintos. Uma resposta do modelo, por si só, não comprova que o Hermes pesquisou na internet ou leu uma página.

O que você precisa antes de instalar?

• Hermes Agent 0.22.0 ou posterior, no perfil que será usado.
• Uma chave direta da API DeepSeek e uma conta com saldo disponível. O login do chat não é uma chave de API.
• Permissão para instalar um plugin comunitário e executar código no ambiente do Hermes.
• Um modelo funcionando no Hermes. Ele pode ser da DeepSeek, mas o serviço web e o modelo de chat são configurados separadamente.

O plugin é mantido pela comunidade. Antes de instalá-lo, examine o código e as permissões: ele é executado no ambiente do Hermes e pode acessar credenciais disponíveis ali. Não exponha sua chave em capturas de tela, mensagens ou no histórico do terminal.

Consultas e URLs enviadas ao Fetch vão para a DeepSeek, que acessa as páginas em seus servidores. Use páginas públicas nos testes e evite consultas sensíveis ou URLs privadas. Se o Hermes recorrer a outro provedor, ele poderá receber a consulta ou a URL.

Se estiver começando, consulte primeiro nosso guia de configuração do Hermes com DeepSeek. Uma chave de Coding Plan ou de outro provedor pode usar endpoint e permissões diferentes; não presuma que ela funcione na API direta de busca da DeepSeek.

Como instalar e configurar o plugin?

Faça backup da configuração do perfil antes de alterar os serviços web. Anote as configurações atuais de busca e extração para poder restaurá-las. Use o mesmo perfil para o plugin, a chave e a sessão do Hermes.

1. Instale o plugin comunitário

No terminal com o perfil desejado ativo, instale e habilite o plugin:

hermes plugins install deepseek-search-fetch --enable

Inicie uma nova sessão. Se o Desktop ou gateway já estiver em execução, reinicie-o para carregar o plugin. Verifique se ele aparece como habilitado:

hermes plugins list
hermes tools

2. Adicione sua chave direta da API DeepSeek

Guarde DEEPSEEK_API_KEY nas configurações privadas de segredos ou de ambiente do perfil. Se o Hermes já usa uma chave direta nesse perfil, confirme que o plugin consegue acessá-la. Não cole a chave no chat nem em um comando que ficará no histórico do terminal.

3. Selecione os serviços web

Direcione as duas operações ao provedor registrado por este plugin:

hermes config set web.search_backend deepseek
hermes config set web.extract_backend deepseek

O nome deepseek pertence ao plugin deepseek-search-fetch. Outros plugins com nomes semelhantes podem exigir outra configuração. Confirme que busca e extração estão habilitadas no Hermes e mantenha as configurações anteriores para reverter a mudança.

Como verificar se está funcionando?

Em uma nova sessão, teste busca e extração separadamente, usando informações públicas e uma consulta sem dados sensíveis.

1. Busca: peça ao Hermes que encontre a documentação atual do DeepSeek sobre Search e Fetch e retorne duas URLs. Confira a atividade web_search e os links.
2. Extração: peça que leia uma das páginas públicas e resuma um detalhe. Confirme a chamada web_extract e compare a resposta com a página.
3. Provedor: confira a configuração e os diagnósticos ou registros de uso disponíveis. Uma resposta plausível ou uma chamada bem-sucedida não prova, sozinha, que a DeepSeek processou a solicitação.

Registre as versões do Hermes e do plugin, o perfil, o horário e o resultado de cada teste. Consulte logs ou registros de uso que identifiquem o provedor, sem registrar a chave ou a consulta privada. Se não houver evidência suficiente, deixe o provedor como não confirmado.

Quando vale usar este plugin?

Considere-o se você já tem uma conta direta da API DeepSeek e quer usar a DeepSeek para busca e extração. Se o serviço atual atende às suas necessidades ou você não quer outro serviço pago, mantê-lo é uma opção. Este guia não compara qualidade, velocidade ou confiabilidade entre provedores.

Resultados de busca são pontos de partida. Abra a página, confira a data e verifique a informação no texto original. O Fetch pode falhar em alguns sites, e uma página retornada pode estar desatualizada ou conter erros.

Quanto custa?

Preços publicados pela DeepSeek consultados em 9 de novembro de 2026. Search e Fetch são APIs distintas; tokens de entrada e saída do modelo são cobrados à parte. Preços e acesso podem mudar.

Assim, 100 buscas e 100 extrações bem-sucedidas totalizam US$ 0,15, sem incluir tokens ou outros serviços. Segundo a DeepSeek, uma solicitação cobrável deve retornar HTTP 200 e produzir um resultado; falhas, resultados vazios e tempos esgotados não são cobrados pelas regras publicadas. Confira os preços e sua conta antes de usar essa estimativa.

O que verificar se a busca falhar?

Para problemas gerais de modelo, chave ou perfil, consulte o guia de solução de problemas do Hermes.

Como voltar à configuração anterior?

Restaure os valores de busca e extração anotados antes da instalação. Se não precisar mais do plugin, desative-o:

hermes plugins disable deepseek-search-fetch

Se nenhum dos serviços tinha valor definido anteriormente, a documentação indica estes comandos para remover as configurações explícitas:

hermes config unset web.search_backend
hermes config unset web.extract_backend

Remover os valores não restaura automaticamente outro provedor configurado antes. Inicie uma nova sessão e teste o serviço desejado. Não altere configurações não relacionadas de modelo, memória ou ferramentas.

Perguntas frequentes

A busca vem incluída ao escolher um modelo DeepSeek?

Não. Modelo, Search e Fetch são serviços separados. Configure e teste o provedor web à parte.

O plugin é oficial?

Não. É mantido pela comunidade e sua página informa que não é afiliado à DeepSeek.

Toda pesquisa usará a DeepSeek?

Não. O serviço ativo e as configurações de reserva determinam o destino; outro provedor pode atender uma falha.

O plugin lê qualquer site?

Não. Alguns sites bloqueiam acesso automatizado ou dependem de renderização no navegador. Teste as páginas necessárias.

Posso usar minha chave de Coding Plan?

Somente se o provedor confirmar suporte às APIs Search e Fetch com essa chave e esse endpoint. Acesso ao modelo não garante acesso à busca.