DeepSeek + Hermes Agent

Cómo usar DeepSeek Search y Fetch en Hermes Agent

Por Cameron Voss y Marcus Bell · Documentación consultada el 9 de noviembre de 2026

Respuesta rápida: Para usar la búsqueda de DeepSeek en Hermes, instala un complemento comunitario compatible, proporciona una clave directa de la API de DeepSeek y selecciona sus servicios de búsqueda y extracción. Después prueba ambas funciones por separado. Conectar un modelo DeepSeek al chat no configura estas herramientas por sí solo. Search y Fetch se facturan por separado de los tokens del modelo.

Hermes puede responder con un modelo DeepSeek, pero necesita un servicio de búsqueda configurado para consultar información actual y ofrecer enlaces. Esta guía explica el complemento comunitario deepseek-search-fetch, que conecta las herramientas web de Hermes con las API Search y Fetch de DeepSeek.

Las instrucciones siguen la documentación publicada de la versión 1.0.10 del complemento. No se han probado en una instalación real de Hermes para este artículo. Los menús y el comportamiento pueden cambiar con nuevas versiones.

¿Qué hacen Search y Fetch?

Herramienta	Función	Ejemplo
Search	Encuentra páginas relacionadas con una consulta.	Buscar documentación reciente de DeepSeek sobre llamadas a herramientas.
Fetch	Obtiene el contenido de una página a partir de su URL.	Leer una página de documentación antes de resumirla.
Modelo	Interpreta los resultados y redacta una respuesta.	Comparar las páginas obtenidas y citar sus URL.

Son servicios distintos. Una respuesta correcta del modelo no demuestra que Hermes haya buscado en internet o leído una página.

¿Qué necesitas antes de instalar?

Hermes Agent 0.22.0 o posterior, en el perfil que vas a utilizar.
Una clave directa de la API de DeepSeek y saldo disponible en la cuenta. El inicio de sesión del chat no es una clave de API.
Permiso para instalar un complemento comunitario y ejecutar código en el entorno de Hermes.
Un modelo que funcione en Hermes. Puede ser de DeepSeek, pero el servicio web y el modelo de chat se configuran por separado.

El complemento lo mantiene la comunidad. Revisa su código y permisos antes de instalarlo: se ejecuta dentro del entorno de Hermes y puede acceder a las credenciales disponibles allí. No incluyas tu clave en capturas, mensajes ni en el historial del terminal.

Las consultas y las URL que envías a Fetch se transmiten a DeepSeek, que obtiene las páginas desde sus servidores. Usa páginas públicas durante las pruebas y evita consultas sensibles o URL privadas. Si Hermes recurre a otro proveedor, este también podría recibir la consulta o URL.

Si partes de cero, consulta primero nuestra guía de configuración de Hermes con DeepSeek. Una clave de Coding Plan o de otro proveedor puede utilizar un endpoint y permisos distintos; no des por hecho que funcione con la API directa de búsqueda de DeepSeek.

¿Cómo se instala y configura el complemento?

Haz una copia de la configuración del perfil antes de cambiar los servicios web. Anota los valores actuales de búsqueda y extracción para poder restaurarlos. Utiliza el mismo perfil para el complemento, la clave y la sesión de Hermes.

1. Instala el complemento comunitario

En un terminal con el perfil deseado activo, instala y habilita el complemento:

hermes plugins install deepseek-search-fetch --enable

Inicia una sesión nueva. Si Desktop o el gateway ya están en ejecución, reinícialos para cargar el complemento. Comprueba que aparece habilitado:

hermes plugins list
hermes tools

2. Añade tu clave directa de la API

Guarda DEEPSEEK_API_KEY en los secretos privados o ajustes de entorno del perfil. Si Hermes ya utiliza una clave directa en ese perfil, confirma que el complemento puede acceder a ella. No pegues la clave en el chat ni en un comando que quede guardado en el historial.

3. Selecciona los servicios web

Dirige ambas operaciones al proveedor registrado por este complemento:

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

El nombre deepseek corresponde aquí a deepseek-search-fetch. Otros complementos parecidos pueden usar otro nombre o configuración. Asegúrate de habilitar la búsqueda y la extracción en Hermes y conserva los ajustes anteriores por si necesitas volver atrás.

¿Cómo comprobar que funciona?

En una sesión nueva, prueba búsqueda y extracción por separado con información pública y una consulta sin datos sensibles.

Búsqueda: pide a Hermes la documentación actual de DeepSeek sobre Search y Fetch y dos URL de resultados. Revisa la actividad web_search y los enlaces.
Extracción: pídele que lea una de las páginas públicas y resuma un detalle. Comprueba que aparezca una llamada web_extract y compara la respuesta con la página.
Proveedor: revisa la configuración y los diagnósticos o registros de uso disponibles. Una respuesta convincente o una llamada exitosa no demuestra por sí sola que DeepSeek haya atendido la solicitud.

El complemento documenta una opción de recuperación sin clave. Si está activa, otro proveedor puede atender una solicitud fallida de DeepSeek. Comprueba la configuración y las pruebas disponibles antes de atribuir el resultado a DeepSeek. No uses consultas ni URL privadas en la prueba.

Registra las versiones de Hermes y del complemento, el perfil, la hora y el resultado de cada prueba. Consulta los registros que permitan identificar al proveedor, sin guardar la clave ni consultas privadas. Si la evidencia no identifica el servicio, déjalo como no confirmado.

¿Cuándo conviene usarlo?

Considera este complemento si ya tienes una cuenta directa de la API de DeepSeek y quieres usar DeepSeek tanto para buscar como para extraer páginas. Si tu proveedor actual cubre tus necesidades o no quieres otro servicio de pago, puedes mantenerlo. Esta guía no compara la calidad, velocidad ni fiabilidad de los proveedores.

Los resultados de búsqueda son un punto de partida. Abre la página, revisa la fecha y comprueba la información en el texto original. Fetch puede fallar con algunos sitios y una página encontrada puede contener información obsoleta o incorrecta.

¿Cuánto cuesta?

Precios publicados por DeepSeek consultados el 9 de noviembre de 2026. Search y Fetch son API distintas; los tokens de entrada y salida del modelo se cobran aparte. Los precios y el acceso pueden cambiar.

Servicio	Precio publicado	Ejemplo
Search	0,75 USD por 1.000 solicitudes exitosas	100 búsquedas: 0,075 USD
Fetch	0,75 USD por 1.000 solicitudes exitosas	100 extracciones: 0,075 USD

Por ejemplo, 100 búsquedas y 100 extracciones exitosas suman 0,15 USD, sin incluir tokens ni otros cargos. Según DeepSeek, una solicitud facturable debe devolver HTTP 200 y producir un resultado; los fallos, resultados vacíos y tiempos de espera agotados no se cobran según las reglas publicadas. Comprueba tu cuenta y las tarifas actuales antes de usar esta estimación.

¿Qué revisar si falla la búsqueda?

Síntoma	Primera comprobación
El chat funciona, pero no busca	Confirma que `web_search` y el complemento estén habilitados en el perfil activo y que el servicio de búsqueda sea `deepseek`.
Falta la clave o aparece HTTP 401	Comprueba que la clave directa esté disponible para el mismo perfil y proceso. No la imprimas ni compartas.
HTTP 402	Revisa el saldo y el acceso de facturación de la cuenta DeepSeek.
HTTP 429 o error temporal del servidor	Reduce la frecuencia y vuelve a intentarlo más tarde. Hay límites por cuenta y otro por dominio para Fetch.
Hay enlaces, pero no se puede leer una página	Prueba otra página pública. El sitio puede bloquear accesos automatizados o requerir un renderizado que Fetch no ofrece.
Hay respuesta, pero no sabes qué proveedor la atendió	Revisa la configuración, la actividad y los registros disponibles. Un proveedor de reserva puede ocultar un fallo de DeepSeek.

Para problemas generales de modelo, clave o perfil, consulta la guía de solución de problemas de Hermes.

¿Cómo recuperar la configuración anterior?

Restaura los valores de búsqueda y extracción que anotaste antes de instalar. Si ya no necesitas el complemento, desactívalo:

hermes plugins disable deepseek-search-fetch

Si antes no había ningún valor establecido, la documentación indica estos comandos para eliminar la configuración explícita:

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

Eliminar los valores no restaura automáticamente otro proveedor que hubieras configurado. Inicia una sesión nueva y comprueba el servicio deseado. Conserva los ajustes no relacionados de modelo, memoria y herramientas.

Preguntas frecuentes

¿La búsqueda está incluida al elegir un modelo DeepSeek?

No. El modelo, Search y Fetch son servicios separados. Configura y prueba el proveedor web por separado.

¿El complemento es oficial?

No. Lo mantiene la comunidad y su ficha indica que no está afiliado a DeepSeek.

¿Todas las búsquedas usarán DeepSeek?

No. Depende del servicio activo y de la configuración de reserva; otro proveedor puede atender una solicitud fallida.

¿Puede leer cualquier sitio?

No. Algunos sitios bloquean el acceso automatizado o necesitan renderizado en el navegador. Prueba las páginas que necesites.

¿Puedo usar mi clave de Coding Plan?

Solo si tu proveedor confirma que admite las API Search y Fetch con esa clave y endpoint. El acceso al modelo no garantiza acceso a la búsqueda.

¿Necesitas configurar primero el modelo? Empieza por la guía de DeepSeek y Hermes y vuelve después para configurar la búsqueda.