> For the complete documentation index, see [llms.txt](https://developers.oxylabs.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developers.oxylabs.io/integrations/es/ai-studio-integrations/hermes-agent.md).

# Hermes Agent

[**Agente Hermes**](https://github.com/NousResearch/hermes-agent) 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**](https://aistudio.oxylabs.io/) 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](https://github.com/NousResearch/hermes-agent) instalado con `hermes` CLI
* Oxylabs AI Studio [clave de API](https://aistudio.oxylabs.io/api-key) (AI Studio usa una sola clave de API, sin nombre de usuario/contraseña separados)

## Configuración

{% stepper %}
{% step %}

### Instala el plugin

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

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

{% endstep %}

{% step %}

### Configura tu clave de API

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

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

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

{% endstep %}

{% step %}

### Elige la implementación

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

#### **Búsqueda web**

```bash
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.

{% hint style="info" %}
**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](#web-extraction).
{% endhint %}

#### **Extracción web**

```bash
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:

```yaml
web:
  backend: "oxylabs"
```

{% endstep %}

{% step %}

### 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:

```bash
hermes restart
```

{% endstep %}

{% step %}

### 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](#set-your-api-key), luego reinicia de nuevo.

{% hint style="info" %}
Una vez que Oxylabs se selecciona como `backend`, una clave faltante solo devuelve un error en lugar de recurrir a otro proveedor.
{% endhint %}
{% endstep %}
{% endstepper %}

### Anulación del endpoint (opcional)

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

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

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

{% hint style="info" %}
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.
{% endhint %}

## Más recursos

Consulta nuestro [repositorio de GitHub](https://github.com/oxylabs/hermes-web-oxylabs) para ver las referencias completas del código.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://developers.oxylabs.io/integrations/es/ai-studio-integrations/hermes-agent.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.