Docker Agent: Công Cụ Xây AI Agent Cho Docker CLI
Docker Agent là plugin CLI riêng của Docker để xây dựng và chạy AI agent từ một file YAML, cài được qua Docker Desktop, Homebrew, hoặc file binary độc lập. Lựa chọn model, công cụ, và hướng dẫn nằm chung trong một file config có thể đẩy lên OCI registry để đồng nghiệp kéo về chạy y hệt. Hãy dùng nếu bạn đã quen làm việc trong Docker CLI; bỏ qua nếu bạn cần một framework đã được kiểm chứng nhiều năm trong production, vì dự án này còn khá non trẻ.
Docker Agent Là Gì?
Docker Agent chạy như một plugin cho docker CLI, gọi bằng lệnh `docker agent`, thực thi các AI agent khai báo trong YAML thay vì viết bằng code. Bạn đặt model, instruction, và toolset của agent — kể cả MCP server — ngay trong file đó, rồi plugin chạy nó từ terminal. Nó xử lý một agent đơn lẻ hoặc một nhóm agent chuyển giao việc cho nhau, và config hoàn chỉnh có thể kéo về từ OCI registry giống cách bạn pull một image container.
Tính Năng Chính
- ✓Kiến trúc multi-agent — một agent gốc có thể tự động giao việc cho một nhóm agent chuyên biệt, theo README.
- ✓Hệ sinh thái công cụ dựa trên MCP — ngoài các công cụ tích hợp sẵn, bất kỳ MCP server nào — chạy local, remote, hay dưới dạng container Docker — đều có thể gắn vào một agent.
- ✓Không phụ thuộc nhà cung cấp model cụ thể — README nêu tên Anthropic, OpenAI, Gemini, xAI, Mistral, AWS Bedrock, và Docker Model Runner là các nguồn model được hỗ trợ.
- ✓Cấu hình ưu tiên YAML — model, hướng dẫn, và toolset của một agent nằm chung trong một file, dễ đưa vào version control, diff, và review.
- ✓Bộ công cụ suy luận có tên riêng — README liệt kê think, todo, và memory là các công cụ tích hợp sẵn mà agent có thể gọi khi xử lý một tác vụ.
- ✓Truy hồi có thể tuỳ chỉnh — kết hợp BM25, embedding, hybrid search, và reranking cho các tình huống RAG, theo README.
- ✓Đóng gói theo chuẩn OCI — một config agent đã chạy được có thể đẩy lên bất kỳ OCI registry nào rồi kéo về hoặc chạy ở nơi khác bằng cùng một lệnh.
Trường Hợp Sử Dụng Tiềm Năng
- •Ghép một trợ lý nội bộ cần một tổ hợp công cụ cụ thể (chẳng hạn một MCP server DuckDuckGo cộng với API riêng của bạn) mà không phải tự viết vòng lặp agent bằng Python.
- •Chia một tác vụ phức tạp cho một nhóm nhỏ agent, mỗi agent phụ trách một phần hẹp hơn và giao phần còn lại cho agent khác, dùng cơ chế multi-agent mà README mô tả.
- •Thử nghiệm một agent với các nhà cung cấp model khác nhau — OpenAI so với Anthropic so với một model local qua Docker Model Runner — chỉ bằng cách đổi một dòng trong YAML thay vì viết lại code tích hợp.
- •Xây một agent retrieval-augmented trên tài liệu của riêng bạn bằng tuỳ chọn RAG tích hợp sẵn — BM25, embedding, hoặc hybrid — thay vì dựng riêng một dịch vụ truy hồi.
- •Đóng gói một agent đã chạy được thành OCI artifact để đồng nghiệp — hoặc CI — có thể kéo về và chạy đúng config đó.
Cài Đặt Và Thiết Lập
Docker Desktop từ bản 4.63 trở lên đã cài sẵn plugin CLI docker-agent, nên `docker agent` chạy được ngay nếu bạn đang dùng bản Docker Desktop gần đây. Nếu không dùng Docker Desktop, `brew install docker-agent` sẽ tải binary trên macOS/Linux qua Homebrew — chạy trực tiếp bằng `docker-agent`, hoặc symlink nó vào `~/.docker/cli-plugins/docker-agent` để `docker agent` nhận diện nó như một plugin. README cũng dẫn tới binary release trên GitHub Releases cho cách cài thủ công, dùng cùng bước symlink đó. Dù đi theo đường nào, bạn cũng cần đặt ít nhất một credential model dưới dạng biến môi trường — OPENAI_API_KEY, ANTHROPIC_API_KEY, GOOGLE_API_KEY, v.v. — trừ khi bạn chạy model local qua Docker Model Runner, khi đó không cần API key. README dẫn tới một trang riêng 'Set Up a Model' hướng dẫn chi tiết cả hai cách.
Chạy AI Agent
Lệnh cơ bản là `docker agent run`, chạy agent mặc định mà không cần tham số nào. Trỏ vào một file bằng `docker agent run agent.yaml` để chạy cấu hình của riêng bạn, hoặc trỏ vào một tham chiếu OCI như `docker agent run myorg/agent:tag` để kéo và chạy trực tiếp agent đã được đóng gói của người khác. `docker agent new` dựng một agent mới theo kiểu tương tác thay vì bạn tự viết YAML từ đầu. README nói còn nhiều ví dụ chi tiết hơn nằm trong examples/README.md của repo, và chính dự án này chạy quy trình đóng góp của nó qua cùng một CLI — `docker agent run ./golang_developer.yaml` — một dấu hiệu khá tốt cho thấy công cụ này chịu được việc dùng ngoài các demo đơn giản.
Điểm mạnh
- ✓Cài đặt theo đúng cách các công cụ Docker vẫn làm — có sẵn trong Docker Desktop 4.63+, hoặc chỉ một lệnh Homebrew — không cần bước cài riêng cho một agent framework.
- ✓Lựa chọn model không bị khoá cứng: cùng một file YAML có thể trỏ tới OpenAI, Anthropic, Gemini, Bedrock, Mistral, xAI, hoặc một model local qua Docker Model Runner.
- ✓Tích hợp công cụ đi qua MCP: một MCP server bất kỳ — tự host, chạy ở xa, hay đóng gói thành image Docker — đều có thể gắn vào agent mà không cần viết code công cụ riêng.
- ✓Config là artifact có thể mang đi: đẩy một config lên OCI registry, và đồng nghiệp chạy đúng agent đó bằng `docker agent run myorg/agent:tag`.
- ✓Giấy phép Apache-2.0, không kèm ràng buộc copyleft cho việc sử dụng phía sau.
Lưu Ý Và Hạn Chế
- △README không nêu lịch sử phiên bản, changelog, hay phát biểu nào về độ ổn định của bản thân CLI — bạn đang đặt niềm tin vào một dự án còn khá non trẻ cho thứ sẽ nắm giữ API key và tự chạy các lệnh gọi công cụ.
- △Chạy bất kỳ agent nào cũng cần một API key model trả phí hoặc phải thiết lập Docker Model Runner cho model local — không có cách nào dùng thử mà zero-config ngoài lựa chọn model mặc định của agent có sẵn.
- △RAG, giao việc multi-agent, và gắn công cụ qua MCP đều được nêu tên trong README, nhưng cú pháp cấu hình cụ thể cho từng phần không được trình bày ngay trong đó — bạn cần vào trang docs liên kết để cấu hình gì đó ngoài ví dụ cơ bản.
- △README nói Docker Agent mặc định thu thập dữ liệu sử dụng ẩn danh, đáng lưu ý nếu bạn chạy nó ở nơi telemetry cần phải opt-in.
- △Đây là một plugin của Docker CLI, nên bản thân Docker là phụ thuộc bắt buộc — không phải một binary độc lập để thả vào một pipeline không dùng Docker.
Lựa Chọn Thay Thế Cho Docker Agent
Câu Hỏi Thường Gặp
Docker Agent được phát hành theo giấy phép Apache-2.0, như được liệt kê trên repository GitHub của dự án.
README của Docker Agent liệt kê Anthropic, OpenAI, Gemini, xAI, Mistral, AWS Bedrock, và Docker Model Runner là các nhà cung cấp model được hỗ trợ, chọn riêng cho từng agent trong file YAML.
Agent trong Docker Agent được cấu hình trong một file YAML khai báo model, một instruction dạng văn bản, và danh sách toolset — kể cả MCP server — cho từng agent, rồi chạy bằng `docker agent run agent.yaml`.
Docker Agent có thể chạy với model local qua Docker Model Runner thay vì cần API key trên cloud, theo hướng dẫn cài đặt trong README.
Docker Agent cho phép đẩy config YAML của một agent thành package lên bất kỳ OCI registry nào, để người khác kéo về và chạy đúng config đó bằng `docker agent run myorg/agent:tag`.
Docker Agent hỗ trợ hệ thống multi-agent: theo README, một agent gốc có thể giao việc lại cho một nhóm agent chuyên biệt cùng phối hợp làm việc tự động.
Vấn đề Docker Agent giải quyết
Xây một AI agent đơn giản từ đầu thường đòi hỏi viết code kết nối để chọn model client, đăng ký công cụ, và quản lý việc ủy quyền giữa các sub-agent — công việc khó đưa vào version control, khó review trong một pull request, hoặc khó giao lại cho đồng nghiệp mà không kèm theo cả codebase. README của Docker Agent đóng khung lý do tồn tại của dự án quanh đúng khoảng trống đó: agent được mô tả bằng YAML thay vì code, chạy như một plugin của Docker CLI, và chia sẻ dưới dạng OCI artifact giống cách một image container được chia sẻ.
Ai nên dùng — và ai nên bỏ qua
Hãy thử Docker Agent nếu bạn đã dùng Docker hằng ngày và muốn config agent nằm trong version control dưới dạng YAML thay vì một script Python riêng cho từng agent — khả năng giao việc multi-agent và chia sẻ qua OCI mới là điểm khác biệt thật sự ở đây. Bỏ qua nếu bạn cần một agent framework đã được kiểm chứng nhiều năm trong production với hệ sinh thái plugin lớn để dựa vào, hoặc nếu bạn không muốn phụ thuộc vào Docker; với 3.246 star, đây vẫn là một dự án khá mới, chưa phải một dự án đã ổn định, xét theo chính phạm vi mà README mô tả.
Repo liên quan
docker-agent có đáng để bạn bỏ thời gian?
ChatGPT, Claude và Perplexity đều đọc được trang này. Hỏi thử xem họ nghĩ gì về docker-agent.