작업공간 모드¶

작업공간 모드에서는 에이전트가 Backend.AI GO 호스트의 지정한 폴더에서 도구를 실행합니다. 프로필마다 기본적으로 꺼져 있습니다. 프로젝트 자산과 사용자 지침도 별도 설정이며, 둘 다 기본적으로 꺼져 있습니다.

작업공간 모드를 사용하지 않으면 작업 디렉토리가 없는 실행은 코드 실행 샌드박스 폴더 안의 전용 폴더에서 작업하고, 명령도 샌드박스 안에서만 실행됩니다. 자세한 내용은 파일과 명령이 실행되는 위치를 참고하세요.

작업공간 활성화¶

1. 실행할 에이전트의 저장된 프로필을 엽니다.
2. 작업공간 설정을 켜고 호스트 폴더를 선택합니다.
3. 프로필을 저장한 뒤 해당 프로필로 새 에이전트 실행을 시작합니다.
4. 활성 실행의 컨텍스트 패널에 선택한 경로와 호스트 접근 경고가 표시되는지 확인합니다.

폴더 접근 권한은 저장된 프로필에서 결정합니다. 프롬프트에 경로를 적는 것만으로는 접근 권한이 생기지 않습니다. 프로필을 내보내거나 가져오면 작업공간 권한은 초기화됩니다. 게시된 에이전트 실행은 저장된 호스트 작업공간을 상속하지 않습니다. 모바일은 호스트 작업공간 모드를 지원하지 않습니다.

셸 명령 승인¶

읽기 전용 확인을 위해 임시 저장소에서 git status --short를 실행하도록 요청해 보세요. 승인 요청이 표시되면 명령을 확인하고 한 번 승인합니다. 첫 명령을 승인했더라도 다음 명령은 다시 승인을 받아야 합니다. 실행을 중지하면 해당 실행이 소유한 명령 프로세스 트리도 취소됩니다.

워크플로 스킬은 승인 후 호스트의 gh 같은 명령과 함께 제공된 스크립트를 사용할 수 있습니다. 프로그램은 호스트에 미리 설치되어 있어야 합니다. 인증 정보는 호스트 설정을 사용하며, 요청할 명령에 인증 정보를 직접 넣지 마세요. 인식 가능한 인증 정보가 들어 있는 명령은 승인 요청 전에 거부됩니다.

스킬의 allowed-tools는 호스트 셸 명령을 자동 승인하지 않습니다. 프로필의 도구 거부 설정과 조직 정책도 계속 적용됩니다. 일회성 도구 호출에는 작업공간 셸 권한을 부여할 수 없습니다. 승인과 취소를 관리할 수 있는 에이전트 실행을 사용하세요.

파일 접근 범위와 차단 작업¶

파일 도구는 저장된 작업공간 아래의 경로를 사용합니다. 활성 스킬 디렉터리는 읽을 수 있지만 쓸 수는 없습니다. 심볼릭 링크, reparse 경로 우회, 작업공간 폴더 교체는 거부됩니다. 이 파일 도구의 제한이 승인한 호스트 셸까지 격리하지는 않습니다.

셸 검사기는 인식 가능한 디스크 포맷, 원시 디스크 접근, 마운트, 계정 관리, 권한 상승, 종료 및 재시작 명령을 거부합니다. 임의의 스크립트나 실행 파일이 안전하다고 보장하지는 않습니다. macOS와 Linux에서는 /bin/sh로 실행하며, Windows에서는 프로필 로딩을 끈 고정 시스템 PowerShell을 사용합니다.

지침 파일¶

설정 > 도구 > 워크스페이스 컨텍스트에서 새 작업공간 실행에 적용할 범위를 켭니다.

두 설정 모두 처음에는 꺼져 있으며, 저장된 호스트 작업공간이 활성화된 실행에만 적용됩니다. 사용자 지침을 켜더라도 작업공간이 없는 실행에는 적용하지 않습니다. 설정 변경은 새 실행부터 반영됩니다.

프로필 지침 다음에 사용자 지침을 넣고, 이어서 작업공간의 CLAUDE.md와 AGENTS.md를 넣습니다. 선택한 루트만 읽으며, 상위 폴더와 하위 폴더의 지침은 검색하지 않습니다. @path 가져오기는 확장하지 않습니다.

지침 파일은 실행 시작 시 한 번 읽습니다. 파일당 최대 256 KiB, 합계 1 MiB를 포함하며 사용자 규칙 파일은 최대 64개입니다. 실행의 컨텍스트 화면에는 읽은 파일, 잘린 파일, 건너뛴 파일과 실패한 파일이 표시됩니다. 내용을 자를 때는 UTF-8 문자 경계를 보존합니다. 모델의 컨텍스트 한도를 알고 있고 최종 요청이 그 안에 들어가지 않으면 전송 전에 컨텍스트 오류를 표시합니다. 더 큰 컨텍스트의 모델을 선택하거나 입력을 조정한 뒤 새 실행을 시작하세요. 모델 한도를 알 수 없으면 제공자가 요청을 검증합니다.

작업공간 스킬과 에이전트¶

작업공간 확장은 현재 실행에만 속하며 전역 가져오기 목록에는 나타나지 않습니다. 실행 작업 공간 컨텍스트에서 작업공간 스킬 또는 명령을 검토하고 해당 정의 버전을 승인합니다. 승인하지 않은 스킬 또는 명령은 모델에 제공하는 목록에 포함하지 않습니다. 파일이 바뀌면 다시 검토하고 승인해야 합니다. 작업공간 에이전트는 사용 가능 상태로 표시되며 정의 승인을 사용하지 않습니다. 정의 승인은 도구 호출을 승인하지 않습니다. 승인으로 disable-model-invocation 제한을 바꾸지는 않습니다. 기존 명령 형식은 정의에서 이 값을 false로 지정해야 모델 목록에 포함됩니다.

이름이 같은 항목은 외부 확장 우선순위에 따라 선택합니다. 작업공간 항목은 출처가 같은 경우에만 전역 항목보다 우선합니다. 화면에는 백엔드에서 선택한 항목과 가려진 항목을 표시합니다.

위임받은 에이전트는 검증된 작업공간과 실행 시작 시의 지침 설정을 상속한 뒤 자신의 컨텍스트를 읽습니다. 부모의 스킬 승인은 상속하지 않습니다. 완료된 실행은 호스트 파일을 다시 열지 않고 저장된 컨텍스트 기록을 표시하며, 새로운 승인을 받지 않습니다.

헤드리스 및 모바일 동작¶

헤드리스 실행의 작업공간 경로와 사용자 지침 파일은 서버에 속합니다. 호스트 명령은 서버 계정의 도구와 인증 정보를 사용합니다. 서버에 저장된 프로필을 구성하고, 인증된 에이전트 API나 연결된 UI에서 실행을 시작한 뒤 해당 실행의 도구 승인에 응답하세요.

CLI에서 검토할 때는 실행 로컬 항목 ID와 검토 결과에 포함된 검토 해시를 사용합니다.

aigo agent inspect-extension <run-id> <item-id>
aigo agent approve-extension <run-id> <item-id> --reviewed-hash <hash>

정의 검토와 승인은 실행이 활성 상태일 때만 허용됩니다. 완료된 실행은 기록 화면에 표시할 근거를 보존하지만 새 승인을 받을 수 없습니다.

모바일은 작업공간 모드를 거부합니다. 다른 설치로 옮긴 프로필에는 작업공간 권한이 전달되지 않습니다. 새 호스트에서 폴더를 별도로 선택하고 검토하세요.