Bỏ qua để đến nội dung

Xây dựng một nhóm agent

Hướng dẫn này chỉ cho bạn cách tạo một nhóm, gán trưởng nhóm cho nhóm đó và đưa công việc đến nhóm.

Một nhóm agent là một tập hợp có tên gồm các agent trong cùng một không gian làm việc, với một agent được chỉ định làm trưởng nhóm. Giao một phiếu cho nhóm sẽ đánh thức trưởng nhóm; trưởng nhóm chia nhỏ công việc rồi phân công cho các thành viên; khi một thành viên chạy xong, trưởng nhóm lại được đánh thức để quyết định bước tiếp theo.

Bạn tạo, đổi tên và bổ sung thành viên cho nhóm tại Cài đặt → Không gian làm việc → Agent → Nhóm. Có hai cách đưa công việc đến một nhóm: một agent gọi assign_ticket với team_id của nhóm đó, hoặc node Team dispatch của quy trình điều phối cả nhóm (mà không giao phiếu nào). Trình chọn người được gán của phiếu chỉ liệt kê bạn và từng agent riêng lẻ.

  1. Mở Cài đặt → Không gian làm việc → Agent (/settings/workspace/agents).
  2. Nhấp Nhóm ở đầu trang.
  3. Nhấp Thêm nhóm.
  4. Nhập tên nhóm (ví dụ “backend” hoặc “review squad”) và mô tả không bắt buộc, rồi nhấp Tạo.

Nhóm được tạo và chọn sẵn, trình chỉnh sửa của nhóm mở ra ở khung bên phải.

Đây là bước mà toàn bộ tính năng phụ thuộc vào. Trong trình chỉnh sửa của nhóm:

  1. Ở mục Trưởng nhóm, chọn một agent. Dòng trợ giúp mô tả chính xác: “Người điều phối nhận công việc giao cho nhóm và phân công cho thành viên phù hợp nhất.”
  2. Không bắt buộc, điền Hướng dẫn vận hành — văn bản tự do được trao cho trưởng nhóm kèm mỗi phiếu được chuyển đến.

Nâng một agent lên làm trưởng nhóm cũng biến agent đó thành thành viên nếu chưa phải. Một nhóm để ở Không có trưởng nhóm thì không hoạt động: không có gì được điều phối khi công việc được chuyển đến nhóm, và gỡ trưởng nhóm hiện tại khỏi danh sách thành viên sẽ khiến nhóm lại không có trưởng nhóm.

Trong cùng trình chỉnh sửa đó, dùng thẻ thành viên để thêm agent từ không gian làm việc và gỡ họ ra. Các thành viên chính là danh sách mà trưởng nhóm phân công công việc cho.

Nhóm thuộc phạm vi không gian làm việc: chỉ agent trong không gian làm việc này mới có thể tham gia.

Không có space tự động dành cho nhóm. Nếu muốn, hãy tạo một space thông thường từ Không gian rồi thêm các agent của nhóm vào đó. Một Team mang tên, mô tả, trưởng nhóm, hướng dẫn và thành viên — không có liên kết với space nào.

Mỗi agent cũng có trường Báo cáo cho, đặt trong Cài đặt → Không gian làm việc → Agent. Trường này dựng nên cây báo cáo của không gian làm việc, mà bạn có thể xem bằng nút Sơ đồ tổ chức trên trang agent.

Nó không điều khiển việc định tuyến công việc đến nhóm. Trưởng nhóm chọn người được phân công từ danh sách thành viên của nhóm dựa trên kỹ năng và vai trò, chứ không dựa trên chuỗi báo cáo. Quyền truy cập bộ nhớ được gắn với vai trò của agent, không gắn với chuỗi báo cáo, và không có bề mặt phân tích nào tổng hợp theo nhóm hay theo hệ thống cấp bậc. Các rào chắn ủy thác giới hạn độ sâu và phát hiện vòng lặp, nhưng chúng không bao giờ yêu cầu đích phải là cấp dưới.

Điều gì xảy ra với một phiếu được chuyển đến nhóm

Phần tiêu đề “Điều gì xảy ra với một phiếu được chuyển đến nhóm”

Khi một phiếu thực sự mang phân công cho nhóm:

  1. Trưởng nhóm của nhóm được điều phối kèm phiếu, hướng dẫn vận hành và danh sách thành viên.
  2. Trưởng nhóm phân công cho các thành viên và ghi lại đánh giá của mình bằng công cụ record_team_activity — action (đã phân công), no_action (không còn việc gì để làm, điều này dừng các lần kích hoạt lại tiếp theo) hoặc failed.
  3. Mỗi lượt chạy của thành viên hoàn tất sẽ đánh thức trưởng nhóm lần nữa, trong giới hạn của rào chắn no-action.

Node Team dispatch của quy trình là điểm vào còn lại. Nó nhận id nhóm, một prompt và một chế độ điều phối:

  • allParallel — mỗi thành viên một tác vụ trong một cuộc hội thoại ẩn dùng chung, tạm dừng cho đến khi mọi lượt chạy hoàn tất, với đầu ra của từng thành viên được thu thập dưới khóa đầu ra của node
  • manager — chỉ điều phối trưởng nhóm, và trưởng nhóm điều phối trong cuộc hội thoại