必须在提示词中嵌入格式钩子以精准触发响应逻辑，且需满足命名规范、位置要求、模型版本支持、domain配置及白名单授权，否则将导致解析失败或拦截。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
要在星火大模型的MAU（月活跃用户）统计场景中精准捕获用户真实意图并触发特定响应逻辑，必须在提示词中嵌入可识别、可拦截、可路由的钩子机制，而非依赖模型自由发挥。
明确钩子定位与触发边界
钩子不是关键词堆砌，而是结构化指令锚点。必须用<xxx></xxx>格式包裹唯一标识符，如<mau_check></mau_check>或<report_202606></report_202606>。模型仅对严格匹配该格式的标记执行预设动作，其他相似写法（如“#mau_check”或“[mau_check]”）均无效。
所有钩子名称必须全小写、无空格、不含特殊字符（仅允许下划线），且长度不超过32字符。超出将导致SDK解析失败，请求直接返回400 Bad Request。
在WebSocket请求payload中注入钩子
将钩子写入payload.message.text数组的首个元素content字段内，位置不可前置空格或换行：
{"payload":{"message":{"text":[{"role":"user","content":"<mau_check>请按模板输出当月MAU趋势摘要，含环比变化率和TOP3活跃渠道"}]}}}</mau_check>
注意：钩子必须位于content字符串最开头，紧贴左引号。若前面有空格、制表符或换行符，星火服务端会跳过识别，当作普通文本处理。
将小说章节转换为电影分镜剧本。用户上传txt/md/docx文本，AI分析场景、角色、情绪、镜头语言，输出专业分镜脚本。适用于用户提及“分镜”“storyboard”“小说转分镜”“影视改编”“镜头脚本”或需要将小说改编为分镜的场景。
配置parameter.chat.domain与钩子联动规则
第一步：确认所用模型版本支持钩子能力——仅Spark 4.0Ultra和Spark Max在2026年5月起的API中启用钩子路由机制；Spark Lite和Spark Pro版本完全忽略钩子标记。
第二步：在parameter.chat.domain中显式指定对应钩子处理器，例如："domain": "generalv4.0-hook"。该domain值不可省略或拼错，否则钩子虽存在但无路由目标，模型仍走默认生成流。
第三步：确保header.app_id已开通钩子白名单权限。未授权app_id发送带钩子请求，服务端直接拦截并返回{"code":10012,"message":"hook not allowed for this app_id"}。
验证钩子是否生效
方法一：发送含钩子请求后，检查响应payload.choices.text[0].content是否以[HOOK_ACK]前缀开头。出现即表示钩子已被识别并交由专用模块处理。
方法二：调用完成后立即查询/v4.0/hook/log?app_id=xxx&start=20260601&end=20260613接口，查看hook_name字段是否包含你设置的标识符。无记录说明钩子未被解析或未触发。
【必须在请求header中携带X-Request-ID头，否则hook日志无法关联到具体调用】
