用途:该技能面向需要理解复杂用户意图的 AI 助手,通过多轮对话引导用户说清“想要什么”,而非“如何实现”。适用于结构化参数提取、歧义澄清流程,以及判断用户意图是否已可进入生成阶段。
主要能力:定义 CreativeIntentSchema 结构化意图(资产类型、氛围、场景元素、展示文本、歧义标注、轮次、用户确认状态);通过 IntentParser 解析初始请求与后续消息,识别确认语句并解决歧义;用 ReadinessState 表示四种状态:not_ready、needs_clarification、awaiting_confirmation、ready;提供 get_clarification_questions 生成澄清问题;CoachService 以流式方式输出 token、intent_ready、done、error 等 StreamChunk。
使用方式:调用 start_session 传入 user_id、asset_type、description、mood 启动会话,首轮永不标记 ready;后续用 continue_chat 传入 session_id、message 与 schema 继续对话。示例中通过 async for 遍历 chunk,token 用于展示,intent_ready 的 metadata 含 is_ready、readiness_state、clarification_questions 等字段。
限制与注意:MAX_TURNS 为 10,超出返回错误;必须由用户显式确认后才可进入 ready;首轮不得标记 ready;需跟踪并解决歧义;需持久化会话状态以支持重连。资料未提供安装命令、收费、平台或效果信息。