Droid 에이전트
Droid 에이전트
이 페이지는 로컬 샌드박스를 다뤄요. 클라우드 동작과 제한은 Compare local and cloud sandboxes를 참고해요. 이 가이드는 샌드박스 환경에서 Factory의 AI 코딩 에이전트인 Droid의 인증, 구성, 사용을 다뤄요.
출처: 문서
본문
공식 문서: Droid
빠른 시작 (Quick start)
샌드박스를 만들고 프로젝트 디렉터리에 대해 Droid를 실행해요.
$ sbx run droid ~/my-project
작업 공간 매개변수는 선택 사항이며 기본값은 현재 디렉터리예요.
$ cd ~/my-project
$ sbx run droid
인증 (Authentication)
Droid는 Factory 계정이 필요해요. 두 인증 방식 모두 Factory 서비스에 직접 인증해요. 다른 에이전트에서 모델 제공자 키를 제공하는 것과 달리, Factory가 Factory 계정을 통해 모델 접근을 관리해요.
- API 키: 저장된 시크릿으로 Factory API 키를 저장해요.
$ sbx secret set droid
- OAuth: API 키가 설정되지 않으면 Droid는 첫 실행 시 인터랙티브하게 인증하도록 프롬프트를 띄워요. 프록시가 OAuth 흐름을 처리하므로 자격 증명이 샌드박스 안에 저장되지 않아요.
구성 (Configuration)
샌드박스는 호스트의 사용자 수준 구성을 가져오지 않아요. 작업 디렉터리의 프로젝트 수준 구성만 샌드박스 안에서 사용할 수 있어요. 해결 방법은 "Why doesn't the sandbox use my user-level agent configuration?"을 참고해요.
기본 시작 명령
샌드박스는 암시적 플래그 없이 droid를 실행해요. -- 뒤의 인자는 그대로 전달돼요.
$ sbx run droid -- exec "fix the build"
베이스 이미지
템플릿: docker/sandbox-templates:droid-docker
승인 프롬프트 없이 실행되도록 미리 구성되어 있어요. 인증 상태는 샌드박스 재시작 후에도 유지돼요. 도구를 미리 설치하거나 환경을 커스터마이즈하려면 Customize를 참고해요.