Skip to content

v0.1.0 - Agnes Generation Skill

Latest
Latest

Choose a tag to compare

View all tags
@Yacey Yacey released this 21 Jun 05:00
v0.1.0
60df962

本版本修复内容

这是 agnes-ai-generation-skill 的首个规范 Release，集中包含近期 issue 审查后的修复与使用体验优化。

修复

  • 修复 #2：Agnes Video V2.0 视频结果查询已优先使用新版 video_id 接口。

    • 创建视频任务后，如果响应包含 video_id，video-get 和轮询逻辑会优先调用 /agnesapi?video_id=...&model_name=agnes-video-v2.0。
    • 保留旧版 task_id 查询 /v1/videos/{task_id} 作为兼容 fallback。
    • 更新 SKILL.md、中英文 README 和 API reference 中的视频查询说明。

  • 修复 #1：优化生成媒体后的默认处理方式。

    • 明确要求生成图片/视频后默认直接返回 urls。
    • 除非用户明确要求，不主动下载、保存、打开或本地检查生成媒体，降低 Claude Code CLI 等 agent 会话异常风险。

  • 处理 #3：明确 Agnes Responses API 多轮工具调用限制。

    • 已复现 Responses API function_call 首轮 status=completed、第二轮 function_call_output 续接失败的问题。
    • 文档中明确：不要把 Agnes Responses API 多轮 function calling 用作 Codex / Claude Code 自动工具循环模型。
    • 本 skill 的脚本继续使用 chat completions 路径；工具调用仅作为请求结构兼容能力，不视为稳定的多轮工具执行能力。

生成体验优化

  • 文本、图片、视频输出统一整理为更适合 agent 使用的 JSON 字段，例如 content、urls、translated_prompt、next_steps。
  • 非英文图片/视频提示词默认先翻译为英文，提高 Agnes 视频生成稳定性。
  • 视频命令默认使用更稳定的 num_frames=121、frame_rate=24。
  • 增加图片尺寸、视频帧数、帧率、宽高等本地参数校验。
  • 完成视频 URL 支持从 video_url、url、remixed_from_video_id 等字段提取。

验证

  • python -m py_compile scripts/agnes_api.py 通过。
  • quick_validate.py skill metadata validation 通过。
  • 文生图实测成功，并确认默认只输出 URL。
  • Agnes Video V2.0 新版 video_id 查询实测成功：任务从 in_progress 轮询到 completed，并返回 mp4 URL。
  • Responses API 多轮 function calling 限制已复现并记录规避说明。
Assets 2
Loading