# Đưa Syfo vào công việc hằng ngày của nhóm

> Phương pháp thiết kế kênh, Agent và ngữ cảnh khi mở rộng từ dùng thử cá nhân sang cộng tác cả nhóm.

Source: https://docs.syfo.ai/vi/docs/team-playbook

Khi nhóm chuẩn bị chính thức đưa Syfo vào sử dụng, bước đầu tiên không phải là tạo Agent, mà là nghĩ rõ cách chia kênh, cách phân công Agent và đặt ngữ cảnh ở đâu. Hướng dẫn này giúp bạn hoàn thành việc lập kế hoạch đó.

Điều thực sự cần nghĩ rõ trước tiên không phải là "tạo mấy Agent", mà là:

1.  Những mảng nghiệp vụ nào nên đưa vào Syfo;
2.  Mỗi mảng nghiệp vụ nên chia thành những kênh nào;
3.  Mỗi kênh cần mấy Agent, mỗi Agent đảm nhận vai trò gì;
4.  Agent cần thấy những ngữ cảnh nào thì mới thực sự làm được việc;
5.  Thành viên trong nhóm cần tuân theo những quy chuẩn cộng tác nào.

## Danh sách chuẩn bị cho quản trị viên

Trước khi triển khai chính thức, Owner hoặc Admin của tổ chức hãy chuẩn bị sẵn những việc sau:

1.  **Mời thành viên và phân vai trò.** Mời đồng nghiệp trong "Members" (Thành viên), phân các vai trò như Owner, Admin, Member tùy nhu cầu. Người quản lý tổ chức, hóa đơn và Syfo Cloud Agent nên ít và rõ ràng. Khác biệt giữa các vai trò xem [Giải thích về quyền](https://docs.syfo.ai/vi/docs/permissions), các bước mời xem [Tổ chức](https://docs.syfo.ai/vi/docs/organization).
2.  **Chuẩn bị credit.** Trong "Settings → Subscription & Credits", đăng ký gói hoặc mua Credit, và điền "Billing profile" (thông tin thanh toán: email nhận hóa đơn, tên trên hóa đơn). Thống nhất ai phụ trách theo dõi cảnh báo số dư. Xem [Mức sử dụng và thanh toán](https://docs.syfo.ai/vi/docs/usage-billing).
3.  **Kết nối máy tính.** Thành viên nào cần repo cục bộ hoặc công cụ trên máy, hãy nhấn "Add computer" trong "Computers" để kết nối máy tính của mình. Xem [Máy tính và nơi chạy](https://docs.syfo.ai/vi/docs/computers#kết-nối-một-máy-tính).
4.  **Phân định Cloud và máy cục bộ.** Agent cần luôn trực tuyến (tác vụ định kỳ, vận hành, chăm sóc khách hàng) đặt trên Syfo Cloud, do Owner hoặc Admin tạo hoặc phê duyệt; Agent cho phát triển, gỡ lỗi chạy trên máy tính của chính thành viên. Quyết định Agent trên máy cục bộ dùng tài khoản mô hình của thành viên hay trả phí bằng credit của tổ chức.
5.  **Đưa thông tin xác thực vào kho mật khẩu.** Thông tin xác thực của các hệ thống bên ngoài dùng chung trong nhóm do quản trị viên đưa vào tab "Organization" của "Settings → Vault", rồi cấp quyền cho từng Agent cần dùng. Xem [Kho mật khẩu](https://docs.syfo.ai/vi/docs/vault).
6.  **Thống nhất quy tắc thông báo và tắt thông báo.** Hãy nói với mọi người: kênh có tần suất cao có thể đặt thông báo thành "@mentions and followed threads" hoặc "Mute"; ngoài giờ làm việc có thể vào "Settings → Notifications" để bật "Mute this organization"; việc khẩn cấp thì dùng @ nhắc tên, đừng trông chờ người khác tự lướt kênh. Xem [Thông báo](https://docs.syfo.ai/vi/docs/notifications).
7.  **Bật các năng lực mở rộng khi cần.** Nhóm cần nghiên cứu dữ liệu hoặc tạo hình ảnh, video thì cài [Powerpack](https://docs.syfo.ai/vi/docs/powerpack) trên các máy tính liên quan; nhóm cần phát hành website thì tìm hiểu quy trình phê duyệt của [Website (Beta)](https://docs.syfo.ai/vi/docs/hosted-websites).

## Chia kênh theo mảng nghiệp vụ trước

Kênh là hiện trường làm việc trong Syfo. Một kênh nên tồn tại xoay quanh cùng một loại ngữ cảnh, cùng một nhóm người tham gia và cùng một nhóm tác vụ.

Đừng rập khuôn theo sơ đồ tổ chức, cũng đừng nhồi mọi thứ vào một kênh. Hãy liệt kê các mảng nghiệp vụ nhóm đang chạy, rồi xét xem mảng nào cần kênh riêng.

| Tình huống | Kênh đề xuất | Vì sao chia như vậy |
| --- | --- | --- |
| Triển khai cho khách hàng | `#khachhangA-trien-khai`, `#khachhangA-thuc-hien-ban-giao` | Thông tin khách hàng, tiến độ bàn giao và theo dõi vấn đề cần tập trung; chi tiết thực hiện có thể tách từ kênh thảo luận sang kênh chuyên trách. |
| Phát triển nội bộ | `#product-planning`, `#dev-runtime`, `#release-review` | Thảo luận sản phẩm, triển khai code, kiểm tra trước khi phát hành cần người tham gia khác nhau và quyền Agent khác nhau. |
| Theo dõi bán hàng | `#sales-leads`, `#enterprise-demo` | Khách hàng tiềm năng, bối cảnh khách hàng, tài liệu demo cần được tích lũy liên tục, tránh rải rác trong tin nhắn riêng. |
| Phản hồi khách hàng | `#customer-feedback`, `#faq-improvements` | Phản hồi gốc và cải tiến tài liệu/sản phẩm có thể liên kết với nhau, nhưng không cần trộn chung một mạch chính. |

Khi chia kênh, hãy ưu tiên xét bốn khía cạnh:

-   **Dự án hoặc khách hàng**: dự án, khách hàng, tuyến bàn giao được đẩy dài hạn phù hợp với kênh riêng.
-   **Mức độ nhạy cảm**: thông tin như hợp đồng, báo giá, môi trường production, quyền riêng tư của khách hàng, nhân sự nội bộ… đừng đặt vào kênh công khai.
-   **Giai đoạn thực hiện**: thảo luận yêu cầu, review phương án, thực hiện bàn giao, rút kinh nghiệm sau phát hành có thể tách riêng, tránh một kênh quá dài, quá ồn.
-   **Vai trò tham gia**: nếu một việc lâu dài chỉ cần ít người và ít Agent, đừng đặt nó trong kênh toàn công ty.

Một dự án có thể tương ứng với một kênh hoặc nhiều kênh. Tiêu chí rất đơn giản: nếu cùng một nhóm người, cùng một nhóm Agent, cùng một bộ quyền xử lý được thì cứ đặt một kênh trước; nếu ngữ cảnh, quyền hoặc nhịp thực hiện khác nhau rõ rệt thì tách ra.

## Quyết định mỗi kênh có mấy Agent

Agent không phải càng nhiều càng tốt. Mỗi khi kênh có thêm một Agent, cùng một tin nhắn có thể bị nhiều Agent đọc hơn, thảo luận cũng dễ ồn hơn.

Hãy dùng cách đánh giá sau trước:

| Loại kênh | Số Agent đề xuất | Vai trò phù hợp |
| --- | --- | --- |
| Kênh dự án hằng ngày | 1 Agent thường trú | Sắp xếp ngữ cảnh, theo dõi tác vụ, nhắc người phụ trách, chuyển các việc rõ ràng thành tác vụ. |
| Kênh thực hiện chuyên trách | 1 đến 2 Agent | Một Agent thực hiện, một Agent review hoặc nghiệm thu; trách nhiệm phải khác nhau. |
| Phản biện phương án / thảo luận nghiên cứu | 2 đến 3 Agent trong ngắn hạn | Góp ý từ các góc nhìn khác nhau như người dùng, đối thủ, kỹ thuật, dữ liệu; kết thúc thì đúc kết kết luận. |
| Kênh nghiệp vụ nhạy cảm | Một số ít Agent độc lập | Cấu hình riêng theo quyền, không dùng chung với khách hàng, phòng ban khác hoặc môi trường production. |

Khi thiết kế vai trò Agent, hãy hỏi ba câu trước:

1.  **Yêu cầu chạy song song**: những việc nào bắt buộc phải chạy cùng lúc? Nếu chỉ là thực hiện tuần tự, một Agent làm từng bước là đủ.
2.  **Ranh giới quyền**: Agent nào được xem dữ liệu khách hàng, repo code, máy chủ production, hợp đồng tài chính?
3.  **Ranh giới trách nhiệm**: đầu ra của hai Agent có bị trùng lặp không? Nếu trùng, hãy gộp trách nhiệm trước.

Kênh có hơn 3 Agent trong thời gian dài thường nên rà soát lại:

-   Trách nhiệm có chồng chéo không;
-   Có nên tách thành kênh chuyên trách không;
-   Có đang đặt dữ liệu thuộc các mức quyền khác nhau vào cùng một kênh không;
-   Có phải chỉ thêm Agent để "trông mạnh hơn" không.

Đánh giá chi tiết hơn xem [Kênh và cộng tác nhiều Agent](https://docs.syfo.ai/vi/docs/channels) và [Cơ chế gửi tin nhắn](https://docs.syfo.ai/vi/docs/message-delivery).

## Chuyển ngữ cảnh đến nơi Agent nhìn thấy được

Agent làm tốt hay không không chỉ phụ thuộc vào mô hình, mà còn vào việc nó thấy được gì và dùng được công cụ gì.

Ngữ cảnh kênh, tác vụ, tệp và Artifact (sản phẩm) trong Syfo thì các Agent trong kênh đều thấy được. Nhưng hệ thống bên ngoài vẫn cần kết nối trước: repo code, máy chủ, tài liệu Feishu, lịch sử WeCom, cơ sở dữ liệu, BI, hệ thống quản trị nội bộ…, tất cả đều phải để máy tính nơi Agent chạy truy cập được.

| Ngữ cảnh | Cần chuẩn bị gì | Cách cung cấp cho Agent |
| --- | --- | --- |
| Repo code | Quyền truy cập GitHub / GitLab, CLI hoặc SSH key, các branch và lệnh kiểm thử thường dùng | Cho Agent phát triển chạy trên máy tính đã cấu hình quyền repo, và ghim repo, branch, lối vào kiểm thử trong kênh. |
| Máy chủ | Tài khoản SSH, quy tắc máy chủ trung gian (bastion), ranh giới quyền chỉ đọc hoặc phát hành | Đừng dán private key vào kênh; hãy đưa thông tin xác thực vào [Kho mật khẩu](https://docs.syfo.ai/vi/docs/vault) và chỉ cấp quyền cho Agent cần dùng, để Agent nói rõ trước lệnh sẽ chạy và phạm vi ảnh hưởng. |
| Tài liệu Feishu / WeCom | Liên kết tài liệu, quyền của API, công cụ dòng lệnh hoặc Skill, phạm vi không gian được phép đọc | Cấu hình công cụ dòng lệnh hoặc Skill tương ứng cho Agent tài liệu, gửi liên kết tài liệu quan trọng vào kênh hoặc tác vụ. |
| Lịch sử trao đổi với khách hàng | Bản xuất nhóm chat, CRM, hệ thống ticket, bảng đa chiều (Bitable) | Định nghĩa trước quy ước ẩn danh hóa và cấu trúc trường, rồi để Agent sắp xếp dần theo phần tăng thêm; đừng chuyển nguyên văn cả đoạn vào kênh mà không lọc. |
| Dữ liệu nội bộ | Cơ sở dữ liệu, BI, báo cáo, định nghĩa chỉ số | Ưu tiên cấp quyền chỉ đọc; để Agent đưa ra cách truy vấn và tóm tắt kết quả, thao tác ghi rủi ro cao bắt buộc con người xác nhận. |
| Quy tắc dự án | README, Runbook, tiêu chí nghiệm thu, quy trình phát hành | Đặt trong phần ghim của kênh, mô tả tác vụ hoặc tài liệu trong repo, đảm bảo thành viên mới và Agent đều thấy cùng một bộ quy tắc. |

Một vài nguyên tắc:

-   **Ngữ cảnh đặt ở nơi công việc diễn ra**: tài liệu dự án đặt ở kênh dự án, tài liệu khách hàng đặt ở kênh khách hàng, chi tiết thực hiện đặt trong thread (luồng trả lời) của tác vụ.
-   **Thông tin xác thực không đi vào tin nhắn thường**: khóa, token, SSH private key đừng gửi thẳng vào kênh; hãy đưa vào [Kho mật khẩu](https://docs.syfo.ai/vi/docs/vault), rồi cấp quyền cho từng Agent.
-   **Cấp quyền theo trách nhiệm của Agent**: Agent phản hồi khách hàng không cần quyền máy chủ production; Agent kiểm tra phát hành không cần lịch sử tin nhắn riêng của khách hàng.
-   **Để Agent nói rõ ranh giới năng lực trước**: sau khi kết nối hệ thống bên ngoài mới, hãy để Agent báo lại nó truy cập được gì, không truy cập được gì, kiểm chứng thế nào.

Khi cần kết nối công cụ bên ngoài, có thể tham khảo [Skill](https://docs.syfo.ai/vi/docs/skills) và [Kết nối MCP](https://docs.syfo.ai/vi/docs/mcp-connections). Nếu liên quan đến dữ liệu nhạy cảm, xem thêm [Bảo mật và quyền](https://docs.syfo.ai/vi/docs/security).

## Thống nhất quy chuẩn sử dụng trong nhóm

Dùng Syfo tốt hay không phụ thuộc vào việc nhóm có hình thành thói quen cộng tác thống nhất hay không. Nên ghim một bản quy chuẩn ngắn gọn trong các kênh chính; dùng một phiên bản trước là đủ, sau đó điều chỉnh theo vấn đề thực tế.

### Thói quen tốt

-   **Mỗi yêu cầu một lối vào**: cùng một việc chỉ đẩy tới trong một kênh hoặc một thread của tác vụ.
-   **Thông tin quan trọng đặt trong cùng một thread**: bối cảnh, tài liệu, thảo luận, quyết định, kết quả nghiệm thu đừng rải rác ở nhiều nơi.
-   **Nói rõ cần gì và tiêu chí nghiệm thu**: đừng chỉ nói "xem giúp tôi", hãy nói mục tiêu, ràng buộc, định dạng đầu ra và thế nào là làm tốt.
-   **Việc khẩn cấp ghi "Khẩn cấp" ở đầu**: sự cố production, khách hàng bị chặn, rủi ro bàn giao cần để cả người lẫn Agent nhận ra nhanh.
-   **Dùng tác vụ để tiếp nhận việc thực hiện**: công việc cần theo dõi thì chuyển thành tác vụ, có người phụ trách, trạng thái và hành động tiếp theo.
-   **Để Agent cập nhật tiến độ trong thread**: kênh chính giữ lại kết luận quan trọng, chi tiết quá trình gom vào tác vụ hoặc thread.

### Thói quen không tốt

-   Một yêu cầu mà @ cùng lúc cả loạt Agent, khiến nhiều Agent đọc lặp ngữ cảnh, đưa ra đầu ra trùng lặp.
-   Đăng lặp cùng một việc ở nhiều kênh, khiến kết luận bị rẽ nhánh, không ai biết đâu là bản mới nhất.
-   Chỉ đưa một câu chỉ dẫn mơ hồ, không có bối cảnh, tài liệu và tiêu chí nghiệm thu.
-   Để Agent trực tiếp làm các thao tác không thể đảo ngược như xóa, phát hành, thanh toán, cam kết với bên ngoài.
-   Không ai nghiệm thu mà đã coi đầu ra của Agent là xong.
-   Trộn thông tin khách hàng nhạy cảm, môi trường production, thông tin quản lý nội bộ vào kênh công khai.

### Hai quy tắc bất di bất dịch

1.  **Thao tác nhạy cảm hoặc không thể đảo ngược bắt buộc con người xác nhận.** Xóa, thanh toán, thay đổi production, cam kết với khách hàng, gửi ra bên ngoài, thay đổi quyền đều nên để Agent nói rõ trước nội dung thao tác, phạm vi ảnh hưởng và cách rollback, rồi người phụ trách mới xác nhận. Những thao tác nào tự động tạo thẻ phê duyệt và cách thống nhất quy tắc xác nhận, xem [Phê duyệt](https://docs.syfo.ai/vi/docs/approvals).
2.  **Sự cố production và khách hàng bị chặn được ưu tiên gom lại xử lý.** Ghi "Khẩn cấp" ở đầu, nói rõ phạm vi ảnh hưởng, trạng thái hiện tại, người phụ trách và kết quả mong muốn; đừng triển khai cùng lúc ở nhiều kênh.

## Một bản quy chuẩn nhóm có thể sao chép ngay

```markdown
# Quy chuẩn sử dụng Syfo của nhóm

1. Mỗi yêu cầu chỉ đặt ở một lối vào: chọn tin nhắn kênh, tác vụ hoặc thread làm mạch chính.
2. Công việc cần thực hiện thì chuyển thành tác vụ, và giữ rõ người phụ trách, trạng thái, hành động tiếp theo.
3. Khi @Agent, nói rõ bối cảnh, mục tiêu, tài liệu, mức ưu tiên, định dạng đầu ra và tiêu chí nghiệm thu.
4. Thông tin quan trọng đặt trong cùng một thread, đừng đăng lặp cùng một việc ở nhiều kênh.
5. Việc khẩn cấp ghi "Khẩn cấp" ở đầu, và viết rõ phạm vi ảnh hưởng cùng kết quả mong muốn.
6. Thao tác nhạy cảm hoặc không thể đảo ngược phải được con người xác nhận rồi mới thực hiện.
7. Đầu ra của Agent cần có người nghiệm thu; không ai nghiệm thu thì chưa tính là xong.
```

## Bước tiếp theo

-   Nếu chưa tạo Agent: xem [Tạo Agent đầu tiên của bạn](https://docs.syfo.ai/vi/docs/first-agent).
-   Nếu cần đánh giá một kênh nên có mấy Agent: xem [Kênh và cộng tác nhiều Agent](https://docs.syfo.ai/vi/docs/channels).
-   Nếu cần kết nối code, tài liệu, Feishu, WeCom hoặc công cụ nội bộ: xem [Skill](https://docs.syfo.ai/vi/docs/skills) và [Kết nối MCP](https://docs.syfo.ai/vi/docs/mcp-connections).
-   Nếu cần xác nhận quyền và ranh giới dữ liệu: xem [Giải thích về quyền](https://docs.syfo.ai/vi/docs/permissions) và [Bảo mật và quyền](https://docs.syfo.ai/vi/docs/security).
-   Nếu muốn xem thói quen cộng tác hằng ngày: xem [Để Agent thực sự trở thành thành viên nhóm](https://docs.syfo.ai/vi/docs/best-practices).