讯飞星火模型的灰度发布，本质上是让新的提示词版本在限定流量中先行验证，防止全量上线后出现语义偏差或业务异常。这项操作无法仅通过前端控制台完成，需要直接与后端服务交互——包括上传提示词版本、配置AB分流策略等环节，每一步都需精准执行。
检查灰度环境是否已启用
首先登录讯飞开放平台控制台，进入「星火认知大模型」模块，选择目标模型（如Spark Ultra），点击「部署管理」。若发现「灰度发布」开关呈灰色且无法点击，说明该模型尚未开通灰度发布权限，需提交工单申请白名单。**未开通灰度权限时，所有提示词修改将直接作用于全量流量，风险较高。**
上传并标记提示词版本号
可通过以下两种方式上传新提示词版本：
方法一：通过API上传版本
调用 POST /v4.0/prompt/version 接口，请求体中必须包含以下参数：
- prompt_content（UTF-8编码，纯文本，不超过8192字符）
- version_tag（格式如 v{主}.{次}，例如 v2.1）
- is_draft（设为 true 仅保存草稿，设为 false 才能参与灰度测试）
接口返回的 version_id 是后续绑定分流规则的唯一凭证，请妥善保存。
方法二：在网页端手动创建版本
在模型控制台点击「提示词管理」→「新建版本」，粘贴提示词内容，填写 version_tag，勾选「启用灰度测试」，然后点击「保存并发布」。此时版本状态显示为「待灰度」，不会立即生效，仍在可控范围。
配置灰度分流策略
第一步：进入「灰度策略」配置页面
在左侧菜单点击「灰度发布」→「新建策略」。
第二步：设定分流条件
- 流量来源：选择「指定UID列表」或「AppID+设备指纹哈希前4位」
- 提示词版本：从下拉列表选择刚才发布的 version_id
- 权重分配：填写0～100的整数，表示该版本承接的请求百分比
- 生效时间：必须设置开始时间（精确到分钟），结束时间可留空表示长期有效
第三步：强制刷新路由缓存
策略保存后并不会自动生效，需要手动点击「立即生效」按钮。否则旧提示词会在边缘节点缓存中继续响应约3分钟（讯飞CDN默认TTL），导致灰度延迟。
验证灰度测试效果
使用一个已加入UID白名单的账号，在网页版或APP上发起请求，查看返回头部是否包含 X-Prompt-Version: v2.1 字段。如果没有，说明请求未命中灰度策略，需检查UID哈希映射是否正确，或AppID是否误填为测试环境值。另外，在控制台「灰度监控」页面观察实时QPS分布图，确认目标版本的调用量占比与设定的权重误差是否在±5%以内。若超出范围，表明分流引擎异常，应立即停用该策略并联系讯飞技术支持。