Agent Switchboard
내려받기

언어

고른 언어는 쿠키에 기억해 둡니다.

테마
가이드 문서

스위처와 오케스트레이션

스위처란

스위처(Switcher)를 쓰면 터미널 대신 대화 화면에서 코딩 에이전트와 일할 수 있습니다. 에이전트의 계획과 도구 실행, 바뀐 파일, 승인 요청, 사용량이 대화 안에 함께 보여서 무슨 일이 일어나는지 따라가기 쉽습니다.

스위처 대화에 쓸 수 있는 엔진은 Claude Code, Codex, Antigravity(agy), OpenCode, GitHub Copilot CLI이고, 이 가운데 Claude Code·Codex·Antigravity에는 추천 표시가 붙습니다. 되돌리기, 목표, 첨부, 응답 중 입력 같은 기능은 엔진마다 지원 여부가 다릅니다. 지원하지 않는 기능에는 이유가 표시됩니다.

새 대화 시작하기

  1. 왼쪽 레일에서 프로젝트 줄의 ⋯ 메뉴를 엽니다.
  2. 새 세션에서 도구를 고릅니다.
  3. 스위처를 지원하는 도구는 CLI 세션과 Switcher 세션이 따로 있습니다. Switcher를 고르면 그 도구를 엔진으로 이 프로젝트에 새 대화가 열립니다.

새 대화는 폴더 기본값으로 시작하고, 폴더 값이 없으면 전역 기본값을 씁니다. 기본값 정하는 방법은 연결·프로젝트별 설정의 「스위처 새 대화 기본값」을 참고하세요.

대화 안에서 쓰는 기능

모델과 추론 강도 바꾸기

모델과 추론 강도(Effort)는 입력창 위에서 고릅니다. 모델은 목록에서 검색하거나 ID를 직접 입력해도 됩니다. 바꾼 값은 다음 메시지부터 적용되며, 응답이나 승인을 처리하는 동안에는 바꿀 수 없습니다.

추론 강도는 고른 모델과 실행 도구가 지원한다고 확인된 범위 안에서만 고를 수 있습니다. 지원 여부를 확인하지 못하면 도구 기본값으로 보내고 그 사실을 안내합니다.

실행 도구 바꾸기

대화를 이어 가면서 실행 도구만 다른 도구로 바꿀 수 있습니다. 세션과 관계는 그대로 두고, 필요하면 원래 도구의 압축과 작업 요약으로 문맥을 넘깁니다. 전환에 실패하거나 문맥을 넘길 공간이 모자라면 기존 세션을 건드리지 않습니다.

휴대폰에서는 대화 모델 바꾸기에서 프로바이더 → 도구 → 모델 순서로 고릅니다. 고른 프로바이더는 이 대화에만 적용되고 프로젝트 설정은 그대로입니다.

명령 메뉴

대화 중에 Ctrl+/를 누르면 명령 메뉴가 열립니다. /help, /new, /stop, /model, /status, /search, /copy, /export, /retry, /clear를 쓸 수 있고, 지금 실행할 수 없는 명령에는 이유가 함께 나옵니다.

대화 정보

머리줄의 대화 정보를 열면 환경, 컨텍스트 사용량, 브랜치, 할 일, 바뀐 파일과 diff, 서브 에이전트, 백그라운드 작업을 한곳에서 볼 수 있습니다.

대화 이어 가기

앱을 다시 열면 스위처 대화 목록과 화면 배치가 그대로 돌아옵니다. 이어 갈 대화에서 재연결을 누르면 하던 대화를 계속할 수 있습니다. 목록만 불러올 때는 CLI를 실행하지 않습니다.

AI 코드리뷰

커밋하기 전에 스위처의 ⋯ 더보기 → AI 코드리뷰에서 변경 내용을 검토받을 수 있습니다. API 키를 저장해 둔 연결과 모델을 고르고 리뷰 실행을 눌러야 변경 내용이 그 연결로 전송됩니다. 화면을 열거나 새로 고치기만 해서는 모델을 부르지 않습니다.

음성 대화

환경 설정 › 음성 대화를 켜고 OpenAI API 연결을 고르면, 스위처 머리줄의 음성 대화로 지금 세션과 말로 주고받을 수 있습니다. 이 기능은 처음에 꺼져 있습니다. 음성은 사용자의 OpenAI API 키로 OpenAI에 바로 전송되고, 요금도 그 키로 나갑니다. 작업 멈추기와 승인은 화면에서 한 번 더 확인해야 실행됩니다.

오케스트레이션

오케스트레이션을 쓰면 스위처 대화 하나가 지휘 세션(coordinator)이 되어 다른 세션을 작업 세션(worker)으로 만들고 일을 맡깁니다. 큰 작업을 여러 세션에 나눠 맡기고 한곳에서 챙길 수 있습니다. 작업 세션은 결과를 보고하거나 지휘 세션에 질문할 수 있습니다.

지휘 세션 지정하기

  1. 지휘를 맡길 스위처 대화를 엽니다.
  2. 오케스트레이션 세션으로 지정을 누릅니다.
  3. 오케스트레이션 권한 선택에서 방식을 고릅니다.
    • 사용자 승인 후 위임: 작업 세션을 만들거나 지시를 보내기 전에 사용자가 확인합니다.
    • 전체 자율 위임 승인: 명시적으로 위임한 입력은 따로 승인받지 않고 전달합니다.

권한을 고르거나 승인·철회하는 일은 사용자 화면에서만 할 수 있습니다. 엔진의 원래 승인 규칙과 작업 폴더 제한은 그대로 적용되고, 정책은 이 PC에 암호화해 저장합니다.

작업 세션과 업무

  • 지휘 세션은 등록된 프로젝트에 작업 세션을 새로 만들거나, 지난 세션을 작업 세션으로 다시 엽니다. 만들 때 모델과 추론 강도도 정할 수 있습니다.
  • 새 작업 세션은 레일의 프로젝트 아래에 한 줄로 나타나고, 지금 보던 화면을 가리지 않도록 백그라운드 스위처 탭으로 열립니다.
  • 작업 세션이 바쁠 때 보낸 지시와 답변은 대기열에 두었다가 순서대로 전달합니다.
  • 지휘 세션은 사용자 요청을 지휘 할 일로 적어 두고 작업 세션의 업무와 연결합니다. 작업 세션이 보고한 진행률과, 지휘 세션이 결과를 확인한 완료는 따로 표시됩니다.

대시보드와 관계도

지휘 세션에서 오케스트레이션 대시보드를 열면 지휘·팀장·작업 세션 관계도와 업무·전달 상태, 결정 기록이 보입니다. 전달 상태는 「승인 대기」, 「전달 중」, 「입력 접수 · 완료 미확인」, 「실행 여부 불명」, 「완료」처럼 실제로 확인한 단계까지만 나옵니다. 실행됐는지 모르는 요청은 자동으로 다시 보내지 않습니다.

오케스트레이션 대시보드와 할 일은 PWA·Android 앱에서도 확인하고 다룰 수 있습니다.

팀장 권한

지휘 세션은 바로 아래 작업 세션에 팀장 권한을 줄 수 있습니다. 팀장은 정해진 프로젝트와 동시 실행 상한 안에서 자기 아래 작업 세션을 관리합니다. 권한을 거둬도 아래 세션의 대화와 실행은 그대로 남습니다.

다른 PC에 맡기기

레일 내 컴퓨터로 연결해 둔 같은 계정의 다른 PC에도 작업 세션을 만들 수 있습니다. 이때 받는 PC에서도 오케스트레이션 권한을 정해 두어야 합니다.

  • 받는 PC가 위임마다 승인이면 그 PC에서 승인해야 실행됩니다. 기한 안에 응답이 없으면 거절됩니다.
  • 받는 PC가 자율 위임이면 바로 실행됩니다.

같은 요청은 한 번만 실행합니다. 중간에 응답을 놓쳐도 그 PC의 기록으로 도착했는지 맞춰 봅니다. 다른 PC도 같은 버전 이상이어야 합니다.

정리 규칙

  • 종료는 Switchboard가 띄운 프로세스만 멈춥니다. 대화와 재개 정보, 관계는 남습니다.
  • 쉬고 있는 작업 세션은 기본 15분이 지나면 프로세스를 종료합니다. 결과를 보고한 뒤 자동 종료된 작업 세션은 기본 60분 뒤 보관함으로 옮깁니다.
  • 승인이나 질문, 확인을 기다리는 업무는 자동으로 정리하지 않습니다.
  • 탭 닫기로는 세션이 끝나지 않습니다. 보관함에 들어간 세션도 복원하면 다시 이어 갈 수 있습니다.

감독 방식(사용자 승인 후 위임)에서는 이런 정리에도 사용자 승인이 필요합니다.