Giá trị thật nằm ở việc main agent giữ được vai trò điều phối, còn subagent xử lý phần việc riêng mà không làm bẩn ngữ cảnh chính.
Technical research dossier / architecture deep dive
Điểm mới không chỉ là nhiều agent chạy song song. Antigravity 2.0 đang biến việc phân rã nhiệm vụ, cách ly ngữ cảnh, worktree, quyền và giám sát thành một lớp vận hành có thể kiểm soát.
Subagent của Antigravity 2.0 nên được đọc như một kiến trúc điều phối công việc, không chỉ như một tính năng tăng tốc.
Giá trị thật nằm ở việc main agent giữ được vai trò điều phối, còn subagent xử lý phần việc riêng mà không làm bẩn ngữ cảnh chính.
Antigravity cho phép agent chính tạo subagent chuyên biệt hoặc subagent được định nghĩa động theo yêu cầu của task.
Mỗi subagent có prompt, vai trò, quyền công cụ và workspace riêng theo cấu hình được truyền vào.
Kiến trúc này giảm ô nhiễm context, mở đường cho song song hóa và giúp người dùng vẫn giám sát được luồng chạy.
Case study quy mô lớn của Google là bằng chứng khả năng, không phải cam kết rằng mọi repo đều đạt hiệu quả tương tự.
Nếu dùng ẩn dụ tổ chức, Antigravity không chỉ “giao việc” cho agent con. Nó còn cho phép định hình vai trò trước khi giao việc, rồi quản trị vòng đời của các nhánh đang chạy.
define_subagent
Tuyển dụng / định hình vai trò
Agent có thể tạo một loại subagent tùy chỉnh với system prompt, mô tả nhiệm vụ và bộ quyền công cụ. Đây là bước biến “nhân sự AI” từ một bản sao chung chung thành một vai trò có chuyên môn.
invoke_subagent
Giao việc / kích hoạt thực thi
Parent agent gọi subagent với role, prompt ban đầu và tùy chọn workspace. Từ đây subagent bắt đầu một phiên chạy song song, có ngữ cảnh riêng và có thể trả kết quả về cho parent.
manage_subagents
Quản trị / dừng nhánh chạy
Tài liệu Hooks dùng tên số nhiều `manage_subagents` cho thao tác liệt kê hoặc kết thúc subagent đang hoạt động. Đây là lớp kiểm soát để mô hình nhiều agent không biến thành các luồng chạy khó theo dõi.
Sơ đồ này tổng hợp từ docs subagents, CLI subagents, projects và permissions. Nó mô tả luồng vận hành công khai, không khẳng định cấu trúc backend nội bộ.
Giữ mục tiêu tổng, phân rã task và gọi subagent bằng `invoke_subagent`. Agent chính có thể tiếp tục làm việc trong khi các nhánh phụ chạy nền.
Nhận role và prompt riêng. Subagent không thừa hưởng lịch sử hội thoại của parent, nên bắt đầu với một context sạch hơn.
Subagent có thể dùng cùng workspace hoặc Git worktree riêng. Với task song song, worktree giúp giảm xung đột khi nhiều nhánh cùng chỉnh sửa.
Các thành phần dưới đây làm cho subagent trở thành một mô hình vận hành chứ không chỉ là nhiều tab hội thoại.
Subagent không kéo theo toàn bộ lịch sử hội thoại của parent. Đây là điểm then chốt khi cần đọc codebase, chạy test hoặc nghiên cứu rộng.
Các việc dài như build, tìm kiếm nhiều file hoặc sweep nghiên cứu có thể chạy nền, còn người dùng vẫn giữ luồng làm việc chính.
Subagent kế thừa cấu hình an toàn từ parent và project. Khi cần phê duyệt tool, yêu cầu có thể bubble lên panel để người dùng quyết định.
CLI có `/agents` để xem agent đang chạy, trạng thái, bước hiện tại và detail view. `/tasks` phục vụ tác vụ nền không phải agent.
Các claim quan trọng được phân loại theo chất lượng nguồn. Những điểm ghi là “Inference” là diễn giải của báo cáo từ tài liệu công khai.
| Claim | Evidence | Source quality | Status |
|---|---|---|---|
| Parent agent tạo subagent bằng `invoke_subagent`. | Docs subagents mô tả parent agent gọi `invoke_subagent` để spawn concurrent session với role và prompt riêng. | Primary documentation | Verified |
| Agent có thể định nghĩa loại subagent riêng bằng `define_subagent`. | Docs subagents nói agent có thể định nghĩa custom subagents động; docs Hooks mô tả tham số như `name`, `description`, `system_prompt` và quyền công cụ. | Primary documentation | Verified |
| Vòng đời subagent có thể được quản trị bằng `manage_subagents`. | Docs Hooks liệt kê `manage_subagents` với các action như `list`, `kill` và `kill_all`. Đây là tên số nhiều trong tài liệu hiện tại. | Primary documentation | Verified |
| Subagent có context isolation. | Docs nói subagent không thừa hưởng conversation history của parent và bắt đầu bằng clean slate. | Primary documentation | Verified |
| Workspace có thể là cùng workspace hoặc Git worktree riêng. | Docs subagents và Projects đều mô tả lựa chọn same workspace, Local Mode hoặc New Worktree Mode. | Primary documentation | Verified |
| Delegation có giới hạn nesting depth 10. | Docs subagents nêu giới hạn tối đa 10 lớp subagent để tránh runaway resource exhaustion. | Primary documentation | Verified |
| Agent team đã được Google dùng trong case OS. | Google công bố case “Built an OS” dùng 93 subagents, 15.314 model calls và hơn 339M input tokens. | Company communication | Case study |
| Kiến trúc này hữu ích nhất cho task lớn, dễ phân rã và cần kiểm chứng. | Suy luận từ cơ chế subagent, async task, worktree isolation, permissions và monitoring. | Inference | Reasoned |
Subagent tạo cảm giác “đã có đội agent”, nhưng kiến trúc này vẫn cần scope, nguồn và quyền được kiểm soát chặt.
Con số 93 subagents rất ấn tượng, nhưng đó là một case Google công bố. Không nên suy ra mọi task đều có hiệu quả chi phí hoặc chất lượng tương tự.
Subagent hợp với việc có ranh giới rõ. Nếu task phụ thuộc chặt vào nhau, chạy song song có thể làm tăng chi phí phối hợp.
Projects và permissions giúp kiểm soát phạm vi, nhưng nếu cấu hình quá thoáng, nhiều agent song song cũng có thể khuếch đại rủi ro thao tác.
Báo cáo kiểm tra nguồn ngày 30/05/2026. Các số liệu về OS case là số Google công bố, không phải benchmark độc lập. Bản đồ kiến trúc là phần suy luận từ tài liệu công khai.