ZigoAI AiSales 配置管家

解决什么问题

在 AiSales 租户中调整智能体配置、账号绑定或消息通道时，一个看似微小的参数改动，也可能导致下游对话逻辑失效或通知链路中断。如果直接调用接口写入，不仅难以评估影响面，事后审计也缺乏明确的对比基线。

ZigoAI AiSales 配置管家 针对这类高风险操作，提供了一条标准化的变更路径。它不追求“一键完成”，而是把配置更新拆分为可检查、可追踪的步骤，确保每一次写入都有据可依。

核心能力与工作流

技能通过 zigo-aisales CLI 操作 AiSales 租户级配置，连接信息由 ZIGO_AISALES_BASE_URL 和 ZIGO_AISALES_AGENT_TOKEN 注入。Token 不接受命令行参数，也不会被输出或记录，从源头杜绝泄露风险。

任何变更都遵循以下顺序：

• 发现：先运行 capabilities 与 accounts，获取服务端真实能力和当前账号通道状态，而不是依赖本地猜测。
• 预览与计划：写入前必须生成 plan，展示 before / after 对比、受影响账号与通道、潜在风险和 warnings。
• 精确确认：只有当用户明确回复 APPLY 后，技能才会调用 apply。该步骤使用稳定且唯一的 idempotency key，重试时复用同一个 key，避免产生重复操作。
• 验证：执行 verify 核对实际状态。如果不匹配，技能会如实报告差异，不会宣称已完成；只有在用户明确确认 ROLLBACK 后，才会执行回滚。

适用边界与注意点

• 技能严格限定在 Agent Token 所属租户内工作，不接受用户传入的 tenant_id 覆盖。
• notification webhook 的地址和密钥不可读、不可改，也不要尝试旁路 API 或直写数据库。
• 媒体上传需要用户明确确认 UPLOAD。由于文件一旦上传便无法通过配置 rollback 删除，技能会在确认前进行特别提醒。
• 当 plan 过期或遇到 revision 冲突时，技能会重新生成 plan，而不是绕过校验继续执行。