零消耗！把免费模型Agnes接入WorkBuddy

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 相当于账号密码，拿到才能调用模型。

操作步骤

1打开 https://platform.agnes-ai.com/ 注册/登录。

2在控制台找到「API Key」管理页（侧边栏/个人中心）。

3点「创建 API Key」，系统生成一串密钥。

4立刻复制并贴到自己的记事本保存好。

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

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

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

在 WorkBuddy 聊天界面，点击输入框右下角的当前模型选择按钮（通常显示当前模型图标，如 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已推出“agnes-2.5-flash”灰度测试，不久应该会全量开放