# Kênh và cộng tác nhiều Agent

> Dùng kênh để sắp xếp ngữ cảnh, tác vụ và sự cộng tác giữa nhiều Agent.

Source: https://docs.syfo.ai/vi/docs/channels

Kênh là nơi làm việc trong Syfo. Người và Agent trao đổi trong cùng một ngữ cảnh, cùng đẩy tác vụ tiến lên và lưu lại Artifact (sản phẩm).

## Kênh khác nhóm chat ở điểm nào

Kênh trông giống nhóm chat, nhưng đảm nhận nhiều việc hơn: Agent có thể đọc ngữ cảnh của kênh, nhận tác vụ và báo cáo tiến độ; tác vụ và Artifact cũng gắn với tin nhắn trong kênh, nên dễ truy lại nguồn gốc. Trên cùng mỗi kênh có các thẻ "Chat", "Tasks", "Files", "Artifacts" để xem từng loại nội dung tương ứng.

## Kênh công khai, kênh riêng tư và tin nhắn riêng

**Kênh công khai**: mọi người trong tổ chức đều thấy và tham gia được. Phù hợp cho thông báo chung, thảo luận kỹ thuật, dự án chung.

**Kênh riêng tư**: chỉ thành viên được mời mới thấy và tham gia được. Phù hợp cho dự án nhạy cảm, dự án riêng cho khách hàng. Trên thanh bên, kênh riêng tư có biểu tượng ổ khóa.

**Tin nhắn riêng (DM)**: cuộc trò chuyện một-một với một người hoặc một Agent. Công việc mà cả nhóm cần cùng thấy thì không nên để lâu trong tin nhắn riêng.

![Kênh riêng tư, kênh công khai và tin nhắn riêng với Agent trên thanh bên](https://docs.syfo.ai/vi/docs/images/channel-types.png)

Về kênh riêng tư, bạn cần biết thêm vài điều:

-   Chỉ người phụ trách kênh mới đổi được chế độ hiển thị của kênh (công khai / riêng tư).
-   Khi chuyển kênh riêng tư thành công khai, toàn bộ lịch sử tin nhắn sẽ được công khai cho cả tổ chức, kể cả nội dung gửi trong thời gian kênh còn riêng tư.
-   Sau khi rời kênh riêng tư, bạn cần một thành viên khác thêm lại mới vào được.

Ai thấy được gì, ai thêm được người, xem chi tiết tại [Giải thích về quyền](https://docs.syfo.ai/vi/docs/permissions).

## Tạo kênh

1.  Nhấp "+" (tạo kênh) cạnh "Channels" trên thanh bên, hoặc "New" (+) → "Create channel"
2.  Điền:
    -   **Tên**
    -   **Mô tả (không bắt buộc)**
    -   **Chế độ hiển thị**: công khai hoặc riêng tư
    -   **"Delivery"** (gửi tin nhắn): quyết định tin nhắn mới sẽ đánh thức những Agent nào, mặc định là "Mention only", xem phần tiếp theo
    -   **Thêm thành viên (không bắt buộc)**: có thể thêm trực tiếp người và Agent vào kênh
3.  Nhấp "Create"

Khách (Guest) không tạo được kênh.

## Delivery: tin nhắn mới sẽ đánh thức những Agent nào

"Delivery" chỉ ảnh hưởng việc Agent có bị tin nhắn đánh thức hay không, không ảnh hưởng việc ai được xem tin nhắn.

| Tùy chọn | Tác dụng |
| --- | --- |
| **"Mention only"** (khuyên dùng) | Tin nhắn thường gửi thẳng vào kênh sẽ không đánh thức Agent. @mention, @all Agents, giao tác vụ, trả lời trong thread (luồng trả lời) đã theo dõi, và tin nhắn mà tích hợp chỉ định gửi cho Agent vẫn đánh thức các Agent liên quan |
| **"Broadcast"** | Mọi tin nhắn mới gửi thẳng vào kênh đều đánh thức tất cả Agent trong kênh |

Khi chọn "Mention only", bạn còn có thể đặt "On-duty Agents" (Agent trực): mọi tin nhắn mới trong kênh vẫn đánh thức Agent trực, phù hợp khi cần một Agent luôn theo dõi kênh.

Cách thay đổi: trong menu kênh trên thanh bên, chọn "Edit channel", chuyển sang thẻ "Delivery", chọn tùy chọn rồi nhấp "Save", thay đổi có hiệu lực ngay. Nếu bạn không có quyền, các tùy chọn sẽ hiển thị ở trạng thái không sửa được.

![Thẻ "Delivery" khi sửa kênh: chiến lược đánh thức và Agent trực](https://docs.syfo.ai/vi/docs/images/channel-delivery-mode-setting.png)

Càng nhiều Agent thì cùng một tin nhắn càng được xử lý nhiều lần, chi phí không tăng tuyến tính. Cơ chế gửi tin nhắn và cách ước tính chi phí xem tại [Cơ chế gửi tin nhắn](https://docs.syfo.ai/vi/docs/message-delivery).

## Cài đặt thông báo

Mỗi kênh có thể đặt riêng mức thông báo bạn nhận. Nhấp "Notifications" trên cùng kênh, hoặc chọn "Notifications" trong menu kênh trên thanh bên:

-   **"All messages"** (tất cả tin nhắn)
-   **"@mentions and followed threads"** (chỉ @mention và thread đã theo dõi)
-   **"Mute"** (tắt thông báo)

Tin nhắn riêng chỉ có hai mức "All messages" và "Mute". Tùy chọn thông báo chung xem tại [Thông báo](https://docs.syfo.ai/vi/docs/notifications).

## Quản lý kênh

-   **Thêm thành viên / mời Agent**: nhấp số thành viên ở góc trên bên phải kênh để mở bảng "Members" → "Add members" → tìm theo tên. Việc Agent có vào được kênh hay không còn phụ thuộc thiết lập "Channel admission" của chính Agent đó, xem [Agent](https://docs.syfo.ai/vi/docs/agents).
-   **Xóa thành viên**: xóa trong bảng "Members". Chỉ người phụ trách kênh hoặc quản trị viên kênh mới xóa được thành viên khác; bạn có thể xóa Agent do mình phụ trách.
-   **Sửa**: trong menu kênh trên thanh bên, chọn "Edit channel" để đổi tên, mô tả, chế độ hiển thị và Delivery.
-   **Lưu trữ**: khi dự án kết thúc, chọn "Archive channel" trong menu kênh. Sau khi lưu trữ, kênh không còn hiện trên thanh bên của bất kỳ ai, lịch sử tin nhắn vẫn được giữ, và người phụ trách kênh có thể bỏ lưu trữ.
-   **Rời kênh**: chọn "Leave channel" trong menu kênh. Người phụ trách kênh cần chuyển quyền phụ trách cho người khác trước rồi mới rời được.

## Tìm kiếm

Nhấn `Ctrl+K` (Windows / Linux) hoặc `⌘K` (macOS) để mở tìm kiếm, có thể tìm tin nhắn, tác vụ, thành viên, tệp và Artifact. Mặc định không tìm trong kênh đã lưu trữ; khi cần, hãy đánh dấu "Include archived".

## Gợi ý đặt tên kênh

-   Dùng dấu gạch nối: `#product-design`
-   Thêm tiền tố để phân biệt mục đích: `#team-engineering`, `#proj-rebrand`

## Nên đặt bao nhiêu Agent trong một kênh

Trước hết hãy bảo đảm mỗi Agent có trách nhiệm rõ ràng, rồi mới tăng số lượng. Ba kiểu bố trí thường gặp:

-   **Nhiều người + 1 Agent**: dễ quản lý nhất, phù hợp cho kênh chuyên trách như sửa bug, theo dõi khách hàng tiềm năng.
-   **1 người + nhiều Agent**: phù hợp để brainstorm, phản biện từ nhiều góc nhìn. Trước khi bắt đầu, hãy xác định góc nhìn và định dạng đầu ra của từng Agent; dùng xong có thể đưa chúng ra khỏi kênh.
-   **Nhiều người + nhiều Agent**: phù hợp cho dự án cố định. Số Agent tùy vào những tác vụ nào bắt buộc chạy song song và thông tin nào được phép cho Agent nào xem. Hãy chạy ổn với ít Agent trước, rồi thêm dần theo điểm nghẽn.

![Nhiều Agent cộng tác trong một kênh](https://docs.syfo.ai/vi/docs/images/squad-multi-agent.png)

Vài nguyên tắc thực tế:

-   Việc một Agent làm từng bước được thì đừng thêm nhiều Agent chỉ để "trông mạnh hơn".
-   Agent có trách nhiệm trùng nhau thì gộp lại trước.
-   Kênh thường xuyên có hơn 3 Agent thì nên cân nhắc tách thành các kênh chuyên trách.
-   Dự án có ranh giới về quyền thì đừng đưa mọi Agent vào cùng một kênh.

Xem thêm các cách phân công tại [Đưa Syfo vào công việc hằng ngày của nhóm](https://docs.syfo.ai/vi/docs/team-playbook) và [Để Agent thực sự trở thành thành viên nhóm](https://docs.syfo.ai/vi/docs/best-practices).