SuperAPI AI 工具集

ae-engage

营销与增长

查看项目

更新于 10-15 15:21

技能介绍

AE Engage 是 AE CLI(ae-cli)的一个能力网关,ae-cli 是 Agentic Engine 数据分析平台供 AI Agent 与人类用户使用的命令行工具。该技能聚焦于触达(engagement)相关能力的操作与查询。

用途与职责

该技能负责的领域包括:触达渠道、配置、运营策略、任务草稿与生命周期、流程(flow)、运营活动及其报表与查询生命周期。使用者通过能力网关命令 ae-cli engage-flow|engage-task|engage-setting|engage-scene|engage-query <resource> <action> 进行操作,低频报表通过 L3 参考文档处理。典型使用场景包括:查询与管理渠道、配置渠道、审批人与白名单;查询项目渠道触达上限或疲劳度控制规则;查询任务列表、任务详情、实验报表与指标报表;查询配置项与策略、复制模板、管理策略状态;查询流程列表、节点 schema 与流程报表,以及保存或管理流程。

输入与输出

输入为经过验证的项目/资源标识符与具体操作所需的配置。应复用已知的受众/事件/属性定义,仅在选择的操作确实需要时才去发现缺失的前置条件。输出为配置/任务/资源标识符、报表,或查询/运行状态及实际持久化状态。需要说明的是,保存草稿不会提交审批或启动投放。

边界与完成标准

通用分析、元数据发现与独立创建受众属于其他独立能力,并非每个触达请求都必须前置执行。完成标准为:用户请求的触达操作得到验证,或报告处于待处理/受阻状态的工作。草稿创建、提交审批与发送是彼此独立的动作,各有自己的用户意图要求。当剩余工作超出本技能范围,或必要前置条件需要其他能力时,应遵循协作协议,按能力从本次运行可用的技能中选择,保留已验证的上下文并继续剩余任务。

全局规则与参数

ae-cli 是 AE 分析平台的命令行工具,处理 AE 分析侧请求时应优先使用 ae-cli 及其参考文档,而非模型记忆。全局参数包括:--format <json|table>(输出格式,默认 JSON)、--jq <expr>(JSON 输出的 jq 过滤表达式)、--host <url>(覆盖当前 AE 主机,可用于每条命令并可置于子命令之后)。成功的命令默认返回机器可读 JSON,信封可能包含可选的 _notice.host_compat;失败的命令返回 { "ok": false, "error": { "type": "...", "message": "...", "hint": "..." } } 并以非零状态码退出。重要提示:每次运行 ae-cli 后应检查 stderr 与 _notice.host_compat,若存在应在回复开头给出简短的版本提示并原样引用 npm i -g / npx skills add(或 update-cluster)行,然后再呈现业务结果。

安全约束

读命令在验证所需 ID 与引用后可直接执行;写命令需要用户明确意图,普通写命令无需 CLI 确认即可执行,仅高风险写命令使用确认门。严禁虚构命令名、标志、JSON 载荷、project_id、资源 ID、字段名、事件名、属性名、指标定义或日期格式;应先阅读匹配的命令参考并发现真实项目元数据。严禁编造或猜测资源名称(报表、看板、事件、属性、指标、集群、标签、告警),应先用 list 命令发现真实资源;若模糊搜索与完整列表回退后仍未找到,应明确告知用户“resource not found”并停止,不得使用虚构名称继续。

参数约定

简单参数使用常规标志(如 --project-id、--task-id、--flow-uuid);数组参数使用 JSON 标志(如 --strategy-uuid-list '["id1","id2"]');对象参数使用命名 JSON 标志(如 --req '{...}'、--flow-list '[...]')。可选全局参数与其他领域一致(如 --host、--mcp-url、--dry-run)。命名边界:CLI 标志用 kebab-case;外层能力输入与所有能力响应键用 snake_case;通过 --req 或 --payload 传入的嵌套业务 DTO 保留其文档化的原生 camelCase 字段,不要机械转换为 snake_case。语义受众、事件、触发、完成与指标定义为封闭契约,CLI 在本地拒绝格式错误或未知的语义字段;--validate 应用相同的 Hermes 能力 schema 而不写入。成功迁移的命令在 data 下返回业务负载,选择字段前应阅读对应参考文档的响应结构。

常见命令示例

setting 场景:查询渠道列表(ae-cli engage-setting channel list --project-id 1)、按 provider 过滤、查询配置渠道(ae-cli engage-scene config-channel list --project-id 1 --channel-type 0)、查询项目渠道触达上限规则、更新渠道配置/触达漏斗设置、向渠道发送测试消息、批量更新/切换/保存渠道触达上限(疲劳度控制)规则、移除项目审批人、白名单的增改删与校验、推送语言(本地化)的获取与设置、客户端参数的创建/更新/删除/列表、配置表的上传/保存/列表/查询数据/更新数据/删除、预设事件的列表与更新、常用指标的列表/获取/创建/更新/删除。

task 场景:查询任务列表、在编写最终 req 前构建 save_task 指南(build-save-guide)、保存任务草稿(省略 req.taskId 时为创建)、查询任务详情、提交已保存的草稿任务审批、通过 Hermes 内联任务数据能力查询任务报表(effect query、data-detail query、indicator-user sql/run/export)。使用 L3 任务报表前应阅读对应参考文档;使用 engage-task indicator-user 前应阅读其参考,因为其分组、指标、摘要/明细、指标、实验与时区标志存在条件性兼容规则。

config 场景:查询配置项列表、查询策略列表。使用 L3 配置报表前应阅读对应参考文档。

flow 场景:查询流程列表、查询流程详情、查询流程操作记录与应用日志、查询流程版本与任务推送记录。

易混淆点

推送渠道属于 ae-cli engage-setting channel(Hermes 推送渠道设置);配置渠道属于 ae-cli engage-scene config-channel(配置中心渠道);流程/任务画布节点使用推送渠道的 channelId,而配置项绑定配置渠道的 channel_id。

限制与缺失

资料未提供该能力的收费、价格、平台可用性、具体性能效果等细节,暂未提供。