Automation theo lịch

Automation của Orca chạy một prompt theo lịch từ CLI, để các task triage, review, và bảo trì lặp lại có thể khởi động mà không cần bạn tự mở worktree. Đọc hết trang này, bạn sẽ tạo một automation đang tắt, kiểm tra nó, và chạy khi đã sẵn sàng.

Tạo một automation đầu tiên an toàn

Bắt đầu với --disabled trong lúc tinh chỉnh prompt và target:

orca automations create \
  --name "Weekday triage" \
  --trigger weekdays \
  --time 09:00 \
  --prompt "Triage new issues and summarize blockers" \
  --provider codex \
  --repo my-repo \
  --disabled \
  --json

--trigger chấp nhận preset như hourly, daily, weekdays, và weekly, cộng thêm biểu thức cron hoặc chuỗi RRULE. Dùng --timezone <tz> khi lịch nên theo một timezone IANA cụ thể thay vì mặc định của runtime.

Chọn nơi các lần chạy diễn ra

Dùng --repo <selector> khi mỗi lần chạy nên tạo hoặc chọn công việc trong một repository. Dùng --workspace <selector> khi automation nên chạy bên trong một worktree Orca có sẵn:

orca automations create \
  --name "Nightly status" \
  --trigger "0 18 * * 1-5" \
  --prompt "Summarize today's changes" \
  --provider claude \
  --workspace active \
  --disabled

Khi bạn bỏ cả hai flag target, Orca resolve worktree bao quanh từ thư mục shell hiện tại nếu có thể.

Precheck trước một lần chạy

Bỏ qua công việc theo lịch khi một shell probe rẻ tiền thất bại (exit code khác 0 ghi lại là run bị skip):

orca automations create \
  --name "PR review" \
  --trigger hourly \
  --precheck "gh pr list --json number -q .[0].number" \
  --prompt "Review requested PRs" \
  --provider codex \
  --repo my-repo \
  --disabled \
  --json

Target project host / setup

Khi automation nên chạy trên một setup host project cụ thể thay vì chỉ --repo / --workspace:

orca automations create \
  --name "Remote triage" \
  --trigger daily \
  --time 09:00 \
  --prompt "Triage open issues" \
  --provider claude \
  --project <projectId> \
  --host <hostId> \
  --disabled \
  --json

Dùng --project-host-setup <id> khi bạn đã có sẵn setup id. --source-context '<json>' tuỳ chọn ghim dữ liệu task/provider vào một host/tài khoản (truyền null khi edit để xóa).

Grace cho lần chạy bị bỏ lỡ

orca automations edit <automationId> --missed-run-grace-minutes 30 --json

Dùng lại một session automation có sẵn

Với automation nhắm vào một worktree có sẵn, thêm --reuse-session khi các lần chạy sau nên tiếp tục trong cùng terminal automation đang sống thay vì bắt đầu từ một terminal trống mỗi lần:

orca automations create \
  --name "Inbox digest" \
  --trigger hourly \
  --prompt "Summarize unread mail" \
  --provider codex \
  --workspace active \
  --reuse-session \
  --disabled

Dùng orca automations edit <automationId> --fresh-session --json để chuyển automation về dùng terminal mới mỗi lần chạy.

Review và bật

Liệt kê và kiểm tra automation trước khi bật:

orca automations list --json
orca automations show <automationId> --json
orca automations edit <automationId> --enabled --json

Trong danh sách automation trên desktop, dùng ô tìm kiếm để lọc theo text name, project, hoặc prompt khi bạn có nhiều lịch. Automation ngoài nằm trên một host SSH vẫn hiện thành job bạn có thể quản lý (kể cả xóa) khi host đó đang mất kết nối - bạn không cần một session SSH active chỉ để xóa một lịch.

Dùng Filters để thu hẹp danh sách theo trạng thái Enabled hoặc Paused, hoặc theo kết quả lần chạy cuối: Failed, Succeeded, hoặc Never ran. Bảng hiện kết quả lần chạy cuối và thời gian tương đối cho mỗi automation. Click cột Name hoặc Last run để sắp xếp; name sắp theo alphabet, còn last run mặc định mới nhất trước.

Dùng edit để đổi tên, prompt, provider, target, lịch, hoặc trạng thái bật. remove xóa một automation và lịch sử chạy của nó.

Chạy theo yêu cầu

Sau khi tạo một automation, kích hoạt thủ công để kiểm tra prompt và target trước khi chờ tới lần theo lịch tiếp theo:

orca automations run <automationId> --json
orca automations runs --id <automationId> --json

Nếu một lần chạy thất bại trước khi mở được workspace hoặc reconnect tới target, mở lần chạy đó trong Orca và click Rerun để xếp hàng một lần chạy thủ công mới cho cùng automation.

Bước tiếp theo

• Orca CLI overview - xem phần còn lại của bề mặt CLI cho worktree, terminal, và điều khiển trình duyệt.
• Skills registry & MCP - cài skill Orca CLI để agent gọi được cùng các lệnh này.

Nguồn

Dịch và biên soạn từ trang Scheduled automations trong tài liệu chính thức của Orca ADE (onorca.dev).