‘
<img src="./wp-content/uploads/2026/08/image-1c12b00e915bbbb79bf9aa9c16c5515f-1.jpg" alt="零消耗！把免费模型Agnes接入WorkBuddy" />

                                                        <div class=\"rich_media_content js_underline_content
                   autoTypeSetting24psection
        \" id=\"js_content\"><section style=\"color: #1f2937;font-family: -apple-system, BlinkMacSystemFont, &quot;PingFang SC&quot;, &quot;Microsoft YaHei&quot;, &quot;Helvetica Neue&quot;, Arial, sans-serif;font-size: medium;font-style: normal;font-variant-ligatures: normal;font-variant-caps: normal;font-weight: 400;letter-spacing: normal;orphans: 2;text-align: start;text-indent: 0px;text-transform: none;widows: 2;word-spacing: 0px;white-space: normal;text-decoration-style: initial;text-decoration-color: initial;background-color: #4f46e5;padding: 34px 30px 30px\" data-pm-slice=\"0 0 []\">

WORKBUDDY · 模型接入指南

把免费模型 Agnes 接进 WorkBuddy

一步步跟着点就会做 · 日常轻量任务可交由该模型处理

**你要做两件事：**

① 配一个文本模型（填 3 个参数），聊天直接用它；

②（可选）让 WorkBuddy 自动建图像/视频 Skill。

Agnes 兼容 OpenAI 接口，官方原话："通常只需要修改 Base URL、API Key、模型名称"。

## 一、Agnes 是什么，接它能干嘛

Agnes 由相应模型服务商运营，主打"简单、稳定"，接口兼容 OpenAI 格式，接入成本较低。它提供统一的多模态模型服务：

能力	你能拿它做什么（结合咱们培训）
文本生成与推理	聊天、写稿、摘要、代码、Agent —— 对应 prompt 模板、周报、政策快报
图像生成与编辑	文生图、产品图、创意海报 —— 对应培训里的生图需求
视频与音视频生成	图生视频、短视频素材、角色动画
多模态理解	图文视频混合的创意工作流

## 二、开始前，先备好这 3 样

准备项	说明	没准备好会怎样
① 装好 WB	本机已安装并能正常打开	没它无从配置
② Agnes Key	去平台注册并创建（下一节教）	没 Key 接不通
③ 能访问网关	能打开 apihub.agnes-ai.com	网络不通会一直报错

💡 测网络：浏览器开 https://apihub.agnes-ai.com/v1，返回 404/JSON 错误都算通，打不开才是真不通。

三、第一步：拿到 API Key（最关键，别漏）

API Key 相当于账号密码，拿到才能调用模型。

操作步骤

<span style="display: inline-block;width: 22px;height: 22px;line-height: 22px;text-align: center;background-color: #4f46e5;color: #ffffff;border-radius: 50%;font-size: 12px;font-weight: 700;margin-right: 8px">1打开 <span style="font-family: monospace;background-color: #eef2ff;padding: 1px 6px;border-radius: 4px;color: #4f46e5">https://platform.agnes-ai.com/ 注册/登录。

<span style="display: inline-block;width: 22px;height: 22px;line-height: 22px;text-align: center;background-color: #4f46e5;color: #ffffff;border-radius: 50%;font-size: 12px;font-weight: 700;margin-right: 8px">2在控制台找到「API Key」管理页（侧边栏/个人中心）。

**🔐 安全红线：**API Key 是敏感信息，勿进公开代码仓库、前端代码、截图、公开文档、他人可访问的配置文件。**一旦泄露，立刻去控制台删除/重置该 Key。**

## 四、第二步：配置文本模型（核心，照着点）

步骤 1 · 打开自定义模型设置

在 WorkBuddy 聊天界面，点击输入框右下角的当前模型选择按钮（通常显示当前模型图标，如 <span style="font-family: monospace;background-color: #f1f5f9;padding: 1px 6px;border-radius: 4px">Hy3）。在弹出菜单里选 「添加模型」（或「编辑模型」/「配置自定义模型」，不同版本文案可能略有不同）。

步骤 2 · 选择自定义提供商

在「添加模型」弹窗中，点击「提供商」下拉列表，向下滚动到底部，选择 「自定义 / Custom」（表示用自定义 OpenAI 兼容 API 服务）。

步骤 3 · 添加 Agnes 文本模型

在「添加模型」弹窗中，点 Add Model，逐项填写（照抄）：

字段	填写值	注意
Provider	Custom	固定
API Base URL	https://apihub.agnes-ai.com/v1	必须含 /v1
API Key	YOUR_API_KEY	换成真实密钥
模型名称	agnes-2.0-flash	区分大小写

⚠️ 最易错：① Base URL 漏写 **/v1**；② 模型名写成 **Agnes-2.0-Flash** 大小写不对。

高级配置（按你的截图勾选，可正常运行）

• 建议勾选：工具调用、图片输入、思考模式、允许关闭思考。

• 无需勾选：仅思考模式、自定义协议。

• 默认思考强度：保持「自动（使用请求层默认值）」。

• 输入 / 输出：保持「使用提供商默认值」。

步骤 4 · 保存

确认无误点 Save，模型列表出现 agnes-2.0-flash。

步骤 5 · 切到这个模型

聊天界面点模型选择按钮，选中 agnes-2.0-flash，文本模型配完。

## 五、第三步：验证真的通了

新建对话，发送：

你好，请介绍一下你自己。

✅ 返回 Agnes 自我介绍 = 配置正确；❌ 报错/转圈 = 跳到「八、故障排查」。

命令行验证（标准 OpenAI 兼容格式，Agnes 同样适用）：

curl https://apihub.agnes-ai.com/v1/chat/completions

-H "Authorization: Bearer 你的API_KEY"

-H "Content-Type: application/json"

-d '{

"model": "agnes-2.0-flash",

"messages": [{"role":"user","content":"你好，请介绍一下你自己。"}]

## 六、第四步（可选）：自动建图像/视频 Skill

Agnes 图像/视频通过 Skills 调用。懒人法：让 WorkBuddy 自己读文档、自己建 Skill。

① 发这句话建 Skill：

我想使用 Agnes Image 2.0 模型生成图片和视频。请访问其 API 平台 https://agnes-ai.com/doc/overview 并将其打包为一个 Skill。

说明：官方用 https://agnes-ai.com/doc/overview，中文文档 /zh-Hans/docs/overview 也可。

② 用图像 Skill（示例名 agnes-image-gen）

生成一个赛博朋克城市夜景，霓虹灯光，电影风格，高细节。

③ 用视频 Skill（示例名 agnes-video-gen）

生成一个 5 秒的视频，内容是一位亚洲女模特在白色摄影棚中穿着黑色连衣裙。镜头从全身缓慢移动到半身特写，同时她自然转身。

视频生成较慢，请耐心等返回的任务状态/URL。

## 七、接好了，能用它做哪些培训里的活儿

把 agnes-2.0-flash 设为默认或按需切换，这些纯文本/轻量任务可走该模型处理：

写稿/摘要
：周报、月报、政策快报初稿（第四阶段可让 Agnes 定时跑）
代码/表格
：整理数据、写公式、做小工具
竞品/文献速读
：长文丢给它要摘要（医学敏感资料别传，见下）
生图/视频
：市场物料、培训配图、创意素材
💡 配合第四阶段「自动化篇」：把周报、政策快报等定时任务交给 Agnes 跑，可交由该模型定时处理。

八、故障排查（照表自查）

现象	可能原因	解决办法
文本不返回响应	URL错/Key无效	核对 /v1 与 Key 有效
列表没这模型	大小写错	从平台复制 agnes-2.0-flash
Skill 创建失败	文档URL不可达	确认能开 /doc/overview
视频很久没好	本就慢	正常等，查状态/URL
认证失败	Key错/余额不足	重填 Key；查余额积分

## 九、安全与合规红线

API Key 绝不外泄
：不进代码库、不截图、不写公开文档；泄露即重置。
敏感资料不上第三方模型
：涉及医学、患者、未公开经营数据的资料，不要传给 Agnes 等第三方；对外内容仍需人工复核、标注来源。
免费/积分额度以控制台为准
：免费层、速率限制、配额看账号控制台，批量任务注意节制。
模型各司其职
：文本用 agnes-2.0-flash；图像/视频走对应 Skill。

十、小结 + 速查卡

你已完成：✅ 拿 Key → ✅ 配文本模型（3 参数）→ ✅ 验证通 → ✅（可选）建图像/视频 Skill。
一句话：改 3 个参数 + 点几步，可免费额度内使用的多模态模型接进 WorkBuddy，轻量任务可走该模型处理。延伸：结合自动化篇让 Agnes 定时跑。

Base URL : https://apihub.agnes-ai.com/v1

API Key : 你的真实密钥（替换 YOUR_API_KEY）

模型名称 : agnes-2.0-flash

认证方式 : Authorization: Bearer 你的API_KEY

图像Skill: agnes-image-gen

视频Skill: agnes-video-gen

文档地址 : https://agnes-ai.com/doc/overview

— 本教程基于 Agnes 官方《概述》与《WorkBuddy 集成指南》，实测界面 WorkBuddy 5.x —

截止发稿，Agnes已推出“<span data-pm-slice="1 1 ["para",{"tagName":"section","attributes":{"style":"color: rgb(31, 41, 55); font-family: -apple-system, BlinkMacSystemFont, "PingFang SC", "Microsoft YaHei", "Helvetica Neue", Arial, sans-serif; font-size: medium; font-style: normal; font-variant-ligatures: normal; font-variant-caps: normal; font-weight: 400; letter-spacing: normal; orphans: 2; text-align: start; text-indent: 0px; text-transform: none; widows: 2; word-spacing: 0px; -webkit-text-stroke-width: 0px; white-space: normal; text-decoration-thickness: initial; text-decoration-style: initial; text-decoration-color: initial; padding: 26px 22px 34px;"},"namespaceURI":"http://www.w3.org/1999/xhtml"},"para",{"tagName":"section","attributes":{"style":"background-color: rgb(15, 23, 42); border-radius: 10px; padding: 14px 16px; margin: 0px 0px 6px; overflow-x: auto;"},"namespaceURI":"http://www.w3.org/1999/xhtml"},"para",{"tagName":"p","attributes":{"style":"white-space:pre-wrap;margin: 0px; font-family: monospace; font-size: 12px; color: rgb(226, 232, 240);"},"namespaceURI":"http://www.w3.org/1999/xhtml"}]\">agnes-2.5-flash”灰度测试，不久应该会全量开放