TL;DR

  • Docker Agent는 코드 작성 없이 YAML 설정으로 AI 에이전트를 만들고 실행하며 공유하는 Docker CLI 플러그인임.
  • 에이전트 팀이 작업을 자동 위임하는 멀티 에이전트 아키텍처와 로컬·원격·Docker 기반 MCP 서버를 포함한 도구 생태계를 제공함.
  • OpenAI, Anthropic, Gemini, AWS Bedrock, Mistral, xAI, Docker Model Runner 등 다양한 모델 제공자를 지원함.
  • think, todo, memory 도구와 BM25, 임베딩, 하이브리드 검색, 재순위를 포함하는 플러그형 검색 증강 생성(RAG) 기능을 갖춤.
  • 에이전트를 OCI 레지스트리에 푸시하고 어디서든 가져와 실행할 수 있으며, Docker Desktop 4.63 이상에는 CLI 플러그인이 사전 설치됨.

Docker Agent란?

  • docker-agent는 복잡한 문제 해결을 위해 협업하는 지능형 AI 에이전트를 코드 없이 만들고 실행하는 도구임.
  • Docker CLI 플러그인이며 docker agent 명령으로 실행함.
  • 에이전트를 YAML로 정의하고 도구를 제공해 작업을 수행하게 하는 방식임.
  • 예시 설정은 root 에이전트에 openai/gpt-5-mini 모델, 설명과 지침을 지정하고 docker:duckduckgo MCP 도구 모음을 연결함.
  • docker agent run agent.yaml 명령으로 설정 파일의 에이전트를 실행함.

주요 기능

  • 멀티 에이전트 아키텍처 — 전문화된 에이전트 팀을 만들고 작업을 자동 위임하는 기능임.
  • 풍부한 도구 생태계 — 내장 도구와 로컬·원격·Docker 기반 MCP 서버를 이용하는 기능임.
  • AI 제공자 독립성 — OpenAI, Anthropic, Gemini, AWS Bedrock, Mistral, xAI, Docker Model Runner 등을 지원하는 구성임.
  • YAML 설정 — 선언적이며 버전 관리와 공유가 가능한 설정 방식임.
  • 고급 추론 — 내장 think, todo, memory 도구를 포함함.
  • RAG — BM25, 임베딩, 하이브리드 검색, 재순위 기능을 갖춘 플러그형 검색 방식임.
  • 패키징 및 공유 — 에이전트를 OCI 레지스트리에 푸시하고 어디서든 가져와 실행하는 기능임.

설치

  • Docker Desktop 4.63 이상에는 docker-agent CLI 플러그인이 사전 설치되어 있으며 docker agent 명령으로 실행함.
  • Homebrew 설치 명령은 brew install docker-agent임. docker-agent를 직접 실행하거나 바이너리를 ~/.docker/cli-plugins/docker-agent에 심볼릭 링크해 docker agent로 실행할 수 있음.
  • 바이너리 릴리스는 GitHub Releases에서 다운로드할 수 있음. docker agent를 사용하려면 바이너리를 ~/.docker/cli-plugins/docker-agent에 심볼릭 링크하거나 docker-agent를 직접 실행하면 됨.
  • API 키를 하나 이상 설정하거나 로컬 모델용 Docker Model Runner를 사용해야 함. 예시는 OPENAI_API_KEY이며 ANTHROPIC_API_KEY, GOOGLE_API_KEY 등도 사용할 수 있음.
  • 클라우드 API 키 또는 로컬 모델 설정 절차는 ‘모델 설정’ 안내에서 확인할 수 있음.

빠른 시작

  • 기본 에이전트 실행은 docker agent run 명령임.
  • OCI 레지스트리 에이전트 실행은 docker agent run myorg/agent:tag 명령임.
  • 대화형으로 새 에이전트 생성은 docker agent new 명령임.
  • 자체 설정 파일 실행은 docker agent run agent.yaml 명령임.
  • 추가 예시는 examples/ 디렉터리에 있음.

문서

  • 전체 문서에는 설치, 모델 설정, 빠른 시작 안내가 포함됨.
  • 에이전트, 모델, 도구, 멀티 에이전트, 설정 참조 문서를 제공함.
  • TUI, CLI, MCP 모드, RAG, 모델 제공자, Docker Model Runner 문서를 제공함.

기여

  • 기여를 시작하려면 기여 안내서를 확인하면 됨.
  • Docker Agent는 docker agent run ./golang_developer.yaml 명령을 사용해 Docker Agent 자체를 빌드함.

텔레메트리

  • 도구 개선을 위해 익명 사용 데이터를 수집함.
  • 자세한 내용은 텔레메트리 안내에서 확인할 수 있음.

커뮤니티

  • Docker Community Slack의 #docker-agent 채널에서 커뮤니티에 참여할 수 있음.