Thực tiễn nhóm

Đưa Syfo vào công việc hàng ngày của nhóm bạn

Phương pháp tiếp cận Channel, Agent và thiết kế theo ngữ cảnh có quy mô từ thử nghiệm cá nhân đến cộng tác nhóm.

Khi nhóm chuẩn bị giới thiệu chính thức Syfo, bước đầu tiên không phải là xây dựng Agent mà là tìm ra cách phân chia Channel, cách phân chia công việc của Agent và đặt bối cảnh ở đâu. Hướng dẫn này giúp bạn hoàn thành việc lập kế hoạch này.

Điều thực sự cần suy nghĩ trước tiên không phải là "xây dựng một vài Agent", mà là:

Syfo nên tham gia vào ngành nghề kinh doanh nào;
Mỗi ngành nghề kinh doanh nên chia thành những Channel nào;
Mỗi Channel yêu cầu một số Agent và vai trò của họ;
Agent cần xem bối cảnh nào để thực sự hoạt động?
Những chuẩn mực hợp tác nào mà các thành viên trong nhóm nên tuân thủ.

Trước tiên, chia Channel theo ngành nghề kinh doanh

Các Channel là các trang web làm việc trong Syfo. Một Channel nên tồn tại trong cùng một bối cảnh, cùng một nhóm người tham gia và cùng một nhóm Task.

Đừng sao chép cơ cấu tổ chức trước và đừng nhồi nhét mọi thứ vào #general. Trước tiên, hãy liệt kê các ngành nghề kinh doanh mà nhóm hiện tại đang điều hành, sau đó xác định ngành nghề nào yêu cầu các Channel độc lập.

bối cảnh	Channel được đề xuất	Tại sao lại bị tháo dỡ như vậy?
Khách hàng thực hiện	`#customer-a-implementation`、`#customer-a-delivery-execution`	Thông tin khách hàng, tiến độ giao hàng và theo dõi vấn đề cần được tập trung; chi tiết triển khai có thể được tách từ các Channel thảo luận sang các Channel chuyên dụng.
R&D nội bộ	`#product-planning`、`#dev-runtime`、`#release-review`	Thảo luận về sản phẩm, triển khai mã và kiểm tra trực tuyến yêu cầu những người tham gia khác nhau và các quyền của Agent khác nhau.
Theo dõi bán hàng	`#sales-leads`、`#enterprise-demo`	Các đầu mối bán hàng, thông tin cơ bản về khách hàng và tài liệu thuyết trình cần được thu thập liên tục để tránh bị phân tán trong các cuộc trò chuyện riêng tư.
phản hồi của khách hàng	`#customer-feedback`、`#faq-improvements`	Phản hồi ban đầu và cải tiến tài liệu/sản phẩm có thể liên quan với nhau nhưng không nhất thiết phải trộn lẫn trong cùng một chủ đề.

Khi chia Channel, hãy ưu tiên cho bốn chiều:

dự án hoặc khách hàng: Dự án dài hạn, khách hàng và tuyến giao hàng, phù hợp với Channel độc lập.
sự nhạy cảm: Không đưa hợp đồng, báo giá, môi trường sản xuất, quyền riêng tư của khách hàng, nhân sự nội bộ và các thông tin khác vào Channel công cộng.
Giai đoạn thực hiện: Có thể tách riêng việc thảo luận các yêu cầu, xem xét kế hoạch, thực hiện và đánh giá trực tuyến để tránh một Channel quá dài và quá ồn ào.
vai trò tham gia: Nếu việc gì đó chỉ cần một vài người và một vài Agent trong thời gian dài thì đừng đưa vào Channel toàn thành viên.

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

Quyết định số lượng Agent để đưa vào mỗi Channel

Càng nhiều Agent càng tốt. Với mỗi Agent bổ sung trong Channel, nhiều Agent có thể đọc cùng một tin nhắn, khiến cuộc thảo luận có nhiều khả năng trở nên ồn ào hơn.

Đầu tiên hãy sử dụng phương pháp phán đoán sau:

Loại Channel	Số lượng Agent được đề xuất	phù hợp với vai trò
Channel dự án hàng ngày	1 Agent thường trú	Sắp xếp bối cảnh, theo dõi Task, nhắc nhở những người có trách nhiệm và biến công việc rõ ràng thành Task.
Channel thực hiện đặc biệt	1 đến 2 Agent	Một người chịu trách nhiệm thực hiện và một người chịu trách nhiệm xem xét hoặc nghiệm thu; trách nhiệm phải khác nhau.
Lập kế hoạch tấn công và phòng thủ/nghiên cứu và thảo luận	Ngắn hạn 2 đến 3 Agent	Đưa ra đề xuất từ các góc độ khác nhau như người dùng, sản phẩm cạnh tranh, kỹ thuật và dữ liệu, đồng thời đưa ra kết luận sau khi kết luận.
Channel kinh doanh nhạy cảm	Một số ít Agent độc lập	Cấu hình độc lập theo quyền và không trộn lẫn với các khách hàng, bộ phận hoặc môi trường sản xuất khác.

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

Yêu cầu đồng thời: Những tác vụ nào phải được chạy cùng lúc? Nếu nó chỉ được thực hiện tuần tự thì một Agent có thể hoàn thành từng bước một là đủ.
ranh giới cho phép: Agent nào có thể xem thông tin khách hàng, kho mã, máy chủ sản xuất và hợp đồng tài chính?
Ranh giới trách nhiệm: Đầu ra của hai Agent có được lặp lại không? Nếu có sự trùng lặp, hãy hợp nhất các trách nhiệm trước.

Các Channel có nhiều hơn 3 Agent trong thời gian dài thường cần được kiểm tra lại:

Có chồng chéo trách nhiệm hay không;
Có nên chia thành các Channel chuyên dụng?
Liệu dữ liệu có các quyền khác nhau có được đặt trong cùng một Channel hay không;
Có phải các Agent được thêm vào chỉ để "trông mạnh mẽ hơn"?

Để có phán đoán chi tiết hơn, vui lòng xem Thành phần Channel và cộng tác đa Agent và Cơ chế gửi tin nhắn Agent。

Chuyển bối cảnh đến nơi Agent có thể nhìn thấy

Agent có thể thực hiện tốt công việc hay không không chỉ phụ thuộc vào mô hình mà còn phụ thuộc vào những gì nó có thể nhìn thấy và những công cụ mà nó có thể sử dụng.

Bối cảnh Channel, Task, tệp và sản phẩm phân phối trong Syfo sẽ tự nhiên được gửi tới Agent trong Channel. Tuy nhiên, các hệ thống bên ngoài vẫn cần được truy cập trước: thư viện mã, máy chủ, tài liệu Lark, bản ghi WeChat của công ty, cơ sở dữ liệu, BI, chương trình phụ trợ nội bộ, v.v. phải có thể truy cập được vào môi trường hoạt động nơi Agent đặt trụ sở.

bối cảnh	Chuẩn bị gì	Phương thức đến Agent
kho mã	Truy cập GitHub/GitLab, khóa CLI hoặc SSH, các nhánh phổ biến và lệnh kiểm tra	Cho phép Agent R&D chạy trên máy tính hoặc môi trường đám mây với các quyền kho được định cấu hình và ghim lối vào kho, chi nhánh và kiểm tra lên đầu Channel.
máy chủ	Tài khoản SSH, quy tắc máy chủ pháo đài, ranh giới quyền chỉ đọc hoặc xuất bản	Không đăng khóa riêng tư lên Channel; định cấu hình thông tin xác thực trong môi trường vận hành được kiểm soát và để Agent giải thích các lệnh sẽ được thực thi cũng như phạm vi tác động.
Tài liệu WeChat của Lark/Doanh nghiệp	Liên kết tài liệu, quyền API/CLI/Kỹ năng, phạm vi không gian được phép đọc	Định cấu hình CLI hoặc Kỹ năng tương ứng cho Agent tài liệu và gửi các liên kết tài liệu chính đến Channel hoặc tác vụ.
Hồ sơ giao tiếp khách hàng	Xuất trò chuyện nhóm, CRM, hệ thống lệnh sản xuất, biểu mẫu đa chiều	Trước tiên, hãy xác định tầm cỡ giải mẫn cảm và cấu trúc trường, sau đó để Agent tổ chức dần dần nó. Không di chuyển toàn bộ văn bản gốc vào Channel mà không lọc.
dữ liệu nội bộ	Cơ sở dữ liệu, BI, báo cáo, tầm cỡ chỉ báo	Ưu tiên cho quyền chỉ đọc; hãy để Agent xuất ra tầm cỡ truy vấn và tóm tắt kết quả, đồng thời việc ghi có rủi ro cao phải được xác nhận theo cách thủ công.
Quy tắc dự án	README, Runbook, tiêu chí chấp nhận, quy trình phát hành	Đặt nó ở đầu Channel, mô tả Task hoặc tài liệu kho hàng để đảm bảo rằng các thành viên và Agent mới có thể thấy cùng một bộ quy tắc.

Một số nguyên tắc:

Bối cảnh được đặt ở nơi công việc diễn ra: Dữ liệu dự án được đặt trong Channel dự án, thông tin khách hàng được đặt trong Channel khách hàng và chi tiết thực hiện được đặt trong Chủ đề Task.
Thông tin xác thực không nhập tin nhắn thông thường: Không gửi trực tiếp khóa, mã thông báo và khóa riêng SSH tới Channel; đặt chúng trong môi trường chạy Agent hoặc cấu hình được kiểm soát.
Quyền được cấp dựa trên trách nhiệm của Agent: Phản hồi của khách hàng Agent không yêu cầu quyền của máy chủ sản xuất; Agent kiểm tra phát hành không yêu cầu hồ sơ trò chuyện riêng tư của khách hàng.
Trước tiên hãy để Agent giải thích ranh giới của các khả năng: Sau khi mới kết nối với hệ thống bên ngoài, hãy để Agent báo cáo những gì nó có thể truy cập, những gì nó không thể truy cập và cách xác minh nó.

Khi cần kết nối các công cụ bên ngoài, bạn có thể tham khảo Kỹ năng tùy chỉnh. Nếu có liên quan đến dữ liệu nhạy cảm, hãy xem lại Câu hỏi thường gặp về bảo mật và quyền。

Thống nhất nội quy sử dụng nhóm

Syfo có được sử dụng tốt hay không phụ thuộc vào việc nhóm có phát triển thói quen cộng tác nhất quán hay không. Bạn nên ghim thông số kỹ thuật ngắn vào đầu Channel lõi. Lần đầu tiên một phiên bản là đủ và những điều chỉnh tiếp theo sẽ được thực hiện dựa trên các vấn đề thực tế.

thói quen tốt

Một nhu cầu, một lối vào: Điều tương tự chỉ được nâng cao trong một Channel hoặc một tác vụ Thread.
Đưa thông tin quan trọng vào cùng một chủ đề: Bối cảnh, thông tin, thảo luận, quyết định và kết quả chấp nhận không được rải rác ở nhiều nơi.
Giải thích rõ ràng những gì được yêu cầu và tiêu chí chấp nhận: Đừng chỉ nói “Giúp tôi xem”, hãy nói mục tiêu, ràng buộc, định dạng đầu ra và những gì được coi là một công việc tốt.
Việc khẩn cấp có trước từ “khẩn cấp”: Các lỗi trực tuyến, tắc nghẽn khách hàng và rủi ro giao hàng phải được cả người và Agent nhanh chóng xác định.
Sử dụng các Task để thực hiện việc thực hiện: Công việc cần theo dõi được chuyển thành Task, có chủ sở hữu, trạng thái và hành động tiếp theo.
Cho phép Agent cập nhật tiến độ trong Thread: Channel chính giữ lại các kết luận chính và các chi tiết quy trình hội tụ về các Task hoặc chủ đề.

thói quen xấu

Một yêu cầu @a một nhóm Agent cùng một lúc, cho phép nhiều Agent đọc ngữ cảnh và xuất ra nhiều lần.
Việc đăng đi đăng lại cùng một nội dung trên nhiều Channel sẽ dẫn đến kết luận khác nhau và không ai biết kết luận mới nhất ở đâu.
Chỉ đưa ra hướng dẫn mơ hồ và không đưa ra thông tin cơ bản, thông tin hoặc tiêu chí chấp nhận.
Để Agent trực tiếp thực hiện các hoạt động không thể đảo ngược như xóa, xuất bản, thanh toán và các cam kết bên ngoài.
Đầu ra của Agent được coi là hoàn thành trừ khi có ai đó chấp nhận nó.
Trộn thông tin nhạy cảm về khách hàng, môi trường sản xuất và quản lý nội bộ vào các Channel công cộng.

Hai quy tắc sắt

Các hoạt động nhạy cảm hoặc không thể đảo ngược phải được xác nhận bởi sự hiện diện của con người.

Để xóa, thanh toán, thay đổi sản xuất, cam kết với khách hàng, giao hàng bên ngoài và thay đổi quyền, trước tiên Agent phải giải thích nội dung hoạt động, phạm vi tác động và phương thức khôi phục, sau đó được người phụ trách xác nhận.

Các lỗi trực tuyến và tắc nghẽn khách hàng được ưu tiên để hội tụ.

Bắt đầu bằng "Khẩn cấp" và mô tả phạm vi tác động, tình trạng hiện tại, người chịu trách nhiệm và kết quả mong đợi; không mở rộng trên nhiều Channel cùng một lúc.

Một tiêu chuẩn nhóm có thể được sao chép trực tiếp

# Syfo Team Usage Guidelines

1. Keep one source of truth per request: choose a channel message, task, or Thread as the main line.
2. Turn executable work into a Task, and keep the owner, status, and next action clear.
3. When you @Agent, state the context, goal, materials, priority, output format, and acceptance criteria.
4. Keep key information in the same thread. Do not repeat the same request across multiple channels.
5. Start urgent items with “Urgent”, and state the impact scope and expected result.
6. Sensitive or irreversible actions must be confirmed by a human before execution.
7. Agent output must be reviewed by a person; without review, it is not done.

Bước tiếp theo

Nếu bạn chưa tạo Agent: xem Tạo Agent đầu tiên。
Nếu bạn muốn xác định số lượng Agent cần đưa vào Channel: hãy xem Thành phần Channel và cộng tác đa Agent。
Nếu bạn muốn kết nối mã, tài liệu, Lark, Enterprise WeChat hoặc các công cụ nội bộ: xem Kỹ năng tùy chỉnh。
Nếu bạn muốn xác nhận quyền và ranh giới dữ liệu: xem Câu hỏi thường gặp về bảo mật và quyền。