Multica Autopilots 是 Multica 平台上的持久化自动化规则,用于按计划、Webhook 或手动方式触发,把工作派发给指定智能体,或派发给小队的负责人智能体。它不是智能体本身,而是一条派发规则。
主要能力与执行流程:触发后生成 autopilot_run 记录,由 execution_mode 决定输出,再经分配对象就绪检查,进入 issue 或 task 执行,并同步运行状态。Webhook 前置持久化准入:HTTP 入口先存入排队的 webhook_delivery,同步创建或复用幂等运行,返回 200 及 status=accepted|skipped 和 run_id;随后由数据库租约的 worker 恢复已接受的运行并负责可分发的 issue/task 派发。
执行模式:create_issue 会创建 Multica issue,使运行以 issue 状态可见;run_only 直接创建智能体任务,不创建 issue,持久报告位置需由其他任务上下文或指令提供。issue-title-template 仅支持 {{date}}。
常用 CLI:multica autopilot list --output json;multica autopilot get <autopilot-id> --output json;multica autopilot create --title "<title>" --description "<task prompt>" --agent <agent-name-or-id> --mode create_issue|run_only --output json;multica autopilot update <autopilot-id> --status active|paused --output json;multica autopilot runs <autopilot-id> --output json;multica autopilot trigger-add <autopilot-id> --kind schedule --cron "0 9 * * *" --timezone Asia/Shanghai --output json;multica autopilot trigger-add <autopilot-id> --kind webhook --label "ci" --output json;multica autopilot trigger <autopilot-id> --output json;multica autopilot trigger-rotate-url <autopilot-id> <trigger-id> --yes --output json。
限制与注意事项:不要在测试中运行 trigger、delete、trigger-delete 或 trigger-rotate-url,它们会产生真实副作用。仅当用户明确要求手动运行时才使用 trigger;仅在轮换 webhook URL 时使用 trigger-rotate-url,旧 URL 会失效。autopilot get 默认隐藏 webhook_token、webhook_path、webhook_url,仅当用户明确要求获取实时凭证时才加 --show-secrets,该命令会在 stderr 警告。不要将 webhook token 或签名材料粘贴到评论、日志、文档或 PR 中。
排查“为何未运行”可用 autopilot get 查看状态、模式、分配对象与触发器;用 autopilot runs 查看运行状态与失败原因;若分配给小队,用 multica squad get <squad-id> --output json 检查,执行会交给负责人;再检查目标智能体与运行时:multica agent get <agent-id> --output json 与 multica runtime list --output json。Webhook 可查看投递状态:queued 表示 worker 尚未完成派发,failed 会携带 worker 错误;同一 X-GitHub-Delivery 或 Idempotency-Key 的提供方重试会复用原始投递。create_issue 若运行记录了 issue,可检查该 issue。
会产生持久状态变更或启动工作的操作包括:create、update、delete、触发器 add/update/delete/rotate、trigger,以及对 /api/webhooks/autopilots/{token} 的 Webhook 调用。更多来源支持的细节见 references/autopilots-source-map.md。