소개
소개 (Introduction)
Docker Agent는 YAML 또는 HCL 구성으로 AI 에이전트를 빌드·실행·공유하게 해주는 다중 에이전트 런타임이에요 — 글루 코드(glue code)가 필요 없답니다.
출처: 문서
본문
Docker Agent란 무엇인가? (What is Docker Agent?)
Docker Agent는 Docker의 오픈소스 도구로, 특화된 능력과 도구를 가진 AI 에이전트를 오케스트레이션해요. LLM, 도구, 워크플로를 연결하는 코드를 작성하는 대신, YAML 또는 HCL로 에이전트를 선언해요 — 모델, 성격, 도구, 협업 방식을 — 나머지는 Docker Agent가 처리해요.
- 다중 에이전트 아키텍처 — 서로 다른 작업을 특화하고 작업을 서로 위임하는 계층적 에이전트 팀 구축
- 풍부한 도구 생태계 — 파일, 셸, 메모리, todo용 내장 도구. Docker MCP 카탈로그의 어떤 MCP 서버로든 확장
- 다중 모델 지원 — OpenAI, Anthropic, Google Gemini, AWS Bedrock, Docker Model Runner, 그리고 공유 기본값이 있는 재사용 제공자 정의
- 패키징 및 공유 — 에이전트를 OCI 레지스트리에 push하고 어디서든 pull. Docker 이미지처럼
- 여러 인터페이스 — 대화형 TUI, 헤드리스 CLI, HTTP API 서버, MCP 모드, A2A 프로토콜 지원
- 보안 우선 설계 — 도구 확인 프롬프트, Docker로 컨테이너화된 MCP 도구, 클라이언트 격리, 리소스 범위 지정
왜 Docker Agent인가? (Why Docker Agent?)
수년간 다양한 프레임워크로 AI 에이전트를 구축한 Docker 팀은 계속 같은 질문을 던졌어요:
- 에이전트 구축을 덜 번거롭게 하려면? — 대부분의 에이전트가 같은 구성 요소를 사용해요. Docker Agent가 그것들을 기본 제공해요.
- 그 구성 요소를 재사용할 수 있을까? — 선언적 YAML 또는 HCL 구성은 코드를 다시 쓰지 않고 에이전트, 모델, 도구를 섞고 매치할 수 있게 해줘요.
- 에이전트를 쉽게 공유하려면? — 에이전트를 어떤 OCI 레지스트리든 push하고 단일 명령으로 어디서든 실행할 수 있어요.
Docker Agent는 오픈으로 구축되어 커뮤니티가 이 작업을 활용하고 미래에 기여할 수 있게 해요.
동작 원리 (How it works)
핵심적으로 Docker Agent는 단순한 루프를 따릅니다:
- YAML 또는 HCL로 에이전트를 정의 — 모델, 지침, 도구, 하위 에이전트.
- TUI, CLI, API로 에이전트를 실행.
- 에이전트가 요청을 처리 — 도구 호출, 하위 에이전트 위임, 단계별 추론.
- 결과가 이벤트 기반 아키텍처를 통해 실시간으로 스트리밍.
# A minimal agent definition
agents:
root:
model: openai/gpt-5
description: A helpful assistant
instruction: You are a helpful assistant.
toolsets:
- type: think
# Run it
$ docker agent run agent.yaml
Tip 바로 첫 에이전트를 만들고 싶다면 Quick Start로 바로 건너뛰세요.
다음은 무엇인가? (What's next?)
- Installation — macOS, Linux, Windows에서 Docker Agent 설치.
- Quick Start — 5분 안에 첫 에이전트 구축.