接入 Agent 工具
DeepSeek Harness
DeepSeek Harness（简称 dsh）是 DeepSeek 开源的 Agent 运行时，用于搭建可工具调用、多轮对话与插件扩展的 AI Agent。通过官方插件 dsh-llm-autorouter，可将 Harness 的模型调用统一转发到 AutoRouter，由网关完成智能路由、渠道 failover、计费与可观测。本文介绍如何把 DeepSeek Harness 接入 AutoRouter。
- DeepSeek Harness：https://github.com/deepseek-ai/deepseek-harness
- 适配插件：https://github.com/autorouter0-ai/dsh-llm-autorouter
📦 接入前准备
准备信息
- 已安装并可用的 DeepSeek Harness 环境（建议 Web profile；已在
0.1.0-rc.5验证，Harness 仍为 Developer Preview） - 一个可用的 AutoRouter API Key（在控制台生成）
- 想使用的模型 ID（如
deepseek-v4-flash、gpt-5-nano等，需与 AutoRouter 控制台中的模型 ID 完全一致）
说明
- DeepSeek Harness 负责跑 Agent；AutoRouter 负责选模型、选渠道。
- 本插件在 Harness 中注册
autorouterprovider，聊天可用的模型来自「获取模型 → 导入选中模型」后的白名单，不会自动探测网关。
🔑 第一步：获取 API Key
- 进入 AutoRouter API 密钥页面，单击创建 API Key。操作详情请参见快速开始。
- 创建完成后，请您务必复制并妥善保管 API Key，后续会配置到 DeepSeek Harness 的 Plugins 页面。
🔌 第二步：安装 AutoRouter 适配插件
在已安装 dsh / @deepseek-ai/dsh 的环境中，将插件安装到 Web profile（推荐）：
npx @deepseek-ai/dsh plugin --profile web add dsh-llm-autorouter也可从 git 安装：
npx @deepseek-ai/dsh plugin --profile web add github:autorouter0-ai/dsh-llm-autoroutergit 安装会拉取源码并执行构建。若首次失败，按命令输出的 allowBuilds 提示操作即可。
⚙️ 第三步：在 Plugins 中配置 AutoRouter
-
启动 DeepSeek Harness Web，进入 Plugins 页面，找到 AutoRouter 卡片并展开。
-
填写连接信息，单击保存：
| 字段 | 填写说明 |
|---|---|
| 接口地址 | 网关 origin，不要带尾斜杠或 /v1。公有云默认可用：https://api.autorouter.top |
| API Key | 填入上一步创建的 AutoRouter API Key。密钥经 credentials 服务保存，不会写入 settings.yaml |
- 保存成功后，单击获取模型，从网关拉取可导入目录（按能力分组，如对话 / 图片生成等）。
- 勾选需要的模型（例如
deepseek-v4-flash），单击导入选中模型。导入后的模型才会出现在聊天模型选择器中。
🧭 第四步：在聊天中选择 AutoRouter 模型
在 Web 聊天界面的模型选择器中，直接选择已导入的 AutoRouter 模型进行验证。
✅ 第五步：验证接入
- 在 DeepSeek Harness 中发起一次对话或 Agent 任务。
- 确认能正常流式返回内容。
- （可选）在 AutoRouter 控制台查看该次请求的用量 / 路由记录，确认流量已进入网关。
收到正常响应即配置成功。此后，Harness 侧的模型调用会经 AutoRouter 转发，由网关完成智能路由与渠道治理。
❓ 常见问题
| 问题 | 解决方案 |
|---|---|
| 连接失败 / API Key 无效 | 检查接口地址是否为 https://api.autorouter.top（不要写成带 /v1/chat/completions 的完整路径），并确认 API Key 正确、已点击保存 |
| 获取模型失败 | 先保存接口地址与 API Key，再点「获取模型」；确认本机可访问网关 |
| 聊天里看不到模型 | 必须先「获取模型」并「导入选中模型」；聊天选择器只读已导入白名单 |
| 提示模型不存在 | 确认 agent 中的 model 与已导入的模型 ID、以及 AutoRouter 控制台中的模型 ID 完全一致 |
| 接口地址填错 | Harness 插件要填 origin（如 https://api.autorouter.top），不要填完整 Chat Completions URL |
| 环境变量锁定了 Key | 若启动环境已有 AUTOROUTER_API_KEY，Plugins 页可能无法改写；去掉该变量后重启 dsh web，或改用页面写入 |
| 无界面 / CLI profile | 设置环境变量 AUTOROUTER_API_KEY，或通过 credentials 服务写入密钥；模型白名单需在配置 / 导入流程中准备好 |