用途:当工作流需要可复用的品牌媒体、人工挑选器,或需要生成可被其他应用按 ID 和 URL 引用的图片/视频资产时,使用 Assets 应用(应用 id 为 assets)。
主要能力与动作:generate-asset 让人获得新生成的品牌风格图片候选并在内联挑选器中选择,未传 libraryId 时自动匹配库,适用于应用内聊天和外部 MCP 主机;open-asset-picker 用于浏览、搜索或选择已有资产,或让挑选器自行处理生成,打开 /library 并遵循 iframe/bridge 约定,默认 mediaType 为 image,视频库用 video。无人值守动作包括 search-assets、list-assets、generate-image、generate-image-batch、generate-video、refresh-generation-run、export-asset。还可用生成预设(list-generation-presets)实现可重复的输出格式,用生成会话(create/update-generation-session)延续候选改进,用 restyle-image 和 edit-image 做保留主体、应用库风格及针对性修改。
使用方式:聊天中可将 composer @ 引用作为结构化生成输入,brand-kit 映射为 libraryId,preset 映射为 presetId,media-type 决定图片或视频生成;没有引用时用 view-screen、list-libraries、list-generation-presets 选择显式参数。单资产用 generate-image,多独立槽位用 generate-image-batch 并传稳定 slotId。图片生成动作是同步的,返回后直接使用 images/asset 字段,不要为验证而调用 get-generation-run 等。视频用 generate-video 传 16:9 或 9:16 及相关图片引用,再轮询 refresh-generation-run 至完成。跨应用托管默认连接 https://assets.agent-native.com/_agent-native/mcp;本地定制可运行 npx @agent-native/core@latest app-skill launch --local,或加 --into <path>。
限制与注意:不支持 MCP Apps 内联渲染的主机(如 Claude Code、Codex 等 CLI 和代码编辑器)使用浏览器/深链回退,可让用户点击资产后粘贴简短交接摘要,或直接用文字说明选择。模型/比例兼容:Gemini 图片模型接受任意 aspectRatio,gpt-image-2 仅支持 1:1、2:3、3:2,不支持的配对会被上游拒绝,权威来源为 shared/api.ts 中的 supportedAspectRatiosForModel / MODEL_ASPECT_RATIOS。tier 可传 fast、best 或 auto。不要从其他应用直接调用图片/视频提供方,不要用受版权保护的截图或具名工作室/品牌图集作为预设参考,不要将共享密钥放入技能文件。品牌 QA 评分和 best-of-N 选择暂缓。收费、价格、具体平台支持等资料暂未提供。