技能介绍

要解决的问题

在智能体（Agent）里做商业级广告图与视频，常见卡点是：模型会画，但不会接。后端工作流需要鉴权、需要把用户的模糊需求扩写成结构化 Prompt、需要按功能 ID 传参，还要轮询任务状态取回结果。本技能包把这些细节固化成 OpenAPI 调用约定，让 Agent 用自然语言就能驱动小章 AI 的全链路智能体工作流。

核心能力

鉴权与账号绑定：请求必须携带 Authorization: Bearer <UID>。当用户未提供 UID 时，Agent 需引导其在微信小程序获取并回传。
用户信息校验：调用 getUserInfo 可确认 UID 是否有效，并查询当前积分余额，避免提交后才发现额度不足。
提交任务：executeAgentTask 支持 prompt 与 creation_id 等参数。文档明确要求 Agent 不能原样转述用户短句，而应扩写为包含主体、光影、材质、构图与色彩氛围的高质量 Prompt。
深度参数控制：不同 creation_id 支持对应 JSON 字段，例如灵感Logo 可用 brandName、industry、slogan、designStyle、colorPref；旺铺招牌可用 shopName、material、storefrontImage；视界大片支持 duration、ratio、referenceImages 与 referenceMode；活动背景墙与智能文化墙同样提供品牌素材、二维码与实拍图字段。
轮询结果：拿到 task_id 后，通过 getTaskStatus 每隔 5–10 秒查询，直到返回 completed 或 failed，再将设计图链接或报价单展示给用户。

适用边界与注意点

后端地址固定为 https://xiaozhangai.lanmaoapp.com.cn/api/openapi/v1，计费直接关联请求 Header 中的 UID。
传入 creation_id 会按后台配置的积分与视频倍率扣费，Agent 应在提交前确认用户意图。
在 Windows 终端使用 curl 提交含中文的 prompt 时，直接在命令行传 JSON 可能产生编码乱码；需先将 JSON 写入 UTF-8 临时文件，再使用 curl -d @temp.json 方式发送。
适合需要标准化提交与状态追踪的广告生成场景，不替代模型本身的创意判断。

截图预览

使用场景

电商运营需要为新品快速生成多尺寸海报，通过极速海报功能提交标题、正文与产品图，调用executeAgentTask后轮询getTaskStatus获取成品链接。
线下商家要制作发光字门头效果，用旺铺招牌接口传入店名、材质和门头实拍图，等待后端返回设计图后直接用于招牌制作对接。
市场部筹备年会活动背景墙，需要根据主题内容生成带二维码的背景图，通过活动背景墙功能提交分类、标题和素材图，获取可印刷的设计文件。
创业公司想快速验证品牌视觉，用灵感Logo功能提交品牌名、行业和风格偏好，批量生成不同风格的Logo方案用于内部评审。