用途:通过 ae-cli 的 experiment 域管理 Atlas AB 实验与外部实验,涵盖流量层、Feature、指标、分桶和实验报告。命令段与标志使用 kebab-case,外层输入与响应键使用 snake_case,--req 内的嵌套业务 DTO 保持 camelCase。
主要能力:可发现并创建可复用资产,如 experiment bucket list、traffic-layer list、feature list、metric list;用 experiment experiment save 创建或修改实验草稿,update-metrics 替换指标绑定或分配护栏角色;外部实验用 external-experiment save-submit。支持 ready-check 就绪检查、非互斥流量层的 conflict-check、manage 变更状态,以及 report summary、sample-size、metric-trend 查询报告。
使用方式:项目级命令用 --project-id/-p;复杂保存、状态与删除 DTO 用 --req JSON。读命令在 ID 核实后可直接运行,写命令需明确用户意图并保留确认提示,组 JSON 前先用 --dry-run。指标仅绑定 metric list 返回的 ID,缺失指标先创建并验证。事件属性比较放在 metricDefinition.filters,使用 {relation,items:[{field,operator,values}]};sum/avg/max/distinct_count 需 metricDefinition.property,total_count/user_count/active_days 省略 property。分配字段:实验级 req.allocation 与组级 req.groups[].allocation 均为整数,组级之和须等于 100。指标角色为 primary、secondary、guardrail,内部 observation 角色当前不可保存。
限制:不得编造实验 ID、流量层 ID、分桶 ID、Feature key、指标 ID 或载荷字段名;不得生成或提交 targetConfig、metricConfig、calcType、Axxx 码、filts、calcuSymbol、ftv。指标创建不支持 avg_per_user/A105。实验保存返回 METRIC_NOT_FOUND 时先列出同项目指标再创建验证,不要用新编 ID 重试。列表返回 data.items 与 data.total,详情返回 data.item,就绪返回 data.readiness,报告返回 data.report,保存指南返回 data.guide,写入返回 data.result。写操作前应阅读 references/ 下对应文件。