Tài liệu NocoBase 3 tiếng Việt, do OXMODE biên dịch

3Tài liệu NocoBase 3

Studio · Thiết lập Studio

Đi qua yêu cầu đầu tiên

Nêu một yêu cầu nhỏ và xem đội Agent lên kế hoạch, xây dựng và review nó. Trả lời câu hỏi, nghiệm thu và merge, rồi xác nhận toàn bộ quy trình chạy trọn vẹn từ đầu đến cuối.

Khi Studio, kết nối Git, runtime, Agent và dự án đều đã thiết lập, hãy đưa một yêu cầu nhỏ đi qua toàn bộ quy trình. Trong quá trình đó, bạn sẽ thấy đội Agent đẩy một issue tiến lên ra sao và xác nhận mọi phần đã được kết nối trước khi mời đồng nghiệp.

Trước khi bắt đầu

  • Issue "Initialize project" của dự án đã xong. Xem Tạo dự án.
  • Ít nhất hai Agent đã bật, và Agent điều phối đã có lựa chọn chính. Xem Bật Agent.
  • Có một runtime đang trực tuyến.

1. Nêu yêu cầu

  1. Mở dự án và bấm New issue. Một phiên với Agent mở ra ở bên phải, kèm theo dự án hiện tại làm bối cảnh.

  2. Mô tả một yêu cầu nhỏ bằng ngôn ngữ nghiệp vụ, cùng cách bạn sẽ kiểm tra. Ví dụ:

    Plain text
    Thêm bảng Suppliers vào ứng dụng với tên, người liên hệ, số điện thoại và trạng thái (đang hoạt động hoặc tạm dừng), và thêm trang Suppliers vào thanh điều hướng, nơi có thể thêm, sửa và xem nhà cung cấp.
    Nghiệm thu: sau khi đăng nhập, mở trang Suppliers từ thanh điều hướng, thêm một nhà cung cấp và thấy nó trong danh sách.
  3. Gửi đi. Nếu yêu cầu đã rõ, Agent biến nó thành issue ngay. Nếu có gì chưa rõ, nó hỏi bạn trước.

  4. Khi issue đã được tạo, bấm Start 1 issue trong phiên, hoặc mở issue và bấm Start.

Để bỏ qua phiên trò chuyện, bấm Fill in manually và tự nhập tiêu đề cùng mô tả.

Xong khi: issue ở trạng thái In progress và người thực hiện là Agent điều phối.

2. Xem đội Agent làm việc

Mở issue. Dòng Now ở đầu trang luôn cho biết Agent nào đang làm, đã bao lâu và trên runtime nào, bên dưới là việc gì tiếp theo.

Activity hiển thị mọi lần giao việc của Agent điều phối: ai nhận bước, làm gì, đọc gì, khi nào xem là xong, và vì sao chọn Agent đó. Yêu cầu này thêm một bảng, nên Agent điều phối trước tiên nhờ một Agent giỏi thiết kế viết kế hoạch ngắn, rồi giao phần phát triển cho một Agent giỏi xây dựng. Agent xây dựng viết mã và test, chụp màn hình trong ứng dụng đang chạy, và mở PR từ nhánh agent/<issue key>. Cuối cùng, Agent điều phối nhờ một model khác review mã. Các phát hiện khi review được trả về để sửa, và bản sửa được review lại.

Một yêu cầu nhỏ như thế này mất khoảng nửa giờ từ lúc bắt đầu đến khi sẵn sàng nghiệm thu.

3 / 16PUR-23· Supplier ManagementIn progressFollowAsk agent

Chấm điểm và xếp hạng nhà cung cấp

Now
CXCodex · GPT-5.5 đang chạy “Hiện thực chấm điểm và xếp hạng theo kế hoạch” · 12 phút · Server 02
Next
Khi hiện thực xong, một Agent của nhà cung cấp khác sẽ review, rồi chuyển sang nghiệm thu.
OwnerZZhou HangExecutorCACoordinator agentPriorityHigh
PR #31agent/PUR-23Đang chạy kiểm tra
Đầu trang issue: ai đang làm và việc gì tiếp theo

Runs có bản ghi đầy đủ của mọi lượt chạy, hữu ích khi bạn cần tìm hiểu kỹ một vấn đề.

3. Trả lời câu hỏi

Khi có điều chưa rõ trong yêu cầu, như phải chọn giữa hai hướng làm, Agent điều phối chuyển issue sang Blocked và nêu rõ bạn cần quyết định gì. Nó hiện trên cùng trong My issues. Mở ra, bấm Reply trong thẻ Needs you và viết quyết định của bạn. Agent điều phối tiếp tục từ câu trả lời của bạn.

Nếu yêu cầu được viết rõ ràng, bước này có thể không bao giờ xuất hiện.

Nếu CI chưa được kết nối, bước này sẽ xuất hiện: PR không có kết quả kiểm tra, nên Agent điều phối hỏi nên thiết lập CI trước hay nghiệm thu không cần CI, dựa trên báo cáo bàn giao và ảnh chụp màn hình. Để chạy thử, bạn có thể trả lời "Lần này không dùng CI. Tôi sẽ nghiệm thu dựa trên báo cáo bàn giao và ảnh chụp màn hình rồi tự merge", và nó sẽ chuyển issue cho bạn nghiệm thu. Trước khi dùng thật, nhớ kết nối CI.

4. Nghiệm thu kết quả

Khi PR đã qua review và các kiểm tra, issue chuyển sang In review và xuất hiện trong mục Waiting for you ở My issues.

  1. Mở issue. Thẻ Needs you cho biết bạn được nhờ nghiệm thu gì, bên dưới là báo cáo bàn giao: trước đây thế nào, những gì thay đổi, đã kiểm tra ra sao, các vấn đề còn mở kèm đề xuất, và cuối cùng là tiêu chí nghiệm thu cùng ảnh chụp màn hình.
  2. Bấm View changes để xem PR.
  3. Nếu CI đã kết nối, mở preview từ trang issue, đăng nhập bằng tài khoản quản trị viên đầu tiên và dùng thử theo tiêu chí nghiệm thu.
  4. Nếu đúng như mong đợi, bấm Merge. Hộp xác nhận cho biết cách merge (ví dụ squash vào main), tiêu đề commit, và việc issue sẽ chuyển sang Done. Xác nhận. Khi không có kết quả kiểm tra, nút hiển thị Merge anyway, và bạn có thể ghi lý do. Studio ghi lại lần merge trên PR và trong hoạt động của issue.
  5. Nếu có gì chưa ổn, bấm Send back for changes và nói cần sửa gì. Agent điều phối sắp xếp sửa và bàn giao lại cho bạn.
PUR-23· Supplier ManagementIn reviewFollowAsk agent

Chấm điểm và xếp hạng nhà cung cấp

Up next
Zhou Hang xem báo cáo bàn giao và nghiệm thu PR #31.
Needs you

Zhou Hang: hãy xem báo cáo bàn giao và nghiệm thu phần xếp hạng nhà cung cấp. Nếu đạt, merge PR #31; nếu không, trả lại.

Kiểm tra đã qua · Review: approved

MergeMark as mergedView changesSend back
Delivery report
Trước đây thế nào

Nhà cung cấp chỉ có hồ sơ cơ bản, không có điểm hay hạng. Đơn hàng chỉ cần trưởng phòng mua hàng duyệt khi trên ¥50.000.

Đã thay đổi gì
  • Nhà cung cấp giờ có điểm và hạng A, B hoặc C, được tính lại mỗi đêm theo tỷ lệ giao hàng đúng hạn, tỷ lệ đạt chất lượng và giá
  • Mọi đơn hàng gửi nhà cung cấp hạng C giờ được chuyển cho trưởng phòng mua hàng duyệt khi gửi, bất kể số tiền. Các nhà cung cấp khác giữ quy tắc theo số tiền
  • Nhà cung cấp mới bắt đầu ở hạng B và được xếp hạng lại sau ba tháng
Đã kiểm tra thế nào

Đã chạy qua cả ba kịch bản nghiệm thu trên preview. Mọi test và CI đều qua, và một model của nhà cung cấp khác đã duyệt review.

Vấn đề còn mở
  • Nhà cung cấp hiện có chỉ có hạng sau lần tính lại ban đêm đầu tiên. Đề nghị chạy tay một lần vào ngày phát hành.
Tiêu chí nghiệm thu
  • Danh sách nhà cung cấp hiển thị hạng của từng nhà cung cấp (ảnh 1)
  • Đơn hàng ¥10.000 gửi nhà cung cấp hạng C được chuyển cho trưởng phòng mua hàng duyệt khi gửi (ảnh 2 và 3)
Khi nghiệm thu, bạn đọc báo cáo bàn giao, tiêu chí nghiệm thu và ảnh chụp màn hình

Xong khi: issue ở trạng thái Done và thay đổi đã có trên nhánh mặc định của repository. Nếu CI đã kết nối, thay đổi được triển khai lên staging, và issue cho biết nó đã đến những môi trường nào.

Xử lý sự cố

Issue mãi không bắt đầu. Xem dòng Now trên trang issue. Nó cho biết đang chờ gì: không có runtime trực tuyến, mọi slot đều bận, hoặc Agent chỉ có trên runtime cá nhân của người khác. Nếu không runtime nào nhận việc trong 24 giờ, lượt chạy thất bại, và bạn được thông báo để chạy lại.

"Initialize project" chưa xong. Các issue mới trong dự án chờ cho đến khi nó xong.

Agent báo không chụp được màn hình. Runtime không có trình duyệt. Xem phần chuẩn bị trong Kết nối runtime dùng chung.

Khi mọi thứ đã chạy, hãy mời thành viên.

Tài liệu NocoBase 3 tiếng Việt, do OXMODE biên dịch · Bản nháp 2026-10-24

Gõ từ khóa, ví dụ: triển khai, phân quyền, Agent.