AI 진단 및 Autopilot

에이전트가 작동을 멈추는 방식은 두 가지입니다. 살아 있지만 멈춘 상태일 수 있습니다. 할당량 벽, 로그인 프롬프트 또는 업셀 모달이 화면에 떠 있어 메시지가 전달되지 않는 경우입니다. 또는 완전히 종료될 수 있습니다. 연결이 끊기거나 CLI가 작업 도중 종료되는 경우입니다. AI Diagnosis(AI 진단)는 첫 번째 경우를, Autopilot은 두 번째 경우를 처리합니다. 둘은 같은 곳에 있습니다.

상단 바에서 Orchestration Dashboard를 열거나, Command Palette에서 Open Orchestration Dashboard를 실행한 다음 Advanced → AI Diagnosis를 선택하세요. Tutorials → How-to → Autopilot으로 바로 이동할 수도 있습니다.

Diagnose & restore stuck agents(멈춘 에이전트 진단 및 복구)

에이전트 터미널로의 전달이 약 2분 동안 계속 실패하면, 설치된 AI CLI가 해당 터미널의 화면 텍스트를 읽고 무엇이 잘못됐는지 알려줍니다. 전달은 15초마다 재시도되며, 8번째 실패가 진단을 트리거합니다. 터미널이 백업 에이전트가 있는 차트 시트에 있다면 시트가 자동으로 전환됩니다. 그 외의 모든 터미널은 진단 결과를 알림으로 받으므로 조치를 취할 수 있습니다. 정상 터미널은 검사하지 않습니다.

Diagnose & restore stuck agents는 기본적으로 켜져 있으며, 모든 팀, 차트, 연결된 터미널에 앱 전체로 적용됩니다. How to restore에서 다음 중 선택하세요:

• With AI (recommended): checker AI가 먼저 멈춘 터미널의 화면을 읽고, 확인된 할당량 또는 로그인 벽만 복구를 트리거합니다. 그냥 바쁜 에이전트는 절대 방해하지 않습니다.
• Manual timer — no AI: 만료 시간만으로 복구합니다. 더 빠르고 완전히 로컬에서 동작하지만, 멈춘 에이전트와 긴 작업을 수행 중인 에이전트를 구분할 수 없습니다.

Checker 에이전트(순서대로)

Checker는 하나씩 시도됩니다. checker가 설치되어 있지 않거나, 자체 한도에 도달하거나, 시간이 초과되면 다음 checker가 이어받습니다. 멈춘 터미널 자체의 제공자는 항상 건너뛰므로 에이전트가 자기 자신을 평가하는 일은 없습니다. Claude, Codex, Gemini, OpenCode, Qwen, Kimi, Grok, Hermes가 모두 checker가 될 수 있으며, 한 번에 최대 4개까지 가능합니다. + Add checker, 순서를 바꾸는 화살표, Remove로 목록을 구성하세요. 아무것도 선택하지 않으면 해당 순서에서 첫 번째로 설치된 CLI가 사용됩니다.

각 checker는 자체 모델을 가집니다(v1.75.0부터). 에이전트 옆의 드롭다운을 열어 하나를 선택하거나, Default model로 두어 CLI의 기본값을 사용하세요.

Checker는 헤드리스로 실행되며, 제한된 권한으로 중립 디렉터리에서 동작합니다. 화면을 분류하고 JSON 한 줄로 답하며, 프로젝트는 절대 건드리지 않습니다. 화면 텍스트는 1회성 화면 읽기 동의를 완료한 후에만 checker로 전송됩니다.

Autopilot (failed tasks)(실패한 작업)

Autopilot은 작업 도중 종료되거나 연결이 끊긴 에이전트를 다시 시작합니다. 에이전트의 세션을 재개하거나 작업을 시트의 백업으로 전환합니다. 질문에 답하거나 picker에 입력하는 일은 없습니다. 기본적으로 꺼져 있습니다. Autopilot (failed tasks) 카드를 On으로 전환하세요. 켜면 AI Diagnosis가 사용하는 화면 읽기 동의도 함께 부여됩니다.

켜지면 카드에 *Watching. Acts only when a running task goes quiet, its process exits, or a message to it stalls. Idle tabs are never checked.*라고 표시됩니다. How it works를 누르면 애니메이션 안내를 볼 수 있습니다.

작동하는 경우

Autopilot은 보낸 프롬프트를 처리 중인 터미널만 살핍니다. 세 가지가 이를 트리거합니다:

수행하는 작업

• Resume the session. Autopilot은 같은 터미널에서 해당 CLI 자체의 resume 명령으로 에이전트를 다시 시작하므로, 같은 세션과 트랜스크립트가 돌아옵니다. Claude Code, Codex, Gemini, Cursor, OpenCode, Grok, Kimi, Qwen, Amp, Cline, Hermes, Antigravity, Qoder에서 작동합니다.
• Ask it to continue. After a resume, ask the agent to continue가 켜져 있으면(기본값), 재개된 에이전트는 하나의 지시를 받습니다. 중단된 곳에서 계속하고, 완료된 단계를 다시 수행하지 않으며, 중단된 단계를 반복하기 전에 그 결과를 확인하는 것입니다.
• Switch to backup. 치명적 오류 때문에, 또는 재개할 세션이 없어 탭이 재개할 수 없으면, 백업 에이전트가 있는 차트 시트가 작업을 브리프와 함께 넘겨받습니다. 이전 탭은 열린 상태로 유지됩니다.
• Wait for you. 질문, picker, 반쯤 입력된 초안 또는 로그인 벽이 화면에 있거나 다른 무언가가 불분명하면 아무것도 입력하지 않습니다. 질문, picker, 초안은 그냥 그대로 둡니다. 로그인 벽과 불분명한 화면은 알림을 보냅니다.

재시도 한도

Autopilot은 첫 번째 재시작 전에 5초를 기다립니다. 같은 프롬프트가 다시 실패하면 두 번째 재시작 전에 20초, 세 번째 전에 60초를 기다립니다. 그 후에는 중단하고 *Stopped retrying "…" after 3 resumes; waiting on you.*라는 Activity 카드로 호출합니다. 새 프롬프트를 내면 카운트가 초기화됩니다. 어떤 터미널도 1시간에 6번 이상 재시작되지 않습니다.

Recent decisions(최근 결정)

Recent decisions는 이 머신에서의 최근 5개 작업을 나열합니다. 각 행은 시간, 프롬프트, 프로젝트, 이유를 배지와 함께 보여줍니다. Resumed, Switched to backup, Couldn't resume, Continued, Stopped retrying, Waiting on you입니다. Activity 카드에는 Autopilot 칩이 붙습니다. 전체 원장은 추가 전용이며 ~/.1devtool/orchestration/autopilot-ledger.jsonl에 기록됩니다.

Pause 또는 Off

• Pause는 다시 시작하기 전까지 Autopilot이 무엇이든 재개하거나 전환하는 것을 막습니다. Diagnose & restore stuck agents의 백업 전환은 계속 실행됩니다.
• Off는 Autopilot을 중지하고 모든 일시 중지를 해제합니다.

설정을 변경하지 않고 한 번의 실행에만 Autopilot을 끄려면 ONEDEVTOOL_AUTOPILOT=off로 1DevTool을 시작하세요. 그러면 카드에 *Off for this launch.*라고 표시됩니다.

관련 문서

• Orchestration Dashboard
• 시트별로 백업 에이전트를 설정하는 Build a Team
• Resume Sessions
• Mission Control