UniAI Docs

@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ạnhGiao việc@nhắc
Đổi assignee
Đổi status
Xếp hàng taskNgay lập tức (không ở Backlog)Ngay lập tức
ID bình luận kích hoạtTùy chọnLuôn mang bình luận hiện tại
Số agent mỗi thao tác1 (một người phụ trách)Nhiều (một bình luận @ được nhiều agent)
Độ ưu tiênKế thừa từ issueKế 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ó taskqueued 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