Agente Hermes

O AI Studio da Oxylabs permite que seu Agente Hermes realize buscas na web em tempo real e obtenha dados limpos, prontos para LLM, para usar contexto ao vivo e conteúdo estruturado de páginas como parte de seu fluxo de raciocínio.

Agente Hermes é um framework de agentes pluggá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 ranqueados – título, URL, descrição
• Dados de página limpos em Markdown, para pesquisa, comparações e raciocínio posterior
• Contexto web atualizado para respostas mais precisas

Requisitos

• Agente Hermes instalado com hermes CLI
• Oxylabs AI Studio chave de API (o 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-o 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 /search/instant endpoint e retorna os resultados inline. Para conjuntos de resultados maiores, ele envia para /search/run e consulta 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 da Web

hermes config set web.extract_backend oxylabs

Cada URL é enviada para a /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 o Oxylabs cuide de ambos busca e extração, defina a chave compartilhada 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

Verificar

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 estiver configurado erro for retornado, a chave não foi reconhecida. Volte para Etapa 2, 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 a 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 o Oxylabs AI Studio (format, render_javascript, geo_location) que atualmente não têm suporte pelo dispatcher do Hermes e podem ficar disponíveis em uma data posterior.

Mais recursos

Veja nosso repositório no GitHub para referências completas do código.