AE Automation 是 ae-cli 提供的自动化管理技能,用于管理 AE Agent 与 Agent 团队的自动化任务。
用途:通过 ae-cli 创建、编辑、启用或禁用、立即运行、停止或重试执行、删除和检查自动化。
使用前的准备:在编写或执行自动化前,应先阅读命令约定以了解命令风险;可用 ae-cli automation --help 及各级帮助发现可用参数。需先解析主机与空间:本地用户使用 ae-cli auth login 登录,沙箱使用其注入的凭据。当用户指明空间时传 --agent-space-id;未提供空间时,服务器使用绑定的沙箱空间或个人默认空间。在空间信息重要时应展示解析结果。
发现与检查:用 automation list 发现自动化,用 automation get 检查;操作时应使用返回的 ID,因为名称并不唯一。
创建:通过相应的发现命令选择 Agent 或团队,并使配置与目标类型匹配。写入前可用 --dry-run 预览,CLI 会显示脱敏请求,并让服务器校验认证、空间、权限、目标状态、字段和幂等性,而不实际应用操作。
执行与确认:执行所请求的操作。删除自动化或停止执行需要确认;仅当用户已授权该操作时才使用 --yes。在非交互式 shell 中,除非存在全局 --yes,否则这些操作会立即失败。
结果读取:读取返回的运行 ID,然后用 automation runs result 查看执行结果。应将“已接受”与“已完成”分开报告。仅当用户需要立即获得最终结果时才使用 --wait。
限制:结果从服务器读取,可在沙箱外工作。此技能不读取完整对话,也不继续聊天。绝不要从共享同一对话的其他执行推断输出。