在 WorkBuddy 接入 Agnes AI 大模型全攻略:免费生图、生视频、本地语音转写
最近想接入一款新的 AI 模型到 WorkBuddy,用于日常办公中的文本对话、图片生成和视频制作。筛选后发现 Agnes AI 的平台完全免费(推广期),且支持 OpenAI 兼容端点,非常适合作为 WorkBuddy 的自定义模型接入。
Agnes AI 是国内 AI 公司,定位"全球 Top 10 AI 实验室",目前已接入三款模型:
模型 | 类型 | 用途 | 是否免费 |
|---|---|---|---|
agnes-2.5-flash | 文本对话 | 聊天、推理、工具调用 | 免费 |
agnes-image-2.1-flash | 图片生成 | 文生图、图生图 | 免费 |
agnes-video-v2.0 | 视频生成 | 文生视频、图生视频、关键帧动画 | 免费 |
一、注册并获取 API Key
访问 https://platform.agnes-ai.com 注册账号,在控制台创建 API Key,复制 Key(格式为 sk-xxxxxxxxxxxxxxxxxxxxxxxx)。当前推广期所有模型均免费,后续是否收费请以官方公告为准。
二、配置文本模型(models.json)
在 C:Users<用户名>.workbuddymodels.json 中添加以下条目:
json
代码语言:javascript复制{"id": "agnes-2.5-flash","name": "Agnes 2.5 Flash","vendor": "Custom","url": "https://api.agnes-ai.cn/v1","apiKey": "sk-你的API Key","supportsToolCall": true,"supportsImages": true,"supportsReasoning": true,"useCustomProtocol": false}
三、配置 MCP 图片/视频连接器
1. 创建虚拟环境并安装依赖
bash
代码语言:javascript复制"C:/Users/gu_an/.workbuddy/binaries/python/versions/3.13.12/python.exe" -m venv "C:/Users/gu_an/.workbuddy/binaries/python/envs/agnes""C:/Users/gu_an/.workbuddy/binaries/python/envs/agnes/Scripts/pip.exe" install "agnes-mcp==0.3.1""C:/Users/gu_an/.workbuddy/binaries/python/envs/agnes/Scripts/pip.exe" install "mcp<2.0.0"
2. 配置 MCP 服务(mcp.json)
json
代码语言:javascript复制{"mcpServers": {"agnes": {"command": "C:Usersgu_an.workbuddybinariespythonenvsagnesScriptspython.exe","args": ["-m", "agnes_mcp"],"env": {"AGNES_API_KEY": "sk-你的API Key"}}}}
3. 激活服务
在 WorkBuddy 右上角「连接器管理」页面,找到 agnes 条目,点击「信任」完成激活。
四、追加图片与视频模型(models.json)
图片模型:
json
代码语言:javascript复制{"id": "agnes-image-2.1-flash","name": "Agnes Image 2.1 Flash","vendor": "Custom","url": "https://api.agnes-ai.cn/v1","apiKey": "sk-你的API Key","supportsToolCall": false,"supportsImages": true,"supportsReasoning": false,"useCustomProtocol": false}
视频模型:
json
代码语言:javascript复制{"id": "agnes-video-v2.0","name": "Agnes Video V2.0","vendor": "Custom","url": "https://api.agnes-ai.cn/v1","apiKey": "sk-你的API Key","supportsToolCall": false,"supportsImages": false,"supportsReasoning": false,"useCustomProtocol": false}
五、功能验证
文本对话
重启 WorkBuddy 后,切换到 Agnes 2.5 Flash 模型即可对话。
图片生成(API 直接调用)
bash
代码语言:javascript复制curl -X POST "https://api.agnes-ai.cn/v1/images/generations" -H "Authorization: Bearer sk-你的API Key" -H "Content-Type: application/json" -d '{"model": "agnes-image-2.1-flash","prompt": "一只可爱的小猫咪,毛茸茸的,大眼睛,温柔的表情","size": "1024x768","n": 1}'
视频生成
通过 MCP 工具 text_to_video 调用,输入描述即可生成短视频。
六、本地离线语音转写(零积分消耗)
bash
代码语言:javascript复制"C:/Users/gu_an/.workbuddy/binaries/python/envs/default/Scripts/python.exe" -m pip install openai-whisper --no-cache-dir
首次使用自动下载 turbo 模型(约 1.6GB),缓存于 C:Users<用户名>.cachewhisperlarge-v3-turbo.pt。
使用示例:
bash
代码语言:javascript复制# 中文音频转文字whisper audio.mp3 --model turbo --language zh --output_format txt --output_dir .# 生成 SRT 字幕whisper audio.m4a --model turbo --language zh --output_format srt --output_dir .
语音转写完全不消耗 WorkBuddy 积分,本地离线运行。
七、踩坑总结
问题 | 原因 | 解决方案 |
|---|---|---|
503 "No available channel for model agnes-ai" | id字段填了不存在的模型名 | 用GET /v1/models查实际可用模型名 |
mcp.server.fastmcp找不到 | mcpv2.0.0 重构路径 | 降级至mcp<2.0.0 |
MCP 配置不生效 | 误写入.mcp.json而非mcp.json | 写入无点前缀的mcp.json |
whisper安装后ffmpeg不可用 | Windows winget 安装失败 | 用imageio-ffmpeg获取捆绑二进制 |
八、总结
通过上述配置,在 WorkBuddy 中实现了:
文本对话:agnes-2.5-flash,免费调用图片生成:agnes-image-2.1-flash,免费调用视频生成:agnes-video-v2.0,免费调用语音转写:whisper turbo,本地离线,零积分消耗四项能力全部免费或零成本,适合日常办公高频使用。
-
08.04
玩家晚玩到五年 《最后生还者2》被删的举手投降机制
-
08.04
〈最后生还者2〉被弃窥视模式曝光 掩体观察机制背后的设计遗珠
-
08.04
崩坏因缘精灵柯哒基如何 崩坏因缘精灵柯哒基操作步骤解析
-
08.04
【AI大模型】【赋能】广告匹配
-
08.04
Next.js 16.3 发布:开发内存最高降 90%,Agent 原生 DX 来了
-
08.04
AI 进化的秘密,在模型还是在harness
-
-
下载
- |
-
-
下载
- 《行尸走肉第一章》免安装中文汉化硬盘版下载
- 单机|436 MB
- 一款以动作冒险为主题的游戏
-
-
下载
- 《街头霸王X铁拳》免安装中文汉化硬盘版下载
- 单机|111MB
- 一款非常好玩的格斗游戏
-
-
下载
- |
-
-
下载
- 《暗黑破坏神3》免安装繁体中文正式版下载
- 单机|7630 MB
- 一款以角色扮演为主题的游戏
-
-
下载
- 《马克思佩恩3》免安装硬盘版下载
- 单机|27033 MB
- 一款以第三人称射击为主题的游戏