Chẩn đoán AI & Autopilot

Một agent có thể ngừng hoạt động theo hai cách. Nó có thể vẫn sống nhưng bị kẹt: một rào cản quota, lời nhắc đăng nhập hoặc modal upsell đang hiện trên màn hình và tin nhắn của bạn không bao giờ đến được. Hoặc nó có thể chết hẳn: kết nối rớt hoặc CLI thoát giữa chừng một tác vụ. Chẩn đoán AI xử lý trường hợp đầu và Autopilot xử lý trường hợp thứ hai. Cả hai nằm chung một chỗ.

Mở Orchestration Dashboard từ thanh trên cùng, hoặc chạy Open Orchestration Dashboard từ Command Palette, rồi chọn Advanced → AI Diagnosis. Tutorials → How-to → Autopilot sẽ đưa bạn thẳng đến đó.

Diagnose & restore stuck agents

Khi một lượt gửi tin nhắn đến terminal của agent liên tục thất bại trong khoảng hai phút, một AI CLI đã cài đặt sẽ đọc nội dung màn hình của terminal đó và cho biết vấn đề là gì. Tin nhắn được thử gửi lại mỗi 15 giây, và lần lỡ thứ tám sẽ kích hoạt chẩn đoán. Nếu terminal đó nằm ở một ghế (seat) trong chart có agent dự phòng, ghế sẽ tự chuyển sang dự phòng. Mọi terminal khác đều nhận kết quả chẩn đoán dưới dạng thông báo để bạn hành động. Các terminal khỏe mạnh không bao giờ bị kiểm tra.

Diagnose & restore stuck agents bật mặc định và áp dụng toàn app, cho mọi team, chart và terminal đã liên kết. Trong How to restore, chọn:

• With AI (recommended): một AI checker đọc màn hình của terminal bị kẹt trước, và chỉ khi xác nhận rào cản quota hoặc đăng nhập mới kích hoạt khôi phục. Nó không bao giờ làm phiền một agent chỉ đang bận.
• Manual timer — no AI: chỉ riêng việc hết hạn sẽ khôi phục. Cách này nhanh hơn và hoàn toàn local, nhưng không phân biệt được agent bị kẹt với agent đang bận một tác vụ dài.

Các checker agent, theo thứ tự

Các checker được thử lần lượt. Nếu một checker chưa được cài đặt, chạm giới hạn của chính nó hoặc timeout, checker tiếp theo sẽ tiếp quản. Provider của chính terminal bị kẹt luôn bị bỏ qua, nên một agent không bao giờ tự chấm điểm mình. Claude, Codex, Gemini, OpenCode, Qwen, Kimi, Grok và Hermes đều có thể làm checker, tối đa bốn cái cùng lúc. Dùng + Add checker, các mũi tên để sắp xếp lại thứ tự, và Remove để chỉnh danh sách. Nếu bạn không chọn cái nào, CLI đầu tiên đã cài theo thứ tự đó sẽ được dùng.

Mỗi checker có model riêng (từ v1.75.0). Mở dropdown cạnh agent để chọn một model, hoặc để nguyên Default model để dùng mặc định của CLI.

Checker chạy headless, với quyền hạn chế và trong một thư mục trung lập. Chúng phân loại màn hình và trả lời bằng một dòng JSON, và không bao giờ động vào project của bạn. Nội dung màn hình chỉ được gửi cho checker sau khi bạn đã đồng ý cho phép đọc màn hình một lần.

Autopilot (failed tasks)

Autopilot khởi động lại một agent đã chết hoặc mất kết nối giữa chừng tác vụ. Nó khôi phục session của agent hoặc chuyển tác vụ sang agent dự phòng của ghế. Nó không bao giờ trả lời câu hỏi và không bao giờ gõ vào picker. Mặc định nó tắt. Chuyển thẻ Autopilot (failed tasks) sang On. Bật nó cũng đồng thời cấp quyền đồng ý đọc màn hình mà Chẩn đoán AI sử dụng.

Khi đã bật, thẻ hiển thị Watching. Acts only when a running task goes quiet, its process exits, or a message to it stalls. Idle tabs are never checked. Nhấn How it works để xem hướng dẫn bằng hoạt ảnh.

Khi nào nó hành động

Autopilot chỉ nhìn các terminal đang chạy một prompt bạn đã gửi. Ba điều kích hoạt nó:

Nó làm gì

• Resume the session. Autopilot khởi động lại agent trong cùng terminal bằng lệnh resume riêng của CLI đó, nên cùng session và transcript sẽ quay lại. Hoạt động với Claude Code, Codex, Gemini, Cursor, OpenCode, Grok, Kimi, Qwen, Amp, Cline, Hermes, Antigravity và Qoder.
• Ask it to continue. Với After a resume, ask the agent to continue bật (mặc định), agent được khôi phục nhận đúng một chỉ thị: tiếp tục từ chỗ đã dừng, không làm lại các bước đã hoàn thành, và kiểm tra kết quả của bước bị gián đoạn trước khi lặp lại.
• Switch to backup. Nếu tab không thể khôi phục — do lỗi nghiêm trọng hoặc không còn session để khôi phục — một ghế chart có agent dự phòng sẽ bàn giao tác vụ kèm brief. Tab cũ vẫn mở.
• Wait for you. Nếu một câu hỏi, picker, bản nháp gõ dở hoặc rào cản đăng nhập đang trên màn hình, hoặc bất cứ điều gì chưa rõ, sẽ không có gì được gõ. Câu hỏi, picker và bản nháp đơn giản được để yên. Rào cản đăng nhập và màn hình không rõ sẽ gửi thông báo cho bạn.

Giới hạn thử lại

Autopilot chờ 5 giây trước lần khởi động lại đầu tiên. Nếu cùng prompt đó lại lỗi, nó chờ 20 giây trước lần khởi động lại thứ hai và 60 giây trước lần thứ ba. Sau đó nó dừng và báo cho bạn qua một Activity card ghi Stopped retrying "…" after 3 resumes; waiting on you. Một prompt mới từ bạn sẽ reset bộ đếm. Không terminal nào bị khởi động lại quá 6 lần trong một giờ.

Recent decisions

Recent decisions liệt kê 5 hành động gần nhất trên máy này. Mỗi hàng hiển thị thời gian, prompt, project và lý do, kèm badge: Resumed, Switched to backup, Couldn't resume, Continued, Stopped retrying hoặc Waiting on you. Các Activity card mang chip Autopilot. Sổ cái đầy đủ là append-only và được ghi vào ~/.1devtool/orchestration/autopilot-ledger.jsonl.

Pause hoặc Off

• Pause ngăn Autopilot khôi phục hoặc chuyển bất cứ thứ gì cho đến khi bạn bỏ pause. Việc chuyển sang dự phòng từ Diagnose & restore stuck agents vẫn chạy.
• Off dừng Autopilot và xóa mọi trạng thái pause.

Để tắt Autopilot cho một lần chạy mà không đổi cài đặt, khởi động 1DevTool với ONEDEVTOOL_AUTOPILOT=off. Thẻ khi đó hiển thị Off for this launch.

Liên quan

• Orchestration Dashboard
• Build a Team, nơi đặt agent dự phòng cho từng ghế
• Resume Sessions
• Mission Control