跳到正文
九维AI开放平台使用文档

工具接入

WorkBuddy 配置九维 AI:自定义模型接入教程

按 WorkBuddy 官方模型配置说明,设置自定义 API、九维 AI 密钥与模型 ID,并用短任务验证聊天及工具能力。

成都九维数创科技有限公司 · 文档团队更新于 约 6 分钟阅读
本页目录
  1. 适用范围与准备
  2. 打开自定义模型配置
  3. 填写本站连接信息
  4. 在聊天中选择新模型并测试
  5. 聊天成功后再验证工具任务
  6. 配置失败时的检查顺序
  7. 官方资料

适用范围与准备#

本教程针对腾讯 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。

图像输入、工具调用和思考模式等能力必须与所选模型及协议一致。不要为了显示更多开关,把未验证的能力全部标记为支持。

在聊天中选择新模型并测试#

保存配置后,在聊天模型选择器中明确选择刚添加的自定义模型。第一次接入不要依靠自动模式判断是否用了这条线路。

text
请将下面的会议要点整理为三个行动项:
本周核对销售数据,周五前形成周报,下周一复盘执行结果。
每个行动项包含任务和时间;负责人未提供时写“待指定”。

验证回复是否完成,并在九维 AI 的用量明细里找到对应请求。只保存配置或成功读取模型列表,不能证明真实生成已经通过。

聊天成功后再验证工具任务#

普通对话成功与 Agent 工具执行成功是两件事。如果要让 WorkBuddy 读取文件、执行工具或处理多步骤任务,先选择支持相应能力的模型,再用一个小范围任务测试。

出现工具格式错误、图像不识别或推理字段不兼容时,记录工具版本、模型 ID 与错误码,检查能力配置后再扩大任务范围。

配置失败时的检查顺序#

先确认同一把密钥能完成最小 API 请求,再检查 WorkBuddy 地址、模型 ID 与协议。401 检查密钥,403 检查资源分配和密钥白名单,404 检查重复路径,429/503 按提示等待后重试。

官方资料#

腾讯云 WorkBuddy 模型配置说明;WorkBuddy 官方模型说明。本页的本站地址、权限、账单和验证步骤以九维 AI 实现为准;WorkBuddy 的具体界面以官方版本为准。

准备好开始了吗?

在控制台选择账户可用模型,先用一条简单请求验证配置。

打开 Playground