前言¶
在 Agent 裏做內容生產時,一個常見麻煩是:文案、配圖、視頻要分別對接不同供應商或平臺,接口風格不統一,鑑權和額度也要各管一套。Agnes AI 的做法是把文本、圖像、視頻生成放在一個 OpenAI 兼容的 API 後面,讓調用方按同一套方式請求。
下面介紹的 Skill 就是把這套能力封裝給 Agent 用的:Agnes AI 多模態生成,來自 SkillHub 社區發佈者 user_d0c0b7f4,當前版本 1.1.3,分類 design-media。它解決的問題是,讓支持 SkillHub Skill 格式的 Agent 環境,在遇到「用 Agnes 生成文案/圖片/視頻」這類請求時,能直接調用 Agnes AI 的多模態生成能力,而不用爲每種模態單獨寫調用邏輯。
這是什麼¶
一句話定位:一個面向 Agent 的 Agnes AI 多模態生成 Skill,把文生文、文生圖、文生視頻統一到一次調用中。
- 出品/維護:SkillHub 社區發佈者 user_d0c0b7f4,座標 @user_d0c0b7f4/agnes-ai-skill。
- 上游服務:Agnes AI(agnes-ai.com,Sapiens AI),提供 OpenAI 兼容的多模態生成 API。
- 版本:1.1.3。
- 分類:design-media。
- 標籤:requires_api_key=true,即需要用戶自備 AGNES_API_KEY。
- 使用方式:免費使用,但 AGNES_API_KEY 由用戶提供,不包含在 Skill 內。
它適合已經在使用支持 SKILL.md 格式的 Agent 環境(如 Cursor、Codex CLI、Claude Code 等),並希望用一個入口覆蓋文字、圖片、視頻生成的場景。
核心功能¶
根據 Skill 簡介,能力邊界如下:
1、文生文:調用 Agnes AI 做文本生成,例如生成文案、摘要、改寫內容。
2、文生圖:根據文本描述生成圖片。
3、文生視頻:根據文本描述生成視頻。
三者共用同一個 OpenAI 兼容 API 的調用方式,Skill 的職責是識別這類多模態生成請求,並把任務交給 Agnes AI。當前版本 1.1.3 的官方說明只列出這三種生成能力,未在簡介中寫明可用的具體模型名或端點,需要以 Agnes AI 官方頁面爲準。
安裝與啓用¶
安裝入口是 SkillHub 上的技能頁:https://www.skillhub.cn/skills/user_d0c0b7f4/agnes-ai-skill
安裝前先確認兩件事:當前 Agent 環境支持 SkillHub Skill 格式;已經準備好自己的 AGNES_API_KEY,因爲該 Skill 標記爲 requires_api_key=true,不會內置密鑰。
安裝步驟:
1、打開上面的 SkillHub 技能頁,確認名稱、座標和版本(當前應爲 @user_d0c0b7f4/agnes-ai-skill,1.1.3)。
2、按頁面給出的安裝命令或頁面指引,把 Skill 安裝到當前項目的 Skill 目錄。SkillHub 的 Skill 基於通用 SKILL.md 格式,因此核心文件是 SKILL.md;完整分類和細節說明在 skillhub.json 中。
3、配置 AGNES_API_KEY。在當前終端或項目環境中提供密鑰,例如:
export AGNES_API_KEY="你的 Agnes AI API Key"
4、驗證:在 Agent 對話裏給出一個多模態生成請求,例如「用 Agnes 生成一張新品耳機的宣傳圖」,確認請求被 Skill 接管。
關於不同環境的安裝差異:SKILL.md 是通用 Skill 格式,SkillHub 頁面提供安裝入口和說明;本文抓取到的資料未包含 Cursor、Codex CLI、Claude Code 各自不同的具體安裝命令,因此這裏只寫通用步驟,不猜測各環境的專有參數。如果所在環境有獨立目錄約定,以該環境的 Skill 加載說明爲準。
典型用法¶
官方簡介給出的觸發方式,是直接用自然語言表達生成需求。下面這些請求都會命中該 Skill:
- 用 Agnes 生成文案
- 用 Agnes 生成圖片
- 用 Agnes 生成視頻
- 調用 Agnes 文生圖
- 調用 Agnes 文生視頻
- 任何需要 Agnes AI 多模態生成(text/image/video)的任務
例如在 Agent 對話中這樣發起:
用 Agnes 生成一段春季新品耳機的宣傳文案,再配一張同主題的宣傳圖。
Skill 識別到「Agnes 生成文案/圖片」後,會使用 AGNES_API_KEY 調用 Agnes AI 的 OpenAI 兼容接口,分別完成文生文和文生圖,再把結果返回給對話。文生視頻的請求方式相同,只是把生成目標換成視頻。
適用場景與注意¶
適合:
- 需要在同一 Agent 工作流裏同時產出文案、圖片、視頻的團隊或自動化流程。
- 已經使用支持 SKILL.md 格式的 Agent 環境,希望把 Agnes AI 作爲統一生成後端。
- 希望按調用量使用、由用戶自己管理 AGNES_API_KEY 的場景。
注意:
1、必須自備 AGNES_API_KEY。該 Skill 不提供密鑰,未配置密鑰時生成請求無法完成;密鑰屬於用戶自己的 Agnes AI 賬戶。
2、來源是 community(社區發佈)。安裝前建議在 SkillHub 頁面覈對發佈者、版本號和標籤,確認與自己的使用範圍一致。
3、具體可用的生成模型、分辨率、時長、限速等參數,抓取到的資料中沒有列出。Agnes AI 側能力變化時,以 agnes-ai.com 和 SkillHub 頁面爲準。
4、工作流涉及多模態輸出時,建議先分別用文案、圖片、視頻各做一次小樣驗證,再接入批量生成,避免直接用於正式投放。
結尾¶
Agnes AI 多模態生成的價值在於:把文生文、文生圖、文生視頻收斂到同一個 OpenAI 兼容接口和同一個 Skill 入口,Agent 側不需要爲每種模態維護單獨的調用方式;代價是用戶必須自己提供和管理 AGNES_API_KEY。
官方地址:https://api.skillhub.cn/user_d0c0b7f4/agnes-ai-skill
SkillHub 技能頁:https://www.skillhub.cn/skills/user_d0c0b7f4/agnes-ai-skill
上游服務:Agnes AI(agnes-ai.com,Sapiens AI)