Hermes Agent

Oxylabs AI Studio 可让你的 Hermes Agent 拉取实时网页搜索结果和干净、可直接供 LLM 使用的数据，以便在推理工作流中使用实时上下文和结构化页面内容。

Hermes 代理 是一个可插拔的代理框架，通过可替换的后端集成网页搜索和提取。该 hermes-web-oxylabs 插件注册了 Oxylabs AI Studio 作为可用后端之一，直接调用 AI Studio 的 REST API（无需厂商 SDK）为代理提供：

要求

将 Oxylabs 注册为 Hermes 可用于搜索和提取的网页提供方：

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

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

或者将其添加到 Hermes .env 文件，而不是你的 shell 配置：

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

将 Oxylabs 设为搜索, 提取，或两者.

hermes config set web.search_backend oxylabs

对于请求 10 条或更少结果的查询，插件会调用 AI Studio 的 /search/instant 端点，并直接返回结果。对于更大的结果集，它会提交到 /search/run 并轮询直到完成。

搜索仅返回列表项（标题、URL、描述），页面内容通过提取.

hermes config set web.extract_backend oxylabs

每个 URL 都提交到 AI Studio 的 /scrape 端点，并轮询直到完成（每个 URL 最多 60 秒）。

一批 URL 并发处理，单个 URL 失败不会阻塞整批，并会返回一个 错误 字段而不是内容。

如果你希望 Oxylabs 同时处理搜索和提取，请设置共享 后端 键，而不是上面的两个：

web:
  backend: "oxylabs"

后端和 API key 的变更仅在会话开始时读取。启动新会话或重启当前会话：

hermes restart

运行一个需要当前网页上下文的任务（例如请求读取某个特定 URL）。如果响应包含搜索结果或页面内容，则集成成功。

如果 OXYLABS_API_KEY is not configured 返回错误，说明密钥未被加载。 返回到步骤 2，然后再重启一次。

一旦将 Oxylabs 选为 后端后端，缺失的密钥只会返回错误，而不会回退到其他提供商。

Hermes web_extract 工具支持通过以下方式覆盖 API 基础 URL：

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

用于测试或自托管部署。默认值： https://api-aistudio.oxylabs.io.

更多高级功能与 Oxylabs AI Studio （格式, render_javascript, geo_location）这些目前不受 Hermes 调度器支持，未来可能提供。