Agent

주요 기능

Docker Agent는 AI 에이전트를 구축하고 실행하기 위한 다양한 기능을 제공합니다.

멀티 에이전트 아키텍처

전문화된 에이전트 팀을 구성하고 작업을 자동으로 위임하여 복잡한 문제를 해결할 수 있습니다.

풍부한 도구 생태계

내장 도구와 함께 MCP(Model Context Protocol) 서버를 지원하여 로컬, 원격, Docker 기반 도구를 확장할 수 있습니다.

AI 제공자 중립성

OpenAI, Anthropic, Gemini, AWS Bedrock, Mistral, xAI, Docker Model Runner 등 다양한 AI 모델 제공자를 지원합니다.

YAML 기반 설정

에이전트를 YAML 파일로 선언적으로 정의하여 버전 관리와 공유가 용이합니다.

고급 추론 및 RAG

내장된 think, todo, memory 도구를 통한 고급 추론과 BM25, 임베딩, 하이브리드 검색, 재순위화를 지원하는 RAG(검색 증강 생성) 기능을 제공합니다.

패키지 및 공유

에이전트를 OCI 레지스트리에 푸시하고 어디서든 풀하여 실행할 수 있습니다.

설치 및 시작

Docker Desktop 4.63 이상을 사용하는 경우 docker-agent CLI 플러그인이 사전 설치되어 있어 `docker agent` 명령으로 바로 실행할 수 있습니다. Homebrew를 사용하는 경우 `brew install docker-agent`로 설치할 수 있으며, 바이너리 릴리스를 다운로드하여 `~/.docker/cli-plugins/docker-agent`에 심볼릭 링크를 만들면 `docker agent` 명령으로 사용할 수 있습니다.

에이전트를 실행하려면 최소한 하나의 API 키를 설정해야 합니다. 예를 들어 OpenAI API 키를 사용하는 경우 다음과 같이 환경 변수를 설정합니다.

export OPENAI_API_KEY=sk-...

Docker Model Runner를 사용하면 로컬 모델로도 실행할 수 있습니다.

기본 사용법

다음과 같은 명령으로 에이전트를 실행할 수 있습니다.

• 기본 에이전트 실행: docker agent run
• OCI 레지스트리에서 실행: docker agent run myorg/agent:tag
• 대화형으로 새 에이전트 생성: docker agent new
• 자체 설정 파일 실행: docker agent run agent.yaml

에이전트 정의는 YAML 파일로 작성합니다. 예를 들어, 다음은 기본 에이전트를 정의하는 예시입니다.

agents:
  root:
    model: openai/gpt-5-mini
    description: A helpful AI assistant
    instruction: |
      You are a knowledgeable assistant that helps users with various tasks.
      Be helpful, accurate, and concise in your responses.
    toolsets:
      - type: mcp
        ref: docker:duckduckgo

활용 예시

Docker Agent는 다양한 작업에 활용될 수 있습니다. 예를 들어, 여러 에이전트를 구성하여 복잡한 소프트웨어 개발 작업을 자동화하거나, RAG를 활용하여 대규모 문서에서 정보를 검색하고 요약하는 작업을 수행할 수 있습니다. 또한, MCP 서버를 통해 다양한 외부 도구와 연동하여 웹 검색, 데이터베이스 조회 등의 작업을 에이전트에 위임할 수 있습니다.

지원 환경

Docker Agent는 Docker CLI 플러그인으로 제공되며, Docker Desktop 4.63 이상 또는 Docker CLI가 설치된 환경에서 사용할 수 있습니다. Windows 운영 체제를 지원하며, x64 아키텍처가 필요합니다.

버전 및 업데이트

현재 버전은 v1.127.0이며, 2026년 8월 21일에 릴리스되었습니다. 최신 변경 사항은 공식 GitHub 릴리스 페이지에서 확인할 수 있습니다.

라이선스 및 확인 사항

Docker Agent는 Apache-2.0 라이선스로 배포됩니다. 사용 전에 공식 문서를 참조하여 자세한 내용을 확인하는 것이 좋습니다.