一、产品简介
WorkBuddy 是腾讯出品的 AI Agent 办公新范式产品，主打「说出要求、开始执行任务、交付完整成果」——区别于传统对话式 AI 只给建议、只出文字回复，WorkBuddy 能理解自然语言指令，自主拆解任务、规划步骤并执行操作，支持文档、表格、PPT、数据分析等多模态任务处理，还能读取授权的本地文件夹进行批量处理，直接交付可验收的成果（文档生成、PPT 设计、日常编码辅助、数据分析等）。 WorkBuddy 内置了混元、GLM、MiniMax、Kimi、DeepSeek 等主流模型（通过腾讯云 Token Plan 提供），同时也支持在「模型配置」中自行接入任意第三方大模型作为调用底座。通过对接 GravitexAI，您可以获得：二、环境要求
- Windows 10 及以上，不支持 Windows 7/8/8.1
- macOS 12 (Monterey) 及以上
三、前置条件
- 在你的机器上已安装 WorkBuddy
- 已在 GravitexAI 控制台 创建 API Key（格式
sk-xxxxxxxxxx）
四、快速开始
第一步：安装 WorkBuddy
WorkBuddy 目前提供 Windows / macOS 桌面客户端，从官网下载安装包后双击安装即可，无需命令行操作：
安装完成后打开 WorkBuddy，登录账号即可在「新建任务栏」直接用一句话下达任务，或按官方《快速开始》/《开启你的第一个任务》引导熟悉基本操作。
第二步：获取 GravitexAI API Key
- 访问 GravitexAI 控制台
- 点击「新建令牌」，命名并保存
- 复制以
sk-开头的密钥备用
第三步：在 WorkBuddy 中打开「自定义模型」入口
在 WorkBuddy 中左下角点击个人头像 → 设置 → 模型，点击「添加模型」，按下表填写：
第四步：「高级配置」说明
选择腾讯云 Token Plan 等标准供应商时，工具调用 / 图片输入等能力标记会自动写入；但选择自定义 / Custom 接入 GravitexAI 时不会自动识别，需要根据所选模型的实际能力手动勾选：- 请以你所填模型 ID 的真实能力为准逐项勾选，不确定时建议宁可少勾、不要多勾——如上图
claude-sonnet-4-6示例仅勾选了工具调用 - 确认所用模型确实支持图片输入，或具备推理增强能力后，再补勾图片输入 / 思考模式
- 勾选与模型实际能力不符（如给不支持工具调用的模型勾选工具调用）可能导致调用报错，请按需勾选
第五步：「输入/输出」说明
「输入/输出」两个区域用于设置上下文长度与最大输出 tokens，留空即为「使用提供商默认值」，也可手动点选 32K/64K/128K/256K（输入）、8K/16K/32K/64K（输出）等挡位。填写完成后点击「保存」，回到对话界面即可在模型选择器的自定义分组中看到并使用该模型。- WorkBuddy 的模型配置弹窗仅支持 OpenAI 兼容协议 API（弹窗顶部会标注「仅支持 OpenAI 兼容协议 API」）。
- GravitexAI 提供标准的 OpenAI 兼容 API，选择「自定义 / Custom」供应商即可接入，一次拿到全模型矩阵（GPT / Claude / Gemini / DeepSeek / 智谱 / Kimi 等）。
第六步：切换模型使用
回到编辑器，点击模型下拉框，刚才添加的模型都会出现在列表里，选中即可开始对话。五、常用功能速查
六、常见问题
接入 GravitexAI 后，我的 API Key 会不会被上传到 WorkBuddy 云端？
接入 GravitexAI 后，我的 API Key 会不会被上传到 WorkBuddy 云端？
不会。官方文档明确说明模型配置参数（含 API Key）仅保存在本地
workbuddy/models.json 中，不上传云端。使用时 WorkBuddy 仅作为通信链路，将输入转发至你配置的 GravitexAI 接口，输出由该模型直接返回；除必要传输、安全审计、故障排查、依法留存所必需外，WorkBuddy 不读取、不存储对话内容。通过 GravitexAI 调用模型产生的费用怎么计算？是否会消耗 WorkBuddy 的积分/套餐？
通过 GravitexAI 调用模型产生的费用怎么计算？是否会消耗 WorkBuddy 的积分/套餐？
不会消耗 WorkBuddy 自身的积分或套餐额度。自定义模型产生的全部费用（Token 消耗、订阅费用等）由您直接向 GravitexAI 结算，请自行关注 GravitexAI 账户中的余额与用量，避免产生超出预期的支出。
是否支持 Anthropic 原生协议（anthropic_messages）接入？
是否支持 Anthropic 原生协议（anthropic_messages）接入？
目前 WorkBuddy 的自定义模型配置弹窗仅支持 OpenAI 兼容协议 API（弹窗顶部有明确标注）。因此接入 GravitexAI 时请使用其 OpenAI 兼容端点
https://api.gravitex.ai/v1/chat/completions，暂不支持 Anthropic 原生协议端点。工具调用 / 图片输入 / 思考模式这几个能力标记该怎么勾选？
工具调用 / 图片输入 / 思考模式这几个能力标记该怎么勾选？
选择腾讯云 Token Plan 等标准供应商时这些标记会自动写入；但选择「自定义 / Custom」接入 GravitexAI 时不会自动识别，需要根据你填写的模型 ID 的实际能力手动勾选，不确定时建议宁可少勾、不要多勾。例如上方截图中的
claude-sonnet-4-6 只勾选了工具调用；如果你确认所用模型也支持图片输入或具备推理增强能力，再补勾对应选项。勾选与模型实际能力不符可能导致调用报错。模型名称一栏应该填什么？
模型名称一栏应该填什么？
填入 GravitexAI 文档中对应的模型 ID 即可，例如
claude-sonnet-5、gpt-5.5、deepseek-v4-pro、gemini-3.6-flash、kimi-k3 等，以 GravitexAI 模型广场 公布的 ID 为准。切换模型只需回到设置中修改该字段并保存，无需重新配置接口地址和 API Key。请求报 401 / 403 怎么排查？
请求报 401 / 403 怎么排查？
- 确认 API 密钥以
sk-开头且没有粘多余空格 - 确认接口地址拼写正确，特别是末尾路径（
/v1/chat/completions） - 在 GravitexAI 控制台 检查令牌是否启用、余额是否充足
- 余额不足也会返回 401，确认账户余额
七、相关资源
- WorkBuddy 官网：www.workbuddy.cn
- 官方文档首页：www.workbuddy.cn/docs/workbuddy/Overview
- 模型配置官方文档：Function-Description/Model
- Windows / Mac 安装指南：Windows 安装 / Mac 安装
- 密钥管理：https://maas.gravitex.ai/#/api-keys
- 模型广场：https://maas.gravitex.ai/#/api-models