跳转到主要内容
发布包含两项独立控制:rollout.enabled 决定是否启用 Agent,ai_audience 决定谁可以接收 Agent 回复。 API 参考: GET 获取设置 · PUT 替换设置

为白名单接收者启用 Agent

在 WhatsApp 首次上线测试期间,请保持限制受众范围。
在白名单添加与事件提交中使用相同的身份标识。电话条目不会自动将其对应的 BSUID 列入白名单。 从每个列入白名单的测试客户发送代表性消息,并确认未列入白名单的号码不会收到 Agent 回复。

读取生效设置

即使仅存在一个设置对象,响应也是一个数组。每次发布变更后,请同时验证 rollout.enabled 和 ai_audience。

设置 Agent 预算

预算用于限制滚动时间窗口内的 Token 或 AI 轮次用量。YCloud 使用 WhatsApp Business 电话号码 ID 查找关联的 Business Manager。 API 参考: GET 获取预算 · PUT 替换预算
unit_type 为 token 或 ai_turn。time_window 为 one_day、seven_days、fourteen_days 或 thirty_days。max_budget 必须为正整数。 PUT 会替换整个 Budget 集合。对于要保留的每个现有 Budget,请包含 budget_id;若为新增 Budget,则将其省略。每个 (unit_type, time_window) 对必须唯一。发送 {"budgets":[]} 可移除所有限制。每次替换后请重新读取该集合。

扩展至全量受众

白名单发布通过验收测试后,仅更改受众即可。
省略的设置项在 YCloud 中将保持不变。在将发布视为完成之前,请再次读取设置并监控真实对话。

必要时进行回滚

在扩展受众之前,请准备好以下请求:
回滚后读取生效设置。禁用发布不会删除 Agent、知识、技能或连接器。
启用发布会改变实时消息的处理方式。请与人工支持团队协调职责分工,切勿用全量受众替代完成受限的验收测试。

下一步:运维与排错

上线后控制实时对话、处理事件、检查日志以及排查故障。