Files
agent/skills/image/SKILL.md
T
kicer 76a0e9ad86 refactor(skill): 参数改为动词作键,去掉 op/name/input_args
形状:{"list":"all"} / {"get":"<名>"} / {"run":"<名>","args":{...}},三者恰好给一个。
- 互斥无法用 required 表达,校验与报错回显放在 toolSkill
- list 取值是字符串范围而非布尔,为将来的技能分类留扩展位;今天只认 all
- list/get 带非空 args 一律报错,不静默丢弃
- 旧形状 {op,name,input_args} 仍由 toolSkill 兜底翻译,只为兼容存量技能文档,不再对外文档化
- README/AGENTS/skills 文档与内置技能调用示例同步为新形态
2026-10-21 09:25:25 +08:00

1.3 KiB
Raw Blame History

name, description, mcp_tool
name description mcp_tool
image AI 生成图片(CogView)。op=create 传 prompt 拿 task_id,再 op=get 取图片 URL image_task

功能

调用智谱 CogView 生成图片。异步任务语义:提交立即返回 task_id,生成在服务端后台进行。

参数

args 原样透传给底层服务:

  • op=create:prompt 必填。描述越具体越好(主体、风格、构图、光线、画面里的文字要求)。
  • op=get:task_id 必填,取回任务状态;SUCCESS 时返回图片 URL。

用法

  1. 提交

    skill {"run":"image","args":{"op":"create","prompt":"一只橘猫趴在窗台上晒太阳,水彩风格"}}
    

    → 返回 task_id 与 task_status: PROCESSING

  2. 查询

    skill {"run":"image","args":{"op":"get","task_id":"<上一步返回的 id>"}}
    

    → SUCCESS 时返回 Image N: <url>

注意

  • 生成通常 10~60 秒。看到 PROCESSING 就过几秒再查,不要连续轮询。
  • 结果只有 URL,不落盘。要在会话里使用图片,用 terminal 下载: curl -fsSL -o out.png "<url>",之后 read_file 可以直接看图。
  • 要让外部服务取这张图,先下载成本地文件,再用 mint_public_link 签发链接。
  • 模型名与出图参数由服务端配置决定,调用时不需要也不该传。