LEVEL11

문서

에이전트

채팅·빌더·자동 실행 모드, 승인과 허용 목록, 체크포인트와 되돌리기, 계획과 진행, 도구 호출이 패널에 보이는 방식.

세 가지 모드

세션마다 모드를 고릅니다. 작성기의 모드 선택이나 설정의 기본 모드에서 바꿉니다.

  • 채팅(Chat): 읽기 전용. 파일 읽기, 목록, 검색, 웹 가져오기만 씁니다. 파일을 고치거나 명령을 실행하지 않고, 바꿀 내용을 코드로 설명한 뒤 빌더 모드로 바꾸라고 권합니다. MCP 도구도 이 모드에서는 붙지 않습니다.
  • 빌더(Builder): 파일을 직접 고칩니다. 매 턴이 체크포인트로 남고, 명령은 허용 목록에 없으면 실행 전에 승인을 묻습니다.
  • 자동 실행(Auto-Run): 파일 편집과 명령 실행을 묻지 않고 끝까지 갑니다. 다만 위험한 명령은 이 모드에서도 승인을 거칩니다.

승인과 허용 목록

빌더 모드에서 승인을 묻는 것들:

  • 명령 실행(run_command) 전부. 단, 설정의 명령 허용 목록에 있는 접두어로 시작하는 명령은 묻지 않습니다. 기본 목록은 ls, cat, pwd, git status, git diff, git log, npm test, npm run, node --version이고 한 줄에 하나씩 더할 수 있습니다.
  • 워크스페이스 밖의 파일 쓰기·편집, 파일 삭제.
  • MCP 서버의 도구 호출.

승인 요청에는 어떤 명령인지, 어떤 경로인지가 그대로 표시됩니다. rm -rf /, mkfs, dd if=, 포크 폭탄, shutdown, reboot 같은 명령은 위험한 명령으로 분류되어 자동 실행 모드에서도 승인 없이는 실행되지 않습니다.

체크포인트와 되돌리기

빌더·자동 실행 모드에서는 에이전트의 매 턴이 체크포인트입니다. 턴 옆의 되돌리기 버튼을 누르면 그 턴에서 바뀐 파일들이 턴 이전 상태로 복원되고, 몇 개 파일이 돌아갔는지 알려 줍니다. 어떤 턴으로든 돌아갈 수 있으니 자동 실행으로 길게 맡겨도 마음에 들지 않으면 한 번에 거둘 수 있습니다. DiffView 도구에서는 에이전트의 최근 편집을 전/후로 비교할 수 있습니다.

계획과 진행

여러 단계가 필요한 작업에서 에이전트는 todo_write로 짧은 계획을 적고 진행하면서 갱신합니다. 패널 위의 계획 띠에서 어디까지 왔는지 보입니다. 내장 Planner 에이전트 프리셋은 편집 전에 먼저 번호 매긴 계획을 세우도록 되어 있습니다.

도구 호출이 보이는 방식

에이전트 패널은 글과 도구 호출이 시간 순으로 섞인 타임라인입니다. 도구 호출은 접힌 카드로 나오고, 펼치면 입력과 출력을 볼 수 있습니다. 파일 편집에는 편집별 diff가 붙고, 사고 과정은 요약으로, 턴마다 토큰 사용량이 표시됩니다. 응답은 스트리밍됩니다.

내장 도구는 read_file, list_dir, search_by_regex, find_files, write_to_file, edit_file, delete_file, run_command(전경·배경), check_command_status, todo_write, web_fetch, open_preview입니다. open_preview는 개발 서버를 인앱 Browser 도구에 띄웁니다. 여기에 연결한 MCP 서버의 도구가 더해집니다.

세션과 에이전트 프리셋

세션은 워크스페이스별로 저장되고, 패널의 세션 목록에서 바꾸거나 새로 만들거나 지웁니다. 대화 기록은 제공자 중립 형식이라 세션 도중에 모델을 바꿔도 도구 호출과 결과가 이어집니다. 작성기에서 에이전트 프리셋(Planner, Code Reviewer, Test Writer, Docs Writer, 커머스 빌더, 또는 직접 만든 것)을 고르면 그 프리셋의 시스템 프롬프트와 기본 모델·모드가 적용됩니다. 프리셋과 규칙은 규칙과 MCP에서 다룹니다.