Docker Agent

샌드박스에서 Docker Agent의 인증, 설정, 사용법을 설명해 드릴게요.

출처: 문서

본문

이 페이지는 로컬 샌드박스를 설명해요. 클라우드 동작과 제한 사항은 로컬과 클라우드 샌드박스 비교 문서를 보세요.

공식 문서: Docker Agent

빠른 시작 (Quick start)

프로젝트 디렉터리용 샌드박스를 만들고 Docker Agent를 실행해요:

$ sbx run docker-agent ~/my-project

sbx run docker-agent는 워크스페이스를 현재 디렉터리로 기본 설정하므로, 프로젝트 안에서 바로 실행해도 돼요.

마운트 없는 샌드박스(mountless sandbox)를 만들려면 워크스페이스 경로 없이 sbx create를 쓰고, 이름으로 붙여서 사용하세요.

인증 (Authentication)

Docker Agent는 여러 제공 업체(provider)를 지원해요. 사용하려는 제공 업체의 키를 저장된 시크릿(stored secrets)으로 저장해요:

$ sbx secret set openai
$ sbx secret set anthropic
$ sbx secret set google
$ sbx secret set xai
$ sbx secret set nebius
$ sbx secret set mistral
$ sbx secret set openrouter

사용할 업체만 설정하면 돼요. Docker Agent는 사용 가능한 자격 증명을 감지해 적절한 제공 업체로 요청을 라우팅해요.

설정 (Configuration)

샌드박스는 호스트의 사용자 수준 설정을 가져오지 않아요. 샌드박스 안에서는 작업 디렉터리의 프로젝트 수준 설정만 쓸 수 있어요. 해결 방법은 "샌드박스가 내 사용자 수준 에이전트 설정을 안 쓰는 이유는?" 문서를 참고하세요.

기본 시작 명령 (Default startup command)

추가 인자 없이 샌드박스는 다음을 실행해요:

docker-agent run --yolo

-- 뒤의 인자는 첫 인자가 플래그(-로 시작)일 때 기본 플래그 뒤에 추가돼요. 첫 인자가 run 서브커맨드나 설정 파일 같은 일반 단어면 기본 값을 대신 대체하므로, run --yolo를 직접 포함해 주세요:

$ sbx run --name <sandbox-name> -- run --yolo agent.yml

기본 이미지 (Base image)

샌드박스는 docker/sandbox-templates:docker-agent를 사용해요. 이 베이스 위에 자신만의 이미지를 만들려면 Base images 문서를 보세요.

더 알아보기 (Learn more)

관련 문서와 심화 내용은 원문을 참고해 주세요.