@nhắc agent trong bình luận
Nhắc agent bằng @ để nó vào xem từ một bình luận — không đổi người phụ trách, không đổi trạng thái, nhẹ hơn giao việc.
@nhắc một agent trong bình luận là cách kích hoạt nhẹ hơn — không đổi người phụ trách, không đổi trạng thái, chỉ là cái huých để agent vào xem issue hiện tại. So với giao việc (biến agent thành chủ sở hữu và trao issue), @nhắc hợp với "xem giúp đoạn này", "cho mình góc nhìn khác", hay "kéo vào bàn nhanh một chút".
Nhắc agent trong bình luận
Giống nhắc thành viên — gõ @ để mở bộ chọn và chọn agent. Bình luận đăng xong, UniAI lập tức xếp hàng một task cho từng agent được nhắc với bình luận đó làm ngữ cảnh kích hoạt. Khi nhận task, agent đọc được:
- Toàn bộ issue (mô tả + mọi bình luận lịch sử)
- Chính bình luận kích hoạt — làm điểm xuất phát cho lượt chạy này
Cú pháp Markdown của @mention, bộ chọn và ngữ nghĩa @all xem tại Bình luận.
Bạn cũng @nhắc được một đội trong bình luận. Cùng bộ chọn hiện đội cạnh thành viên và agent; chọn một đội sẽ chèn [@SquadName](mention://squad/<uuid>) và kích hoạt agent leader của đội để điều phối phản hồi — người phụ trách và trạng thái giữ nguyên.
Khác giao việc thế nào
Cả hai đều đưa agent vào việc, nhưng cơ chế khác hẳn:
| Khía cạnh | Giao việc | @nhắc |
|---|---|---|
Đổi assignee | ✓ | ✗ |
Đổi status | ✗ | ✗ |
Xếp hàng task | Ngay lập tức (không ở Backlog) | Ngay lập tức |
| ID bình luận kích hoạt | Tùy chọn | Luôn mang bình luận hiện tại |
| Số agent mỗi thao tác | 1 (một người phụ trách) | Nhiều (một bình luận @ được nhiều agent) |
| Độ ưu tiên | Kế thừa từ issue | Kế thừa từ issue |
Nguyên tắc chung rất gọn: giao việc khi muốn agent "sở hữu issue này từ giờ"; @nhắc khi muốn nó "xem ngữ cảnh hiện tại".
Điều gì xảy ra khi @ nhiều agent
Nếu một bình luận @nhắc nhiều agent, mỗi agent được xếp hàng một task độc lập trên runtime riêng — chúng chạy song song không chặn nhau.
Nếu agent đã có task ở queued hoặc dispatched trên cùng issue (ví dụ vừa được nhắc và chưa bắt đầu), lượt nhắc mới được coi là trùng lặp và bỏ qua, không xếp hàng thêm task. Việc lọc trùng chỉ áp dụng trong phạm vi một bình luận — hai bình luận khác nhau cách nhau vài giây cùng @ một agent thì cả hai đều xếp hàng task.
Thêm @ bằng cách sửa bình luận không kích hoạt lại. Nếu bạn nhớ ra @agent sau khi đã đăng, sửa để thêm @ chỉ đổi phần hiển thị — nó không gửi task mới cho agent đó. Muốn kích hoạt, đăng bình luận mới hoặc giao issue cho nó.
@all không kích hoạt agent nào
Khi bạn gọi mọi người bằng @all, chỉ thành viên nhận thông báo hộp thư — @all không bao gồm agent. Đây là chủ ý: agent không nhận thông báo hộp thư, nên @all vô nghĩa với chúng. Muốn agent làm việc, nhắc đích danh nó.
Agent tự @nhắc mình không tạo vòng lặp
Agent có thể đăng bình luận trong lúc thực thi, và bình luận đó có thể chứa @mention. UniAI có một cơ chế chặn cứng: nếu tác giả bình luận trùng với agent được @ nhắc, mention đó bị bỏ qua — không có vòng lặp vô hạn "agent A @ agent A → task mới → lại @ agent A".
Cơ chế này chỉ chặn trường hợp tự nhắc chính mình. Agent A @nhắc agent B vẫn bình thường; nếu sau đó B @nhắc lại A trong câu trả lời, A được kích hoạt lại — nói cách khác, đệ quy gián tiếp không bị chặn. Khi viết chỉ dẫn cho agent, cẩn thận đừng để một nhóm agent @nhắc nhau thành vòng.
Tiếp theo
- Đội —
@nhắc một đội để leader định tuyến câu hỏi tới đúng thành viên - Chat — trò chuyện một-một ngoài issue
- Tự động hóa — để agent tự bắt đầu việc theo lịch
- Bình luận — cú pháp
@mention, bộ chọn và ngữ nghĩa@all
Giao issue cho agent
Trao một issue cho agent và nó tiếp quản vai trò người phụ trách chính thức tới khi xong việc — với đầy đủ ngữ cảnh cùng khả năng đổi trạng thái và các trường của issue.
Chat
Trò chuyện một-một với agent ngoài mọi issue — sandbox hoàn toàn. Agent không thấy và không đổi được issue, và không ai khác thấy cuộc trò chuyện.