agent-swarm.dev: hệ điều hành AI agent cho doanh nghiệp

agent-swarm.dev là gì?

agent-swarm.dev là một hệ thống tự triển khai biến Claude Code, Codex và các công cụ AI khác thành một đội phối hợp: một agent trưởng chia mục tiêu thành các task và giao cho các worker agent, mỗi worker chạy trong một container Docker riêng. Worker gửi kết quả dưới dạng pull request, trả lời trên Slack, hoặc trang do agent tạo ra, sau đó ghi lại những gì học được vào một kho bộ nhớ dùng chung để các task sau có thêm ngữ cảnh.

Vì sao nên AI-Native với agent-swarm.dev?

Phần lớn công ty gắn AI vào công cụ có sẵn theo kiểu chắp vá — một bot Slack ở đây, một plugin Copilot ở kia — và mỗi lần tích hợp lại bắt đầu từ số 0 vì không có ngữ cảnh chung. Theo cách gọi của chính agent-swarm.dev, đó là "AI First" chứ chưa phải "AI Native": task và bài học bị cô lập theo từng công cụ thay vì cộng dồn lại. Giải pháp mà README đưa ra là một agent trưởng duy nhất cộng với một kho bộ nhớ dùng chung mà worker của mọi phòng ban đều đọc và ghi vào, để điều một agent hỗ trợ phát hiện hôm nay trở thành thứ agent kỹ thuật đã biết sẵn vào tuần sau.

agent-swarm.dev dành cho ai?

agent-swarm.dev phù hợp với các đội ngũ kỹ thuật đã dùng Docker và muốn định tuyến công việc từ Slack, GitHub hay Linear tới agent AI thay vì một cửa sổ chat đơn lẻ. Nó hợp với công ty sẵn sàng tự vận hành container và credential cho Claude Code, Codex hay harness khác được hỗ trợ, vì đây không phải SaaS được lưu trữ sẵn có trang đăng nhập. Đây không phải lựa chọn tốt cho một lập trình viên đơn lẻ chỉ cần gợi ý code inline, hay một đội chưa sẵn sàng cấp quyền ghi vào repo hoặc hàng đợi ticket cho worker agent.

Tính năng chính của agent-swarm.dev

• ✓Tách lead/worker chạy trong Docker — phần lõi của cơ chế đa agent trong agent-swarm.dev: agent trưởng lập kế hoạch và giao việc, còn worker thực thi trong container riêng với môi trường dev đầy đủ (git, Node.js, Python).
• ✓Bộ nhớ dài hạn theo cơ chế hybrid, kết hợp tìm kiếm vector và full-text, theo liên kết giữa các bộ nhớ liên quan, và cho phép agent sửa lại một bộ nhớ mà không mất ID hay lịch sử.
• ✓Workflow engine dựa trên DAG với cổng duyệt thủ công (human-in-the-loop), cơ chế retry, và input/output có cấu trúc cho các bước không nên chạy tự động hoàn toàn.
• ✓Lịch chạy dạng cron có thể kích hoạt task của agent, workflow, hoặc script trong catalog theo chu kỳ lặp lại.
• ✓Điều chỉnh task giữa chừng (mid-run task steering) — thêm ngữ cảnh ở điểm chuyển lượt tiếp theo, hoặc ngắt ngay nếu harness hỗ trợ.
• ✓Không phụ thuộc vào một harness hay LLM cố định: chạy được với Claude Code, Claude Bridge, OpenAI Codex, pi-mono (qua Anthropic, OpenRouter, hoặc Bedrock), Devin, Claude Managed Agents, LLM thô, hoặc opencode, với modelTier riêng cho từng task (smol, regular, smart, ultra).
• ✓Có observability qua trace OpenTelemetry cùng số liệu chi phí/token qua OTLP để lên dashboard trong SigNoz, Datadog, hay Tempo.
• ✓Pages lưu trong DB và một KV store kiểu Redis để agent công bố báo cáo hoặc chia sẻ state có phạm vi giới hạn mà không cần dựng thêm database riêng.

Trường hợp sử dụng thực tế của agent-swarm.dev

• •Phát triển tính năng: một yêu cầu trên Slack trở thành ticket Linear và pull request trên GitHub mà không cần người chuyển tiếp ngữ cảnh thủ công.
• •Tự động hóa workflow cho code health: cảnh báo từ Datadog, New Relic, hay Sentry kích hoạt worker điều tra và đề xuất fix theo lịch.
• •Hỗ trợ khách hàng chủ động: agent theo dõi các tài khoản cụ thể và chuẩn bị báo cáo trạng thái theo lịch thay vì chờ có ticket.
• •Báo cáo từ data warehouse: agent truy vấn dữ liệu mới nhất và trả lời các câu hỏi thường trực mà trước đây dashboard BI đảm nhận.
• •Tài liệu phát hành: worker cập nhật docs, và theo README có thể kết hợp với công cụ như Remotion hay browser-use để tạo video release.

Bắt đầu với agent-swarm.dev

Cách nhanh nhất là dùng onboarding wizard: nó thu thập credential, chọn preset, và tự viết một file docker-compose.yml hoàn chỉnh: ```bash bunx @desplega.ai/agent-swarm onboard ``` Nếu muốn setup thủ công, clone repo, copy file env mẫu, điền API_KEY cùng credential cho harness bạn chọn (ví dụ CLAUDE_CODE_OAUTH_TOKEN), rồi khởi động bằng Docker Compose: ```bash git clone https://github.com/desplega-ai/agent-swarm.git cd agent-swarm cp .env.docker.example .env docker compose -f docker-compose.example.yml --env-file .env up -d ``` Docker cùng ít nhất một credential harness được hỗ trợ là điều kiện bắt buộc — quick start mặc định giả định bạn có Claude Code OAuth token lấy từ `claude setup-token`. Sau khi chạy, API lắng nghe ở cổng 3013, có docs tương tác tại /docs và OpenAPI 3.1 spec tại /openapi.json.

Lựa chọn thay thế cho agent-swarm.dev

Câu hỏi thường gặp

Repo liên quan