BroadRouter
Bắt đầu

Subagent (agent con)

Cập nhật

Subagent là một agent riêng biệt mà agent chính khởi chạy để xử lý một việc cụ thể. Nó chạy với context window, system prompt và quyền dùng tool riêng, làm xong việc và chỉ trả kết quả hoặc bản tóm tắt cho agent chính, nhờ đó cuộc hội thoại chính luôn gọn.

Còn gọi là: subagent là gì, agent con, sub-agent, tác tử con, subagent Claude Code, child agent

Subagent là cơ chế giao việc dành cho agent: trao một việc cho một “người làm” mới và chỉ nhận lại câu trả lời.

Cách hoạt động

Agent chính xác định một việc là độc lập, chẳng hạn “tìm mọi chỗ gọi hàm này” hoặc “chạy bộ test và báo các lỗi”. Nó khởi chạy một subagent kèm mô tả công việc. Subagent chạy vòng lặp agent của riêng mình rồi trả về kết quả.

Tài liệu Claude Code viết: “Each subagent runs in its own context window with a custom system prompt, specific tool access, and independent permissions.” (Bản dịch: Mỗi subagent chạy trong context window riêng với system prompt tùy chỉnh, quyền dùng tool cụ thể và quyền hạn độc lập.) Subagent được định nghĩa bằng một file Markdown có YAML frontmatter, ở cấp project thì nằm trong .claude/agents/:

---
name: code-reviewer
description: Reviews code for quality and best practices
tools: Read, Glob, Grep
model: sonnet
---

You are a code reviewer. When invoked, analyze the code and provide
specific, actionable feedback on quality, security, and best practices.

Các lợi ích được liệt kê gồm giữ phần khám phá nằm ngoài cuộc hội thoại chính, giới hạn tool mà subagent được dùng, và chuyển việc sang model rẻ hơn.

Các framework khác có ý tưởng tương tự. OpenAI Agents SDK viết “Handoffs allow an agent to delegate tasks to another agent,” (Bản dịch: Handoff cho phép một agent giao việc cho một agent khác) và biểu diễn mỗi handoff với model dưới dạng một tool.

Bài viết về context engineering của Anthropic mô tả mô hình này từ góc độ context: mỗi sub-agent làm việc trong một context window sạch và “returns only a condensed, distilled summary of its work,” (Bản dịch: chỉ trả về bản tóm tắt cô đọng, chắt lọc về công việc của nó), thường từ 1.000 đến 2.000 token.

Vì sao quan trọng

  • Context. Một lần chạy test có thể in ra hàng chục nghìn token. Trong subagent, output đó nằm ngoài context window chính; chỉ bản tóm tắt quay về. Đây là một công cụ cốt lõi của context engineering.
  • Chi phí. Tổng số token thường tăng, vì mỗi subagent nạp prompt và tool riêng. Bài chi phí multi-agent ước tính hệ số nhân.
  • Chạy song song. Các subagent chạy cùng lúc là các request song song. Giới hạn request đồng thời của nhà cung cấp quyết định bao nhiêu cái chạy được cùng lúc.

Trên BroadNet Inference

BroadNet phục vụ model; logic subagent nằm trong công cụ agent của bạn. Công cụ nào nhận base URL tương thích OpenAI đều có thể trỏ cả agent chính lẫn các subagent sang BroadNet, và dùng model khác nhau cho từng cái.

Với gói trả theo mức dùng, một key cho phép 4 request đang chạy. Với các gói giá cố định cho DeepSeek V4.1 Flash, mỗi phiên chạy một request tại một thời điểm, nên hãy đếm số request tới model có thể đang chạy trong cùng một khoảnh khắc: ba subagent chạy cùng lúc cần ba phiên, và bốn phiên nếu orchestrator cũng gọi model trong lúc chúng chạy. Chạy song song nhiều coding agent trên API giá cố định trình bày chi tiết cách tính số phiên.

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

Subagent có giúp tiết kiệm token không?

Nó tiết kiệm context trong cuộc hội thoại chính, không tiết kiệm tổng số token. Các request của subagent vẫn tốn token. Tài liệu Claude Code lưu ý request của subagent vẫn tính vào mức sử dụng của bạn, và gợi ý dùng model nhỏ hơn cho các việc đơn giản.

Subagent có thể tự khởi chạy subagent khác không?

Tùy công cụ. Tài liệu Claude Code nói mặc định một subagent có thể tạo subagent của riêng nó, tối đa ba tầng dưới cuộc hội thoại chính, và có thể giới hạn điều này.

Subagent khác handoff thế nào?

Subagent làm một việc rồi báo cáo lại cho agent đã gọi nó. Trong OpenAI Agents SDK, handoff cho phép một agent giao việc cho agent khác, và helper handoff() chuyển quyền điều khiển sang agent đó.

Đọc dạng MarkdownHỏi ChatGPTHỏi ClaudeHỏi Perplexity