Agentville

Một đội trợ thủ cho Claude, biết lên kế hoạch, kiểm tra và báo cáo công việc

Mục lục tài liệu

Tài liệu

Cách hoạt động

Mỗi yêu cầu bạn gửi đều đi qua một số hoặc cả sáu giai đoạn, luôn theo cùng một thứ tự: Discuss, Plan, Execute, Validate, Review và Report. Agentville bỏ qua những giai đoạn mà yêu cầu không cần, nên một câu hỏi nhanh sẽ đi thẳng tới câu trả lời.

Sáu giai đoạn

Sơ đồ sáu giai đoạn. Agentville phân loại yêu cầu của bạn theo mức chăm chút mà nó cần: một yêu cầu lớn hoặc chưa rõ đi vào Discuss, rồi sang Plan khi bạn đồng ý bắt đầu, rồi sang Execute; một yêu cầu nhỏ và rõ ràng đi thẳng vào Execute; một câu hỏi nhanh đi thẳng tới Report. Execute dẫn tới Validate, rồi Review, rồi Report. Các mũi tên chấm chấm dẫn ngược từ Validate và từ Review về Execute.
Sáu giai đoạn, từ yêu cầu của bạn đến bản báo cáo.

Cùng luồng đó, từng bước một:

  1. Agentville quyết định yêu cầu của bạn cần được chăm chút đến mức nào.
  2. Một yêu cầu lớn hoặc chưa rõ bắt đầu ở Discuss. Khi bạn đồng ý bắt đầu, nó chuyển sang Plan rồi sang Execute.
  3. Một yêu cầu nhỏ và rõ ràng đi thẳng vào Execute.
  4. Một câu hỏi nhanh đi thẳng tới Report.
  5. Sau Execute, công việc đi qua Validate và Review, rồi tới Report.
  6. Khi một bước kiểm tra ở Validate không đạt, hoặc Review yêu cầu chỉnh sửa, công việc quay lại Execute.

Các mũi tên chấm chấm là những vòng quay lại (loop-back): khi một bước kiểm tra không đạt hoặc bản rà soát yêu cầu chỉnh sửa, công việc quay lại Execute và được kiểm tra lần nữa. Sau ba vòng, Agentville dừng lại và báo cáo những gì còn dang dở, thay vì cứ quay vòng mãi.

Giai đoạnĐiều gì diễn raBạn làm gì
DiscussClaude trao đổi kỹ yêu cầu với bạn: những gì nằm trong phạm vi, những gì nằm ngoài và thế nào thì gọi là "xong". Chưa có gì bị thay đổi.Trả lời các câu hỏi. Khi Claude nói "Mọi điểm đã được thống nhất, bạn còn muốn bổ sung gì không?", hãy thêm điều còn thiếu hoặc bảo nó cứ tiến hành.
PlanClaude viết một kế hoạch ngắn: mục tiêu và danh sách việc cần làm, mỗi việc kèm một bước kiểm tra cho thấy nó đã xong.Thường không cần làm gì; Claude có thể hỏi một thông tin còn thiếu hoặc xin bạn đồng ý cho tìm kiếm trên web. Claude cho bạn xem bản tóm tắt rồi làm tiếp; nó không chờ bạn phê duyệt.
ExecuteMột trợ thủ thực hiện từng việc trong kế hoạch.Không cần làm gì. Từ đây trở đi Claude không hỏi gì nữa.
ValidateMột trợ thủ khác kiểm tra từng việc và giữ lại bằng chứng.Không cần làm gì.
ReviewMột trợ thủ nữa đọc lại công việc, đối chiếu với kế hoạch và bằng chứng, rồi chấp thuận hoặc yêu cầu chỉnh sửa.Không cần làm gì.
ReportClaude cho bạn biết việc gì đã làm, điều gì đã được kiểm tra và những gì còn dang dở.Đọc báo cáo và đưa ra mọi quyết định được liệt kê cho bạn.

Dòng đầu tiên của một câu trả lời cho biết Claude vừa chuyển sang giai đoạn nào, được in đậm, chẳng hạn Stage: Plan. Khi một giai đoạn được lặp lại sau một vòng quay lại, dòng đó cũng ghi rõ, chẳng hạn Stage: Execute (2nd loop-back).

Các trợ thủ

Claude mà bạn trò chuyện cùng dẫn dắt yêu cầu nhưng không tự tay làm việc. Nó giao từng việc cho một trợ thủ, gọi là agent, chỉ lo một nhiệm vụ. Mỗi trợ thủ báo cáo lại theo một khuôn cố định, nên Claude luôn biết kết quả trả về là gì.

Trợ thủNhiệm vụ
Lead (Claude mà bạn trò chuyện cùng)Điều hành toàn bộ yêu cầu: chọn các giai đoạn, giao việc và viết cho bạn. Trong Claude Code, vai trò dẫn dắt này có thể là một agent tên pod-lead, khi bạn khởi động Claude Code cùng nó.
WorkerLàm việc: viết, chỉnh sửa, tra cứu trong các tệp của bạn.
ValidatorKiểm tra xem công việc có làm đúng điều cần làm không, và giữ lại bằng chứng. Nó không bao giờ tự sửa công việc.
ReviewerĐọc phần việc đã xong, đối chiếu với kế hoạch và bằng chứng, rồi đưa ra nhận định.
ScoutTra cứu trên web, nhưng chỉ khi bạn đã đồng ý.

Agentville cũng chọn mức suy nghĩ cho từng trợ thủ, để việc đơn giản vẫn nhanh còn việc khó được chăm chút hơn.

Khi nào nó hỏi bạn

Agentville hỏi từ sớm rồi bắt tay vào việc.

  • Ở Discuss, nó hỏi bao nhiêu câu cũng được, miễn là đủ để hiểu yêu cầu.
  • Ở Plan, nó chỉ hỏi một thông tin mà kế hoạch không thể thiếu. Nó không bao giờ xin bạn phê duyệt kế hoạch.
  • Từ Execute trở đi, nó không hỏi gì cả. Mọi thứ cần đến bạn, chẳng hạn một chỗ thiếu, một điều cản trở hay một lựa chọn, đều được đưa vào báo cáo cuối để bạn quyết định.

Có hai việc nó luôn hỏi trước:

  • Tìm kiếm trên web. Agentville không tìm kiếm trên web hay cử scout đi khi chưa có lời đồng ý rõ ràng của bạn. Nó nêu rõ những câu hỏi và trang web nó muốn dùng, và lời đồng ý của bạn chỉ áp dụng cho đúng những thứ đó.
  • Mọi việc không thể hoàn tác. Nó sẽ không đăng, gửi, xoá, gộp (merge) hay trả tiền cho bất cứ thứ gì, trừ khi chính bạn đã nhờ đúng việc đó, bằng lời của mình.

Ghi chép được lưu ở đâu

Khi Agentville làm việc với tệp, chẳng hạn trong Cowork, nó giữ ghi chép, kế hoạch và báo cáo của mỗi yêu cầu trong một thư mục riêng. Bạn không cần xem ở đó; báo cáo sẽ cho bạn biết những gì cần biết.

Hai trợ thủ tí hon bên cột biển chỉ đường: một người cầm ống nhòm nhìn về phía trước, người kia mang phong bì đi tới.