Hermes Agent

Oxylabs AI Studio permite que tu Hermes Agent extraiga búsqueda web en tiempo real y datos limpios, listos para LLM, para usar contexto en vivo y contenido estructurado de páginas como parte de su flujo de razonamiento.

Agente Hermes es un framework de agentes enchufable que integra búsqueda y extracción web mediante backends intercambiables. El hermes-web-oxylabs el plugin registra Oxylabs AI Studio como uno de los backends disponibles, llamando directamente a la API REST de AI Studio (sin SDK del proveedor) para proporcionar al agente:

• Resultados de búsqueda web ordenados – título, URL, descripción
• Datos limpios de la página como Markdown, para investigación, comparaciones y razonamiento posterior
• Contexto web reciente para respuestas más precisas

Requisitos

• Agente Hermes instalado con hermes CLI
• Oxylabs AI Studio clave de API (AI Studio usa una sola clave de API, sin nombre de usuario/contraseña separados)

Configuración

1

Instala el plugin

Registra Oxylabs como un proveedor web que Hermes puede usar para búsqueda y extracción:

hermes plugins install oxylabs/hermes-web-oxylabs --enable

2

Configura tu clave de API

export OXYLABS_API_KEY="your-api-key-here"

O añádela a Hermes .env archivo en lugar de la configuración de tu shell:

# ~/.hermes/.env
OXYLABS_API_KEY=your-api-key-here

3

Elige la implementación

Configura Oxylabs como el backend para búsqueda, extracción, o ambos.

Búsqueda web

hermes config set web.search_backend oxylabs

Para consultas que solicitan 10 resultados o menos, el plugin llama al endpoint de AI Studio /search/instant y devuelve los resultados en línea. Para conjuntos de resultados más grandes, los envía a /search/run y consulta periódicamente hasta completarse.

Búsqueda devuelve solo listados (título, URL, descripción), el contenido de la página se obtiene por separado a través de extracción.

Extracción web

hermes config set web.extract_backend oxylabs

Cada URL se envía al endpoint de AI Studio /scrape y se consulta periódicamente hasta completarse (hasta 60 segundos por URL).

Un lote de URL se procesa de forma concurrente; el fallo en una URL no bloquea el lote y devuelve un error campo en lugar de contenido.

Búsqueda + Extracción (backend completo)

Si quieres que Oxylabs gestione ambas búsqueda y extracción, establece la clave compartida backend en lugar de las dos anteriores:

web:
  backend: "oxylabs"

4

Reinicia Hermes

Los cambios de backend y de la clave de API solo se leen al inicio de la sesión. Inicia una nueva sesión o reinicia la actual:

hermes restart

5

Verificar

Ejecuta una tarea que necesite contexto web actual (p. ej., una solicitud para leer una URL específica). Si la respuesta incluye resultados de búsqueda o contenido de la página, la integración es correcta.

Si OXYLABS_API_KEY no está configurada se devuelve un error, la clave no se tomó. Vuelve a Paso 2, luego reinicia de nuevo.

Una vez que Oxylabs se selecciona como backend, una clave faltante solo devuelve un error en lugar de recurrir a otro proveedor.

Anulación del endpoint (opcional)

Hermes web_extract la herramienta admite la anulación de la URL base de la API mediante lo siguiente:

export OXYLABS_API_URL="https://your-custom-endpoint"

Se usa para pruebas o configuraciones autohospedadas. Valor predeterminado: https://api-aistudio.oxylabs.io.

Más funciones avanzadas son compatibles con Oxylabs AI Studio (formato, render_javascript, geo_location) que actualmente no son compatibles a través del despachador de Hermes y podrían estar disponibles más adelante.

Más recursos

Consulta nuestro repositorio de GitHub para ver las referencias completas del código.