工具接入
WorkBuddy 配置九维 AI:自定义模型接入教程
按 WorkBuddy 官方模型配置说明,设置自定义 API、九维 AI 密钥与模型 ID,并用短任务验证聊天及工具能力。
适用范围与准备#
本教程针对腾讯 WorkBuddy 的自定义模型接入,官方资料核对日期为 2026-10-10。界面能力与按钮名称可能随版本更新。接入后请按本文步骤验证当前工具与所选模型的配合情况。
先准备九维 AI API Key、账户可用的文本模型 ID和可用余额。WorkBuddy 内置模型或订阅额度与本站钱包是不同的服务,不能相互替代。
打开自定义模型配置#
在 WorkBuddy 中进入“头像 → 系统设置 → 模型”,找到添加自定义模型的入口。优先使用当前版本的图形界面;如果没有此入口,先检查版本与官方文档,不要盲目覆盖本地配置文件。
选择可填写自定义地址的 API 提供商选项。连接九维 AI 时,应使用本站密钥和地址,不要直接把密钥填入某个供应商的默认官网地址。
填写本站连接信息#
| 配置项 | 九维 AI 对应值 |
|---|---|
| 模型名称 | 自定义备注,例如“九维 AI 写作” |
| 模型 ID | 从账户模型中心复制的精确模型 ID |
| API Key | 你的本站完整密钥 |
| Base URL(若要求基础地址) | https://9weisc.cn/v1 |
| URL(若要求完整接口地址) | https://9weisc.cn/v1/chat/completions |
选择 Custom 提供商。默认关闭“自定义协议”时,工具会将地址规范为以 /chat/completions 结尾,基础地址应包含 /v1;打开该开关时,请填写完整的 https://9weisc.cn/v1/chat/completions,工具直接使用该地址。这个开关只控制地址处理,不会转换 API 协议。
保存后查看实际请求路径;正确 Chat Completions 请求应只出现一次 /v1/chat/completions。
图像输入、工具调用和思考模式等能力必须与所选模型及协议一致。不要为了显示更多开关,把未验证的能力全部标记为支持。
在聊天中选择新模型并测试#
保存配置后,在聊天模型选择器中明确选择刚添加的自定义模型。第一次接入不要依靠自动模式判断是否用了这条线路。
请将下面的会议要点整理为三个行动项:
本周核对销售数据,周五前形成周报,下周一复盘执行结果。
每个行动项包含任务和时间;负责人未提供时写“待指定”。验证回复是否完成,并在九维 AI 的用量明细里找到对应请求。只保存配置或成功读取模型列表,不能证明真实生成已经通过。
聊天成功后再验证工具任务#
普通对话成功与 Agent 工具执行成功是两件事。如果要让 WorkBuddy 读取文件、执行工具或处理多步骤任务,先选择支持相应能力的模型,再用一个小范围任务测试。
出现工具格式错误、图像不识别或推理字段不兼容时,记录工具版本、模型 ID 与错误码,检查能力配置后再扩大任务范围。
配置失败时的检查顺序#
先确认同一把密钥能完成最小 API 请求,再检查 WorkBuddy 地址、模型 ID 与协议。401 检查密钥,403 检查资源分配和密钥白名单,404 检查重复路径,429/503 按提示等待后重试。
官方资料#
腾讯云 WorkBuddy 模型配置说明;WorkBuddy 官方模型说明。本页的本站地址、权限、账单和验证步骤以九维 AI 实现为准;WorkBuddy 的具体界面以官方版本为准。
准备好开始了吗?
在控制台选择账户可用模型,先用一条简单请求验证配置。