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 é 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 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 instalado com hermes CLI
• Oxylabs AI Studio chave de API (AI Studio usa uma única chave de API, sem nome de usuário/senha separados)

Configuração

1

Instale o plugin

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

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

2

Defina sua chave de API

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

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

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

3

Escolha a implementação

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

Busca na Web

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.

Busca retorna apenas listagens (título, URL, descrição), o conteúdo da página é obtido separadamente por meio de extração.

Extração na Web

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:

web:
  backend: "oxylabs"

4

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:

hermes restart

5

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, e depois reinicie novamente.

Depois que Oxylabs for selecionado como backend, uma chave ausente retorna apenas um erro em vez de fazer fallback para outro provedor.

Substituição do endpoint (opcional)

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

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

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

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.

Mais recursos

Veja nosso repositório no GitHub para ver todas as referências de código.