Import AITURK IDE 1.0.0-beta.1 from Hermes 63279301; preserve MIT license
This commit is contained in:
+187
@@ -0,0 +1,187 @@
|
||||
---
|
||||
title: "Nous Tool Gateway（工具网关）"
|
||||
description: "通过 Nous 订阅统一使用网页搜索、文生图、语音合成与浏览器自动化，无需单独申请 Firecrawl、FAL、OpenAI、Browser Use 等 API Key"
|
||||
sidebar_label: "Tool Gateway"
|
||||
sidebar_position: 2
|
||||
---
|
||||
|
||||
# Nous Tool Gateway（工具网关）
|
||||
|
||||
:::tip 快速开始
|
||||
Tool Gateway 包含在付费 Nous Portal 订阅中。**[管理订阅 →](https://portal.nousresearch.com/manage-subscription)**
|
||||
:::
|
||||
|
||||
**Tool Gateway** 让已付费的 [Nous Portal](https://portal.nousresearch.com) 用户通过同一份订阅，直接使用网页搜索、文生图、语音合成（TTS）与浏览器自动化，而**不必**再分别注册 Firecrawl、FAL、OpenAI、Browser Use 等服务的 API Key。
|
||||
|
||||
## 包含能力
|
||||
|
||||
| 工具 | 作用 | 若不用网关，可改用 |
|
||||
|------|------|---------------------|
|
||||
| **网页搜索与抓取** | 通过 Firecrawl 搜索并抽取页面内容 | `FIRECRAWL_API_KEY`、`EXA_API_KEY`、`PARALLEL_API_KEY`、`TAVILY_API_KEY` |
|
||||
| **文生图** | 通过 FAL 生成图像（8 个模型：FLUX 2 Klein/Pro、GPT-Image、Nano Banana Pro、Ideogram、Recraft V4 Pro、Qwen、Z-Image） | `FAL_KEY` |
|
||||
| **语音合成** | 通过 OpenAI TTS 将文字转为语音 | `VOICE_TOOLS_OPENAI_KEY`、`ELEVENLABS_API_KEY` |
|
||||
| **浏览器自动化** | 通过 Browser Use 控制云端浏览器 | `BROWSER_USE_API_KEY`、`BROWSERBASE_API_KEY` |
|
||||
|
||||
上述四类能力均计入 Nous 订阅计费。你可以按需组合——例如网页与文生图走网关，TTS 仍使用自己的 ElevenLabs Key。
|
||||
|
||||
## 资格与账号
|
||||
|
||||
Tool Gateway 仅对 **[付费](https://portal.nousresearch.com/manage-subscription)** Nous Portal 订阅开放；免费档不可用——请 [升级订阅](https://portal.nousresearch.com/manage-subscription) 后解锁。
|
||||
|
||||
检查当前状态：
|
||||
|
||||
```bash
|
||||
hermes status
|
||||
```
|
||||
|
||||
在输出中找到 **Nous Tool Gateway** 小节：会标明哪些工具经订阅网关启用、哪些使用直连 Key、哪些尚未配置。
|
||||
|
||||
## 如何启用 Tool Gateway
|
||||
|
||||
### 在模型配置流程中
|
||||
|
||||
运行 `hermes model` 并选择 Nous Portal 作为提供商时，Hermes 会主动询问是否启用 Tool Gateway：
|
||||
|
||||
```
|
||||
Your Nous subscription includes the Tool Gateway.
|
||||
|
||||
The Tool Gateway gives you access to web search, image generation,
|
||||
text-to-speech, and browser automation through your Nous subscription.
|
||||
No need to sign up for separate API keys — just pick the tools you want.
|
||||
|
||||
○ Web search & extract (Firecrawl) — not configured
|
||||
○ Image generation (FAL) — not configured
|
||||
○ Text-to-speech (OpenAI TTS) — not configured
|
||||
○ Browser automation (Browser Use) — not configured
|
||||
|
||||
● Enable Tool Gateway
|
||||
○ Skip
|
||||
```
|
||||
|
||||
选择 **Enable Tool Gateway** 即可。
|
||||
|
||||
若 `.env` 中已有部分直连 API Key，提示会相应变化：可为全部工具启用网关（直连 Key 仍保留在 `.env` 但运行时不用）、仅为未配置项启用，或完全跳过。
|
||||
|
||||
### 通过 `hermes tools`
|
||||
|
||||
也可在交互式工具配置中逐项启用：
|
||||
|
||||
```bash
|
||||
hermes tools
|
||||
```
|
||||
|
||||
选择工具类别（Web、Browser、Image Generation、TTS），再将提供商选为 **Nous Subscription**。这会把该类别的选择键写为 `nous`（例如 `image_gen.provider: nous`）。
|
||||
|
||||
### 手动编辑配置
|
||||
|
||||
每个工具类别只有一个选择键，选 **Nous Subscription** 即写入 `nous`：
|
||||
|
||||
```yaml
|
||||
web:
|
||||
backend: nous # 网页搜索/抓取走 Tool Gateway
|
||||
|
||||
image_gen:
|
||||
provider: nous
|
||||
|
||||
tts:
|
||||
provider: nous
|
||||
|
||||
stt:
|
||||
provider: nous
|
||||
|
||||
browser:
|
||||
cloud_provider: nous
|
||||
```
|
||||
|
||||
## 工作原理
|
||||
|
||||
当某工具类别的选择键为 `nous` 时，运行时会把 API 调用路由到 Nous Tool Gateway，而不是使用直连 Key：
|
||||
|
||||
1. **网页工具** — `web_search` / `web_extract` 走网关的 Firecrawl 端点
|
||||
2. **文生图** — `image_generate` 走网关的 FAL 端点
|
||||
3. **TTS** — `text_to_speech` 走网关的 OpenAI Audio 端点
|
||||
4. **浏览器** — `browser_navigate` 等走网关的 Browser Use 端点
|
||||
|
||||
网关使用 Nous Portal 凭据认证（在 `hermes model` 完成后写入 `~/.hermes/auth.json`）。
|
||||
|
||||
### 优先级
|
||||
|
||||
运行时**始终使用已保存的选择**，凭据是否存在不会影响路由：
|
||||
|
||||
- **选择为 `nous`** → 走网关，即使 `.env` 里仍有直连 Key（例如 `FAL_KEY` 会被忽略）
|
||||
- **选择为具体厂商**（如 `fal`、`firecrawl`）→ 直连；若对应 Key 缺失则报错并提示运行 `hermes tools`，**不会**静默回退到网关
|
||||
- **从未配置过的类别** → 按可用凭据自动检测（行为不变）；但一旦存在选择，仅往 `.env` 加 Key 不会改变路由
|
||||
|
||||
（旧版的 `use_gateway` 布尔键已废弃：不再写入，读取时 `use_gateway: true` 等同于 `nous`。请改用 `hermes tools` 选择提供商。）
|
||||
|
||||
## 切回直连 Key
|
||||
|
||||
对单个工具停用网关：
|
||||
|
||||
```bash
|
||||
hermes tools # 选择该工具 → 选直连提供商
|
||||
```
|
||||
|
||||
或在配置中把选择键改回具体厂商：
|
||||
|
||||
```yaml
|
||||
web:
|
||||
backend: firecrawl # 此时使用 .env 中的 FIRECRAWL_API_KEY
|
||||
```
|
||||
|
||||
在 `hermes tools` 中选择非网关提供商时，选择键会被改写为该厂商名（旧的 `use_gateway` 键若存在会被一并移除），避免配置自相矛盾。
|
||||
|
||||
## 查看状态
|
||||
|
||||
```bash
|
||||
hermes status
|
||||
```
|
||||
|
||||
**Nous Tool Gateway** 小节示例：
|
||||
|
||||
```
|
||||
◆ Nous Tool Gateway
|
||||
Nous Portal ✓ managed tools available
|
||||
Web tools ✓ active via Nous subscription
|
||||
Image gen ✓ active via Nous subscription
|
||||
TTS ✓ active via Nous subscription
|
||||
Browser ○ active via Browser Use key
|
||||
Modal ○ available via subscription (optional)
|
||||
```
|
||||
|
||||
标记为 “active via Nous subscription” 的即经网关路由；带自有 Key 的会显示当前激活的提供商。
|
||||
|
||||
## 进阶：自建网关
|
||||
|
||||
若使用自建或自定义网关，可在 `~/.hermes/.env` 中用环境变量覆盖端点：
|
||||
|
||||
```bash
|
||||
TOOL_GATEWAY_DOMAIN=nousresearch.com # 网关路由基础域名
|
||||
TOOL_GATEWAY_SCHEME=https # http 或 https（默认 https）
|
||||
TOOL_GATEWAY_USER_TOKEN=your-token # 鉴权 Token（通常由程序自动填充）
|
||||
FIRECRAWL_GATEWAY_URL=https://... # 单独覆盖 Firecrawl 端点
|
||||
```
|
||||
|
||||
这些变量与订阅状态无关，始终可在配置中看到，便于自建基础设施。
|
||||
|
||||
## 常见问题
|
||||
|
||||
### 需要删掉已有的 API Key 吗？
|
||||
|
||||
不需要。类别选择为 **Nous Subscription**（`nous`）时，运行时会忽略该类别的直连 Key；Key 仍保留在 `.env`。之后在 `hermes tools` 里改回直连提供商，Key 即恢复生效。
|
||||
|
||||
### 能否部分工具走网关、部分走直连？
|
||||
|
||||
可以。选择按工具类别独立配置。例如：网页与文生图选 Nous Subscription，TTS 用 ElevenLabs，浏览器用 Browserbase。
|
||||
|
||||
### 订阅到期会怎样？
|
||||
|
||||
经网关路由的工具会停止工作，直到你 [续订](https://portal.nousresearch.com/manage-subscription) 或通过 `hermes tools` 改回直连 Key。
|
||||
|
||||
### 与「消息网关」（各聊天平台）是否冲突？
|
||||
|
||||
不冲突。Tool Gateway 作用于**工具运行时**的 API 路由，与 CLI、Telegram、Discord 等入口无关。
|
||||
|
||||
### Modal 算在 Tool Gateway 里吗？
|
||||
|
||||
Modal（无服务器终端后端）可作为 Nous 订阅的可选附加能力，但**不会**由 Tool Gateway 安装向导一并打开——请单独通过 `hermes setup terminal` 或在 `config.yaml` 中配置。
|
||||
Reference in New Issue
Block a user