> 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/pt-br/ai-studio-integrations/hermes-agent.md).

# Hermes Agent

O AI Studio da Oxylabs permite que seu Hermes Agent obtenha pesquisa web em tempo real e dados limpos, prontos para LLM, para usar contexto em tempo real e conteúdo estruturado da página como parte do seu fluxo de raciocínio.

[**Hermes Agent**](https://github.com/NousResearch/hermes-agent) é um framework de agente plugável que integra busca e extração na web por meio de backends intercambiáveis. O `hermes-web-oxylabs` plugin registra [**Oxylabs AI Studio**](https://aistudio.oxylabs.io/) como um dos backends disponíveis, chamando diretamente a API REST do AI Studio (sem SDK do fornecedor) para fornecer ao agente:

* Resultados de busca na web classificados – título, URL, descrição
* Dados limpos da página em Markdown, para pesquisa, comparações e raciocínio posterior
* Contexto web atualizado para respostas mais precisas

## Requisitos

* [Hermes Agent](https://github.com/NousResearch/hermes-agent) instalado com `hermes` CLI
* Oxylabs AI Studio [chave de API](https://aistudio.oxylabs.io/api-key) (AI Studio usa uma única chave de API, sem nome de usuário/senha separados)

## Configuração

{% stepper %}
{% step %}

### Instale o plugin

Registre Oxylabs como um provedor web que o Hermes pode usar para busca e extração:

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

{% endstep %}

{% step %}

### Defina sua chave de API

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

Ou adicione-a ao Hermes `.env` arquivo em vez da configuração do seu shell:

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

{% endstep %}

{% step %}

### Escolha a implementação

Defina Oxylabs como o backend para **busca**, **extração**, ou **ambos**.

#### **Busca na Web**

```bash
hermes config set web.search_backend oxylabs
```

Para consultas que solicitam 10 resultados ou menos, o plugin chama a API do AI Studio `/search/instant` endpoint e retorna os resultados inline. Para conjuntos de resultados maiores, ele envia para `/search/run` e faz polling até a conclusão.

{% hint style="info" %}
**Busca** retorna apenas listagens (título, URL, descrição), o conteúdo da página é obtido separadamente por meio de [extração](#web-extraction).
{% endhint %}

#### **Extração na Web**

```bash
hermes config set web.extract_backend oxylabs
```

Cada URL é enviada para a API do AI Studio `/scrape` endpoint e é consultada até ser concluída (até 60 segundos por URL).

Um lote de URLs é processado simultaneamente; a falha em uma URL não bloqueia o lote e retorna com um `erro` campo em vez de conteúdo.

#### Busca + Extração (backend completo)

Se você quiser que Oxylabs trate ambos **busca** e **extração**, defina a `backend` em vez das duas acima:

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

{% endstep %}

{% step %}

### Reinicie o Hermes

As alterações de backend e da chave de API só são lidas no início da sessão. Inicie uma nova sessão ou reinicie a atual:

```bash
hermes restart
```

{% endstep %}

{% step %}

### Verifique

Execute uma tarefa que precise de contexto web atual (por exemplo, uma solicitação para ler uma URL específica). Se a resposta incluir resultados de busca ou conteúdo da página, a integração foi bem-sucedida.

Se `OXYLABS_API_KEY não está configurado` um erro for retornado, a chave não foi detectada. Volte para [Etapa 2](#set-your-api-key), e depois reinicie novamente.

{% hint style="info" %}
Depois que Oxylabs for selecionado como `backend`, uma chave ausente retorna apenas um erro em vez de fazer fallback para outro provedor.
{% endhint %}
{% endstep %}
{% endstepper %}

### Substituição do endpoint (opcional)

Hermes `web_extract` ferramenta oferece suporte à substituição da URL base da API por meio do seguinte:

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

Usado para testes ou configurações auto-hospedadas. Padrão: `https://api-aistudio.oxylabs.io`.

{% hint style="info" %}
Mais recursos avançados são compatíveis com Oxylabs AI Studio (`format`, `render_javascript`, `geo_location`) que atualmente não têm suporte pelo dispatcher do Hermes e podem estar disponíveis em uma data posterior.
{% endhint %}

## Mais recursos

Veja nosso [repositório no GitHub](https://github.com/oxylabs/hermes-web-oxylabs) para ver todas as referências de 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/pt-br/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.