SuperAPI AI 工具集

alera-automations

智能体与模型

查看项目

更新于 10-16 00:00

技能介绍

用途:Alera Automations 用于安排智能体按计划执行工作。自动化是定义,运行是单次执行;编排任务属于另一功能 alera-orchestration。

主要能力:通过 CLI 创建、编辑、查看、列出、暂停、恢复和立即运行自动化,并预览 cron 计划。创建时需显式选择执行目标,不能推断目标类型;选定后 --workspace-id、--profile-id 和 origin 可来自当前 Alera 终端环境。提供 profile、prompt、schedule 和有效目标即可,无需仓库声明、profile 权限或审批步骤。默认创建为 Active,除非使用 --draft;编辑 Active 自动化会保持 Active 并影响未来运行。

用法示例: alera automation --json create --name 'Daily Review' --prompt 'Review changed files and report findings' --cron '0 9 * * 1-5' --timezone America/Mexico_City --target fresh-tab --request-key daily-review alera automation --json create --file automation.json --dry-run alera automation --json edit --id <id> --prompt-file prompt.txt --expected-revision <revision> alera automation --json list --workspace-id <workspace-id> alera automation --json show --id <id> alera automation run-now --id <id> alera automation pause --id <id> --active-runs continue-active alera automation resume --id <id>

重试创建时使用稳定的 --request-key;--dry-run 检查就绪状态而不保存;preview-schedule --cron '0 9 * * *' --timezone UTC 预览日期。其他目标和高级设置请阅读 targets 与 JSON 文档,可选参数用 alera automation <command> --help 查看。

执行与限制:计划触发需要运行时处于运行状态;创建自动化不会启用登录自启动或更改 keep-runtime 设置。默认跳过离线期间错过的执行。已准入的运行单独恢复:核对所有者,尽可能恢复原生对话,然后在保留的工作区中带上下文重试;恢复共三次启动,退避 60/120 秒,原始截止时间为 24 小时。无法访问的 SSH 所有者保持保留状态直到可验证关闭,所有权未知时不要手动向同一目标启动替代运行。观察终端是只读的;Take Over 会停止自动恢复并保留工作区,仅在用户打算操作该智能体时使用。

在自动化内部运行时:ALERA_AUTOMATION_RUN_ID 和 ALERA_AUTOMATION_ATTEMPT_ID 将生命周期调用绑定到当前尝试,CLI 从终端环境提供目标身份,需保持这些变量不变。可用 alera automation --json context --run "$ALERA_AUTOMATION_RUN_ID"、heartbeat、complete(--status success/failure/blocked 并附 summary)报告进度;长时间工作应报告进度,完成时只调用一次并给出有用摘要;被取代的尝试必须停止生命周期写入;重试外部效果前先检查已有结果以避免重复。