SuperAPI AI 工具集

te-engage

智能体与模型

查看项目

更新于 10-16 05:47

技能介绍

te-engage 是 Hermes Engage MCP 能力包,覆盖配置项、流程、渠道设置与任务数据,命令通过 ae-cli engage <command> 调用。使用前需阅读 ../te-shared/SKILL.md 了解认证、全局参数与安全约束。

用途与主要能力:查询和管理渠道、配置渠道、审批人与白名单;查询任务列表、任务详情、实验报告与指标报告;查询配置项与策略、复制模板、管理策略状态;查询流程列表、节点 schema 与流程报告,并保存或管理流程。命令分组包括 setting、task、config、flow。

使用方式:简单参数用普通标志,如 --project_id、--task_id、--flow_uuid;数组参数用 JSON 标志,如 --strategy_id_list '["id1","id2"]';对象参数用命名 JSON 标志,如 --req '{...}'、--flow_list '[...]'。全局参数如 --host、--mcp-url、--dry-run 与其他域一致。日期参数通常用 yyyy-MM-dd。可用 --dry-run 调试,例如 ae-cli --dry-run engage +channel_list --project_id 1。

+save_flow 关键约束:不能当作普通单命令。需先确认业务场景、目标用户、触点或投放方式、是否需要分支及分支条件;先调用 ae-cli analysis_audience +get_cluster_definition_schema --cluster_type condition,再调用 ae-cli engage +channel_list --project_id <projectId>。最终 --req 必须是完整画布请求载荷,至少含 flowName、flowDesc、nodeList、edgeList;nodeList[].config 与 edgeList[].config 必须是 JSON 字符串而非对象;targetClusterQp 通常也应为 JSON.stringify 产生的字符串。提交前自检:仅一个入口节点、至少一个 exit_flow、edge.source 与 edge.target 引用有效节点、分支节点 sourceBranchId 已在上游节点配置声明、整图为无环 DAG。禁止编造 channelId、在信息不足时填写分支逻辑、把业务语义节点直接作为最终 nodeList、把 config 以对象放入 --req。

写操作需先确认用户意图明确:渠道与配置渠道的 +add_channel、+delete_channel、+update_channel_status、+delete_config_channel、+update_config_channel_status;策略与配置项的 +delete_config_item、+copy_config_template、+manage_strategy;流程的 +save_flow、+modify_flow_base_info、+manage_flow、+delete_flow;任务的 +manage_task。

适用场景:渠道与配置管理、任务数据与报表查询、策略对比与配置分析、流程编排与校验。限制:需先完成认证与全局参数配置;写操作需显式确认;+save_flow 必须遵循上述工作流与自检规则。更详细的单命令说明见 references/ 目录,如 references/save-flow.md、references/flow-node-config-schema.md、references/validate-flow-node-config.md、references/channel-list.md、references/task-list.md、references/config-item-list.md、references/flow-list.md。