Chẩn đoán AI & Autopilot

Tìm hiểu vì sao một agent bị kẹt, chuyển seat sang agent dự phòng, và để Autopilot tự động chạy lại agent bị crash hoặc mất kết nối giữa chừng.

Một agent có thể ngừng làm việc theo hai cách. Nó có thể vẫn còn sống nhưng bị kẹt: màn hình đang hiện giới hạn quota, lời nhắc đăng nhập hoặc cửa sổ chào bán nâng cấp, và tin nhắn của bạn không thể đến nơi. Hoặc nó có thể chết hẳn: kết nối bị ngắt hoặc CLI thoát giữa chừng một tác vụ. AI Diagnosis xử lý trường hợp đầu và Autopilot xử lý trường hợp sau. Cả hai nằm cùng 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 đưa bạn thẳng đến đó.

Cài đặt AI Diagnosis với Diagnose & restore stuck agents đang bật On, chọn With AI, và danh sách các checker agent theo thứ tự — Claude dùng claude-opus-5 và Codex dùng gpt-5.6-sol — mỗi agent có bộ chọn model riêng

Diagnose & restore stuck agents

Khi việc gửi tin đến một 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 văn bản trên màn hình terminal đó và cho biết sự cố là gì. Việc gửi được thử lại mỗi 15 giây, và lần lỗi thứ tám sẽ kích hoạt chẩn đoán. Nếu terminal nằm trong một seat của chart có agent dự phòng, seat sẽ tự động chuyển sang agent đó. Mọi terminal khác sẽ nhận kết quả chẩn đoán dưới dạng thông báo để bạn tự xử lý. Các terminal hoạt động bình thường sẽ không bao giờ bị kiểm tra.

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

  • With AI (recommended): một checker AI đọc màn hình của terminal bị kẹt trước, và chỉ khi xác nhận có giới hạn quota hoặc yêu cầu đăng nhập thì mới 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ỉ cần hết thời gian chờ là khôi phục. Cách này nhanh hơn và hoàn toàn chạy cục bộ, nhưng không phân biệt được agent bị treo với agent đang bận một tác vụ dài.

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 hết thời gian, checker tiếp theo sẽ đảm nhậ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 đặt theo thứ tự đó sẽ được dùng.

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

Các checker chạy ở chế độ headless, với quyền hạn bị 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 đến dự án của bạn. Văn bản trên màn hình chỉ được gửi đến 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 một tác vụ. Nó tiếp tục phiên của agent hoặc chuyển tác vụ sang agent dự phòng của seat. Nó không bao giờ trả lời câu hỏi và không bao giờ gõ vào một picker. Mặc định tính năng này tắt. Hãy chuyển thẻ Autopilot (failed tasks) sang On. Bật tính năng này cũng đồng thời cấp quyền đồng ý đọc màn hình mà AI Diagnosis sử dụng.

Thẻ Autopilot (failed tasks) trong Agent Orchestration → AI Diagnosis, đang bật On và Watching, với các ô Resume the session, Switch to backup và Wait for you phía trên danh sách Recent decisions gồm các agent đã được resume

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 phần hướng dẫn minh họa động.

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

Autopilot chỉ xem xét các terminal đang xử lý một prompt mà bạn đã gửi. Ba tình huống sẽ kích hoạt nó:

TriggerĐiều kiện
The process exitsCLI thoát với lỗi trong khi một prompt vẫn chưa hoàn thành. Việc chủ động thoát bằng /exit hoặc Ctrl-D là thoát bình thường và sẽ được bỏ qua.
The task goes quietMột tác vụ đang chạy ngừng xuất dữ liệu, và một checker đọc màn hình để xác nhận nó thực sự bị kẹt.
A message stallsViệc gửi tin liên tục thất bại và AI Diagnosis báo cáo kết nối bị ngắt.

Nó làm gì

  • Continue in place. Từ v1.76.1, khi kết nối của một agent Devin bị ngắt nhưng tiến trình vẫn đang chạy và lỗi của chính nó yêu cầu một tin nhắn để tiếp tục, bước đầu tiên của Autopilot là gửi tin nhắn đó ngay tại chỗ — không dừng gì và không khởi chạy lại gì. Việc khởi động lại một tiến trình như vậy chỉ làm dừng một CLI đang chạy tốt và tranh chấp khóa phiên của nó; trên thực tế nó đã gây ra 40 lần khởi động lại Devin trong bốn ngày so với 6 lần của Claude. Một tác vụ bị kẹt lần nữa sau khi continue tại chỗ sẽ được khởi động lại như bình thường.
  • 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 một phiên và transcript được khôi phục. Cách này hoạt động với Claude Code, Codex, Gemini, Cursor, OpenCode, Grok, Kimi, Qwen, Amp, Cline, Hermes, Antigravity và Qoder. Sau đó Autopilot xác nhận tiến trình thay thế thực sự đang chạy trước khi làm tiếp — thông báo thoát từ tiến trình cũ đến muộn không còn có thể âm thầm xóa tiến trình mới và để lại một agent chạy mà không có đầu ra.
  • Ask it to continue. Khi bật After a resume, ask the agent to continue (mặc định), agent được resume sẽ nhận một chỉ thị duy nhất: 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 một bước bị gián đoạn trước khi lặp lại nó.
  • Switch to backup. Nếu tab không thể resume, do lỗi nghiêm trọng hoặc do không có phiên nào để resume, một seat của chart có agent dự phòng sẽ bàn giao tác vụ cùng bản brief của nó. Tab cũ vẫn được giữ mở.
  • Wait for you. Nếu trên màn hình có một câu hỏi, một picker, một bản nháp đang gõ dở hoặc một yêu cầu đăng nhập, hoặc bất cứ điều gì khác không rõ ràng, sẽ không có gì được gõ vào. Câu hỏi, picker và bản nháp chỉ đơn giản được để yên. Yêu cầu đăng nhập và các màn hình không rõ ràng 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 thất bạ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 lại và báo cho bạn bằng một thẻ Activity với nội dung Stopped retrying "…" after 3 resumes; waiting on you.

Số lần thử được tính theo từng sự cố — theo từng tác vụ lỗi, không phải theo từng lần gửi. Tin nhắn tiếp theo "continue where you left off" của chính Autopilot mang sự cố đi tiếp với số lần thử được giữ nguyên, nên một tác vụ bị kẹt không còn có thể bị dừng và resume lặp đi lặp lại chỉ vì Autopilot cứ đặt lại đồng hồ của chính nó (trước v1.76.1, một tab có thể trải qua bốn chu kỳ trong bảy phút). Một lần continue tại chỗ cũng được tính là một lần thử của cùng sự cố đó. Chỉ một prompt mới từ bạn mới bắt đầu một sự cố mới và đặt lại bộ đếm.

Ngoài ra, một terminal chỉ được continue hoặc resume tối đa 6 lần trong một giờ. Vượt quá mức đó, Autopilot sẽ chờ và báo cho bạn: "Agent name" has been continued or resumed 6 times this hour; Autopilot is waiting on you.

Recent decisions

Recent decisions liệt kê 5 hành động gần nhất trên máy này. Mỗi dòng hiển thị thời gian, prompt, dự án và lý do, kèm một huy hiệu: Resumed, Switched to backup, Couldn't resume, Continued, Stopped retrying hoặc Waiting on you. Các thẻ Activity mang chip Autopilot. Toàn bộ sổ ghi chỉ cho phép thêm vào cuối và được ghi tại ~/.1devtool/orchestration/autopilot-ledger.jsonl.

Pause hoặc Off

  • Pause ngăn Autopilot resume hoặc chuyển bất cứ thứ gì cho đến khi bạn bỏ tạm dừng. Việc chuyển sang agent 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 tạm dừng.

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

Related