灰度发布

约束与限制

• 灰度策略需至少2个版本才可启用。
• 每个访问方式仅支持配置一组灰度策略（1个主要版本 + 1个次要版本）。
• 主要版本和次要版本不能选择同一版本。
• 流量权重为0-100的整数，且两版本权重之和必须等于100。
• Latest默认访问方式无法配置灰度策略，需创建新的访问方式。

操作步骤

1. 准备新版本。

   将新版本代码打包为镜像，部署为运行时的新版本（如 v2）。具体操作请参见通过控制台部署中的“编辑智能体运行时”。

2. 创建灰度访问方式。
   1. 登录AgentArts智能体平台。
   2. 在左侧导航栏选择“托管与运行 > 智能体运行时”。
   3. 单击运行时名称，进入详情页。
   4. 在“访问方式”区域，单击"创建访问方式"。
   5. 开启“灰度策略”开关。
   6. 选择主要版本和次要版本，配置流量比例（如主要版本 90%，次要版本 10%）。
   7. 配置完成后单击“确定”。

3. 验证新版本。

   通过灰度访问方式调用运行时，小比例流量会路由到新版本。观察新版本的运行状态和日志，确认功能正常。

   # 调用灰度访问方式（流量按比例分配）
   POST https://{域名}/runtimes/{runtime_name}/invocations?endpoint=gray-release
   Headers: X-Hw-Agentarts-Session-Id: new-session-id
   Body: {"message": "测试新版本功能"}

   

   建议使用新的会话ID进行灰度验证，避免与会话存储路由冲突。

4. 逐步扩大流量。

   如新版本运行正常，逐步调大次要版本的流量比例：

   • 第一阶段：主要版本 90% → 次要版本 10%
   • 第二阶段：主要版本 70% → 次要版本 30%
   • 第三阶段：主要版本 50% → 次要版本 50%
   • 第四阶段：主要版本 20% → 次要版本 80%

   每个阶段持续观察运行状态、日志和监控指标。

5. 全量切换。

   确认新版本稳定后，将主要版本切换为新版本，参考2将主要版本流量设为100%，完成灰度发布。