docker/docker-agent

Docker Agent – Docker CLI 플러그인으로서의 AI 에이전트

정의 – Docker Agent는 간단한 YAML 파일을 사용하여 AI 에이전트를 정의, 실행, 공유할 수 있는 진정한 오픈소스 도구입니다. Docker CLI 플러그인(docker agent)으로 제공되므로 컨테이너에 사용하는 것과 동일한 명령줄로 에이전트를 시작할 수 있습니다.

작동 방식 – 선언적 구성을 작성하여 다음을 지정합니다:

• 사용할 LLM 모델(OpenAI, Anthropic, Gemini, AWS Bedrock, Mistral, Docker Model Runner 등)
• 에이전트에 대한 설명 및 시스템 프롬프트
• 하나 이상의 도구 세트(예: Model Context Protocol을 통한 DuckDuckGo 검색 도구, RAG 유틸리티, 메모리, 할 일 등)

그런 다음 Docker Agent는 모델을 시작하고 요청된 도구를 연결하며, 여러 에이전트를 정의한 경우 자동으로 작업을 위임할 수 있도록 오케스트레이션합니다.

주요 기능

• 다중 에이전트 오케스트레이션 – 코드를 작성하지 않고 작업을 전달하는 전문 에이전트 팀을 구축합니다.
• 도구 생태계 – 내장 유틸리티와 MCP 호환 서비스(로컬, 원격 또는 Docker 기반)를 모두 지원합니다.
• 공급자 중립 – 클라우드 API 및 Docker Model Runner를 통한 로컬 실행 모델과 함께 작동합니다.
• YAML 전용 구성 – 버전 관리, 공유, OCI 레지스트리 저장이 쉽습니다.
• RAG 지원 – BM25, 임베딩, 하이브리드 검색 및 재순위화를 사용하는 플러그형 검색.
• 패키징 및 공유 – 에이전트 이미지를 모든 OCI 레지스트리에 푸시하고 docker agent run <image>로 어디서나 실행합니다.

설치

• Docker Desktop 4.63+에는 플러그인이 자동으로 포함됩니다.
• Homebrew: brew install docker-agent(또는 바이너리를 ~/.docker/cli-plugins/docker-agent에 심볼릭 링크).
• GitHub Releases 페이지에서 바이너리 릴리스.
• 하나 이상의 공급자 API 키를 설정합니다(예: export OPENAI_API_KEY=…).

빠른 시작

# 내장 기본 에이전트 실행
docker agent run

# OCI 레지스트리에 저장된 에이전트 실행
docker agent run myorg/agent:tag

# 새 에이전트를 대화형으로 생성
docker agent new

# 사용자 지정 YAML 정의 실행
docker agent run agent.yaml

문서 및 커뮤니티 – 전체 문서는 https://docker.github.io/docker-agent/ 에서 호스팅되며 설치, 모델 설정, 구성 참조, TUI/CLI 사용법, MCP 모드, RAG 도구 및 공급자 세부 정보를 다룹니다. 커뮤니티 지원은 Docker Slack(#docker-agent 채널)과 커뮤니티 프로젝트, 비디오, 기사 모음에서 제공됩니다.

일반적인 사용 사례 – AI 어시스턴트의 빠른 프로토타이핑, 데이터 분석 또는 자동화를 위한 다중 에이전트 파이프라인 구축, 재현 가능한 AI 워크플로우를 OCI 이미지로 패키징, 코드를 작성하지 않고 RAG 또는 사용자 지정 도구 통합 실험.