酷特海外运营 · 海报添加素材
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @kutesmart/kutesmart-platform-marketing-poster-poster-resource。
技能介绍
要解决什么问题
在海外运营平台的营销海报流程里,添加海报往往要先拿到平台侧可用的素材(图片、文案占位或资源清单等),再进入编辑与发布。若让上层 Agent 自己拼 URL、猜 query 或改写网关地址,很容易打到错误环境,或在多步编排里把「取素材」和「保存海报」混成一步,导致后续 skill 拿不到干净的接口响应。
本技能是 最小颗粒度 的接口 skill,只负责 poster_resource:在需要「添加海报时获取素材」时,对正式环境发起一次约定好的 GET 调用。
技能如何工作
- 固定网关:执行器使用 frontmatter 中的正式环境
base_url(https://www.kutetailor.com/api/marketing/poster/getPosterResource),不接受用户输入覆盖。 - 参数形态:tool arguments 最外层仅包含嵌套的
params;登录态通过params.accessToken生成Authorization: Bearer(若已含Bearer则不重复拼接)。 - 请求形态:动作为 GET,路径为
/poster/getPosterResource,无 path/query/body 要求时按表为空提交;额外 Header 可写在params.headers。 - 返回处理:以接口原始响应为事实来源,把关键字段交给后续 skill;若出现认证、权限、参数或业务错误,应把原始错误码与错误信息向上传递,而不是本地编造库存、价格或订单状态。
需要完整「创建海报 → 保存 → 上架」等链路时,应由上层 Agent 参照聚合 skill platform-marketing-poster 或计划文档,串联多个原子 skill;本 skill 只完成取素材这一步。
适用边界与注意点
- 这是查询类接口,但仍受当前登录态、租户与用户权限约束;无 token 或权限不足时,应如实上报接口错误。
- 若用户需求包含多个 HTTP 步骤,本 skill 只完成
poster_resource,其余步骤交给其它原子 skill 或编排逻辑。 - 不要根据业务想象补全接口未返回的字段;上层展示或决策应依赖 RS 及错误体本身。
使用场景
- 在海外运营后台新建营销海报前,由 Agent 先调用 GET 取平台返回的素材资源,再进入排版或选图
- 编排 platform-marketing-poster 链路时,把「添加海报时获取素材」作为独立一步,避免与保存海报接口混调
- 用户口述「加一张海报、先拉素材」时,只执行 poster_resource,把 RS 关键字段交给下一步 skill
- 联调 kutetailor 正式环境时,用固定 base_url 验证 Bearer 登录态下素材接口是否返回权限或参数错误
适合人员
- 负责酷特海外营销海报上架的运营,需要在 Agent 对话里先拉取添加海报所需的平台素材再填内容
- 对接 kutetailor 营销接口的后端或集成工程师,要把 poster_resource 封装进多 skill 编排而不改正式网关地址
- 搭建企业运营类 Agent 的编排者,按聚合文档拆分原子 skill,在「添加海报」节点只调用 getPosterResource
- 维护海外站海报工作流的实施顾问,向客户说明取素材与保存海报是不同接口、错误需原样上报