코워크 컨테이너 모드¶

코워크 설정 > 서브 에이전트 실행 모드에서 컨테이너를 선택하면 다음 코워크 턴의 서브 에이전트가 Docker 또는 Apple Container에서 실행됩니다. 메인 에이전트는 계속 인프로세스로 실행됩니다. 모드와 이미지, 제한시간 설정은 현재 브라우저 또는 데스크톱 프로필에 저장되며 각 턴이 시작할 때 고정됩니다.

시작 전 확인¶

• Docker를 설치하거나 Apple Container를 설정하세요.
• 스쿼드 컨테이너 모드의 안내에 따라 aigo-agent-runner:latest 이미지를 준비하거나 호환되는 사용자 지정 이미지를 선택하세요.
• 애플리케이션 라우터에서 접근할 수 있는 모델을 선택하세요.
• 허용된 폴더에서 필요한 폴더를 추가하고 하위 폴더 접근을 허용하세요. 각 폴더는 공통 마운트 허용 목록도 통과해야 합니다.

런타임, 이미지, 모델 경로를 사용할 수 없거나 마운트가 유효하지 않으면 서브 에이전트가 실패합니다. 인프로세스 실행으로 자동 전환하지 않습니다. 원격 에이전트 프로필은 컨테이너 모드를 충족할 수 없어 거부됩니다.

폴더와 자격 증명¶

컨테이너마다 전용 쓰기 가능한 임시 디렉터리가 /workspace에 마운트됩니다. 사용자의 작업 폴더를 이 위치에 쓰기 권한으로 자동 마운트하지 않습니다. 허용된 폴더는 /workspace/extra/folder-0, /workspace/extra/folder-1 순서로 마운트됩니다.

폴더 변경은 새 턴부터 적용됩니다. 기존 접근 권한을 끝내려면 실행 중인 작업을 중지하세요. 바인드 마운트는 하위 폴더도 포함하므로 비재귀 폴더 권한은 거부됩니다. 요청에 직접 지정한 추가 마운트도 거부되며, 백엔드가 시작 시점에 저장한 허용 폴더만 사용합니다. 공통 마운트 검증기는 보호된 애플리케이션 디렉터리도 차단합니다.

모델 요청은 다른 실행과 같은 애플리케이션 라우터를 사용합니다. 토큰은 선택한 모델, 프롬프트, 출력 예산으로 요청 한 번만 허용하며 재시도와 변경된 요청은 거부합니다. 사용량은 컨테이너 출력이 아닌 라우터 응답에서 집계합니다. 요청을 허용했지만 사용량을 확인할 수 없으면 프롬프트 바이트 수의 상한과 전체 출력 한도를 설정된 모델 요금으로 보수적으로 한도에 반영합니다. 실행 기록에는 추정치 경고가 남고 제공업체 보고 사용량은 비워 둡니다. 모델 요금이 없으면 달러 비용을 추정할 수 없습니다. 컨테이너에는 제공업체 API 키 대신 실행별 자격 증명 프록시 토큰이 전달됩니다. 완료, 실패, 시간 초과, 중지, 취소, 애플리케이션 종료 시 토큰이 폐기됩니다. Apple Container에서는 프록시의 Unix 소켓 릴레이를 사용합니다.

상태와 제어¶

워크스페이스 레일의 서브 에이전트 목록에 러너의 실제 준비 중, 실행 중, 완료, 실패, 시간 초과 상태가 표시됩니다. 설정한 제한시간은 전체 배치 작업에 적용됩니다. 실행 제어에서 중지할 수 있으며, 부모 실행을 중지하면 컨테이너 자식 실행도 취소됩니다.

러너는 표준 입력으로 작업 하나를 받습니다. 코워크는 후속 메시지용 IPC 디렉터리를 제공하지 않으며 컨테이너 자식 실행의 일시정지와 재개를 지원하지 않습니다. 결과와 오류는 일반 에이전트 실행 기록에서 확인하세요.

문제 해결¶

작업이 시작되지 않으면 런타임과 이미지, 라우터와 자격 증명 프록시를 확인하세요. 마운트 오류가 있으면 허용된 폴더, 하위 폴더 접근 설정, 마운트 허용 목록을 확인하세요. 번들 이미지는 파일 도구가 없어 마운트된 파일을 읽을 수 없습니다. 파일 작업에는 해당 기능을 제공하는 호환 이미지를 사용하세요.

스티어링 메시지가 에이전트에 도달하지 않음¶

컨테이너 서브 에이전트는 스티어링을 명시적으로 거부합니다. 현재 작업을 중지한 뒤 새 작업을 제출하세요. 메인 에이전트 스티어링은 계속 사용할 수 있으며 메인 에이전트에만 적용됩니다.