AIHelms Docs
WorkBuddy 接入
在 WorkBuddy 中添加 AIHelms 自定义模型。
准备信息
从 AIHelms 用户端取得 AI 身份 Key、Endpoint 和普通模型 ID。

添加模型
- 打开 WorkBuddy“设置”。
- 进入“模型”。
- 在自定义模型区域点击添加。
- 提供商选择“自定义 API”或“Custom”。
- 按下表填写并保存。

默认使用标准协议模式。不要把 URL 写成管理后台地址,也不要直接追加 /chat/completions。
验证
- 新建空白对话。
- 选择刚添加的 AIHelms 模型。
- 发送“只回复:WorkBuddy 连接成功”。
- 确认没有自动切换到其他模型。
- 如果需要文件、图片或工具能力,再分别执行对应测试。
常见问题
| 现象 | 处理方法 |
|---|---|
| 保存后连接失败 | 核对 Endpoint、Key 和模型 ID 是否来自同一环境 |
| 404 | URL 填到 /v1,关闭不必要的“自定义协议”开关 |
| 401 | 重新复制 AI 身份 Key,不要使用管理 API Key |
model not allowed | 联系管理员分配该模型 |
model not found | 使用普通模型 ID,不要填显示名称或 (Anthropic) 后缀 |
| 对话成功但工具失败 | 目标模型可能没有工具调用能力,联系管理员确认 |