Kits
Kits
Kit는 사용자가 일하는 방식에 맞게 샌드박스를 구성할 수 있게 해줘요. 커스텀 베이스 이미지를 쓰고, 프로젝트에 필요한 도구를 추가하고, 에이전트에 그것들을 사용하는 방법을 지시할 수 있어요. 샌드박스가 접근할 수 있는 서비스, 인증 방식, 샌드박스가 시작될 때 실행되는 것도 제어할 수 있어요.
출처: 문서
본문
가용성: Early Access
Kit는 전체 환경을 정의하거나 기존 환경에 무언가를 추가할 수 있어요. 예를 들어 툴체인이나 팀의 공유 구성을 추가하는 식이에요. 그 선택을 한 번 패키징해 프로젝트 전반에 재사용하고 팀과 공유해요.
이 페이지는 sbx v0.45 이상이 필요한 v3 키트를 다뤄요. 이전 키트 형식과의 호환성은 Version compatibility를 참고해요.
Kit란 무엇인가요?
Kit는 샌드박스용 소프트웨어와 구성을 패키징해요. 디스크립터(descriptor)라고 하는 YAML 파일이 Docker Sandboxes에 키트가 필요한 것(네트워크 접근, 자격 증명, 설정 명령, 에이전트용 지시)을 알려줘요. 키트는 파일과 디스크립터를 담은 컨테이너 이미지로 게시해요. 게시된 키트는 me/my-kit:latest 같은 컨테이너 이미지 참조로 식별해요. 키트를 사용하면 sbx가 그 파일들을 준비하고 설정을 적용해요. 하나의 키트를 완전한 환경에 사용하거나, 서로 다른 부분을 기여하는 여러 키트를 조합할 수 있어요.
Kit가 할 수 있는 것
키트를 사용해 다음을 해요.
- 커스텀 에이전트를 패키징하거나 팀 프로젝트에 맞게 기존 에이전트를 구성
- 린터, 언어 런타임, 테스트 러너, 컴파일러 같은 에이전트가 필요한 도구 포함
- 린트 규칙, 편집기 설정, 헬퍼 스크립트, 참고 자료 공유
- 에이전트에 그것들을 쓰는 지시와 스킬 제공
- 네트워크 규칙과 자격 증명(내부 API, 프라이빗 패키지 레지스트리 포함)으로 에이전트를 서비스에 연결
- 시작 시 각 샌드박스를 초기화하고 에이전트의 작업을 미리보기 위한 개발 서버 같은 지원 서비스를 실행
워크로드와 믹스인 (Workloads and mixins)
키트는 샌드박스에서 두 가지 역할을 해요. 워크로드는 베이스 환경과 실행 명령을 제공하고, 믹스인은 도구나 동작을 추가해요.
| 종류 | 제공하는 것 | 사용법 |
|---|---|---|
| workload | 에이전트나 셸 같은 환경과 실행할 명령 | sbx run 또는 sbx create에 전달 |
| mixin | 추가 도구, 구성, 런타임 동작 | --kit으로 추가 |
예를 들어 이 명령은 믹스인과 함께 워크로드를 실행해요.
$ sbx run me/my-agent-kit:latest --kit me/my-mixin:latest
워크로드가 환경과 실행 명령을 제공하고, 믹스인이 그 환경에 도구와 구성을 추가해요.
Kit 세트 (Kit sets)
Kit 세트는 키트들을 하나로 결합해 게시·재사용할 수 있는 단일 키트로 만들어요. 필요한 믹스인과 함께 워크로드를 패키징해서, 당신과 팀이 하나의 참조로 환경을 실행할 수 있게 해줘요. 세트는 어떤 키트와 버전을 조합할지 지정해요. 결합된 환경을 위한 설정 명령, 에이전트 지시, 네트워크 접근, 기타 설정도 추가할 수 있어요.
세트에 워크로드가 포함되면 sbx run으로 게시된 키트를 실행해요. 믹스인만 있다면 --kit으로 워크로드에 추가해요. 키트를 실행하고 믹스인을 추가하는 방법은 Use kits를 참고해요. 자신의 조합을 커스터마이즈하고 게시하려면 Compose a kit set을 참고해요.
버전 호환성 (Version compatibility)
v3 키트는 같은 샌드박스에서 v1이나 v2 키트와 조합할 수 없어요. v3를 사용하려면 v3 워크로드를 선택하고 추가하는 모든 믹스인에 v3를 사용해요. claude, codex 같은 내장 에이전트 이름은 v2 키트를 선택해요. 이런 내장 에이전트에 v3 믹스인을 추가할 수 없어요. 예를 들어 sbx run claude --kit ./some-v3-mixin은 키트 버전을 섞으므로 실패해요. 대신 Run a kit에 나온 대로 게시된 이미지, 로컬 경로, Git 참조로 v3 워크로드를 선택해요.
v2는 내장 에이전트와 기존 v2 커스터마이즈를 포함해 계속 지원돼요. 유지보수와 마이그레이션 지침은 Kits v2를 참고해요.
다음 단계 선택하기
- Use kits — 게시된 환경을 실행하거나 워크로드와 믹스인을 조합
- Author kits — 에이전트 환경 구축, 도구 패키징, 또는 키트를 세트로 결합해 팀과 공유
- sandbox-kit-spec 저장소 탐색 — 권위 있는 v3 사양, 빌드 프론트엔드, 예시
- 내장 에이전트가 사용하는 이전 형식은 Kits v2
- 샌드박스 안에서 구성한 환경을 저장하려면 Save a sandbox as a template