docker/docker-agent

선언적 YAML 설정, 풍부한 도구 생태계, 그리고 멀티 에이전트 오케스트레이션 (Multi-agent orchestration)을 통해 AI 에이전트를 빌드, 실행 및 공유하세요.

docker-agent는 코딩 없이도 복잡한 문제를 해결하기 위해 협업하는 지능형 AI 에이전트를 생성하고 실행할 수 있게 해줍니다.

docker-agent는 docker CLI 플러그인이며 docker agent 명령어로 실행할 수 있습니다.

YAML에서 에이전트를 정의하고, 도구를 부여한 뒤, 실행하게 하세요.

agents:
root:
model: openai/gpt-5-mini
...

docker agent run agent.yaml

멀티 에이전트 아키텍처 (Multi-agent architecture)— 작업을 자동으로 위임하는 전문화된 에이전트 팀을 구성하세요.
풍부한 도구 생태계 (Rich tool ecosystem)— 내장된 도구와 모든 MCP 서버 (로컬, 원격 또는 Docker 기반)를 지원합니다.
AI 제공자 독립성 (AI provider agnostic)— OpenAI, Anthropic, Gemini, AWS Bedrock, Mistral, xAI, Docker Model Runner 등을 지원합니다.
YAML 설정 (YAML configuration)— 선언적이며, 버전 관리가 가능하고, 공유할 수 있습니다.
고급 추론 (Advanced reasoning)— 내장된 생각(think), 할 일(todo), 메모리(memory) 도구를 제공합니다.
RAG— BM25, 임베딩 (embeddings), 하이브리드 검색 (hybrid search), 리랭킹 (reranking)을 통한 플러그형 검색을 지원합니다.
패키징 및 공유 (Package & share)— 에이전트를 모든 OCI 레지스트리에 푸시(push)하고, 어디에서나 풀(pull)하여 실행할 수 있습니다.

Docker Desktop (4.63+) — docker-agent CLI 플러그인이 사전 설치되어 있습니다. 바로 docker agent를 실행하세요.

Homebrew — brew install docker-agent를 실행하세요. docker-agent를 직접 실행하거나, 바이너리를 ~/.docker/cli-plugins/docker-agent에 심볼릭 링크 (symlink)로 연결하여 docker agent를 실행할 수 있습니다.

Binary releases — GitHub Releases에서 다운로드하세요. docker-agent 바이너리를 ~/.docker/cli-plugins/docker-agent에 심볼릭 링크로 연결하면 docker agent를 사용할 수 있으며, 또는 docker-agent를 직접 사용할 수도 있습니다.

최소 하나 이상의 API 키를 설정하세요 (또는 로컬 모델을 위해 Docker Model Runner를 사용하세요):
export OPENAI_API_KEY=sk-... # 또는 ANTHROPIC_API_KEY, GOOGLE_API_KEY 등

# 기본 에이전트 실행
docker agent run
# 에이전트 카탈로그에서 실행
...

더 많은 예제는 examples/ 디렉토리에 있습니다.

• 설치 (Installation) · 빠른 시작 (Quick Start)
• 에이전트 (Agents) · 모델 (Models) · 도구 (Tools) · 멀티 에이전트 (Multi-Agent)
• 설정 참조 (Configuration Reference)
• TUI · CLI · MCP 모드 · RAG
• 모델 제공자 (Model Providers) · Docker Model Runner

시작하려면 기여 가이드 (Contributing guide)를 읽어보세요. 우리는 docker-agent를 빌드하기 위해 docker-agent를 사용합니다:

docker agent run ./golang_developer.yaml

도구를 개선하기 위해 익명의 사용 데이터를 수집합니다. 텔레메트리 (Telemetry)를 참조하세요.