Chuyển đến nội dung chính
Nothing breaks in production. Review là Frontier Investigation Agent cho thay đổi mã nguồn: một AI reviewer cho pull request (PR) và merge request (MR) của bạn. Khi có người mở PR hoặc MR, CloudThinker đọc thay đổi, đăng bình luận tóm tắt cùng các phát hiện ngay trên dòng mã, và kiểm tra bản sửa khi bạn push lại. Linter chỉ khớp mẫu. Review đọc xem thay đổi đang muốn làm gì: diff, ticket được liên kết, các file quy ước của đội bạn và, nếu có, file BUSINESS.md mô tả những quy tắc sản phẩm phải giữ. Nhờ vậy Review đánh dấu được một quy tắc nghiệp vụ bị phá hay một migration rủi ro, chứ không chỉ lỗi trình bày.

Cách hoạt động

Khi một PR hoặc MR được mở, Git provider gửi sự kiện tới CloudThinker; CloudThinker thu thập diff, ticket được liên kết và các file trong repository, chạy review, rồi đăng bình luận tóm tắt và bình luận trên dòng mã lên PR; mỗi lần push mới sẽ có review bổ sung.Khi một PR hoặc MR được mở, Git provider gửi sự kiện tới CloudThinker; CloudThinker thu thập diff, ticket được liên kết và các file trong repository, chạy review, rồi đăng bình luận tóm tắt và bình luận trên dòng mã lên PR; mỗi lần push mới sẽ có review bổ sung.

Mỗi PR hoặc MR đều nhận một bản review đăng ngay trên đó, và mỗi lần push mới sẽ có review bổ sung.

  1. PR hoặc MR được mở. Bạn kết nối Git provider và chọn repository một lần, sau đó provider gửi sự kiện tới CloudThinker mỗi khi có PR hoặc MR mới, không cần ai khởi động review. PR và MR ở trạng thái draft được bỏ qua cho tới khi được đánh dấu sẵn sàng review.
  2. CloudThinker thu thập ngữ cảnh. CloudThinker checkout thay đổi và đọc diff, ticket được liên kết từ phần mô tả (Jira, Linear, Backlog hoặc issue của provider, sau khi bạn thêm extension), và các file liệt kê trong Review đọc những gì.
  3. Review chạy. Độ sâu tùy theo chế độ review của workspace: Fast, Auto hoặc Advanced. Mỗi lần review tiêu tốn credit; xem mức sử dụng và credit.
  4. Phát hiện xuất hiện trên PR. Bạn nhận một bình luận tóm tắt cùng các bình luận trên dòng mã. Mỗi phát hiện có mức độ nghiêm trọng (Critical, High, Medium hoặc Low) và một bản sửa đề xuất.
  5. Lần push mới được review tăng dần. Review chỉ đọc các commit được push sau lần review trước, và kiểm tra xem các phát hiện cũ đã được sửa chưa.
Phát hiện nghiêm trọng nhất chưa được xử lý quyết định verdict của lần review; lượt chạy chưa hoàn tất hoặc bị bỏ qua thì có trạng thái riêng. Verdict là nhãn CloudThinker gắn cho thay đổi, còn quy tắc nhánh của provider vẫn quyết định thay đổi có được merge hay không. Xem verdict để biết đủ bảy loại và mỗi loại yêu cầu bạn làm gì.
CloudThinker giữ một bản sao riêng của từng repository đã chọn để đọc, và xóa các bản sao đó khi bạn nhấn Remove setup. Secret trong output của công cụ được thay bằng placeholder trước khi model nhìn thấy; xem bảo vệ dữ liệu.
File test đã thay đổi, fixture và dữ liệu test, snapshot, mã sinh tự động, Storybook story, prototype, HTML trong docs/ và Jsonnet trong vendor không được review: không phát hiện nào được đặt vào các file này.
Việc khớp chỉ dựa trên đường dẫn file, so với danh sách tích hợp sẵn này và bạn không thể bổ sung. Với những đường dẫn bị bắt ngoài ý muốn, xem phát hiện sai hoặc nhiễu.

Review đọc những gì

Ngoài diff, Review đọc các file sau từ repository của bạn. Tất cả đều không bắt buộc. Bạn tự viết BUSINESS.md, và file phải theo một định dạng cố định: xem mô tả quy tắc nghiệp vụ. File không phân tích được, hoặc lớn hơn 200 KB, sẽ bị bỏ qua trong lần review đó, còn phần còn lại của review vẫn chạy.

Review kiểm tra những gì

Mỗi phát hiện thuộc một loại.

Bạn có thể làm gì

Provider được hỗ trợ

GitHub, GitLab (GitLab.com hoặc tự host), Bitbucket Cloud, Azure DevOps và AWS CodeCommit. Xem xác thực provider để biết mỗi provider cần gì. Kiểm tra các giới hạn sau trước khi lên kế hoạch triển khai:
  • Mỗi workspace một provider và một project Azure DevOps. Provider thứ hai, hoặc repository trong project Azure DevOps thứ hai, cần workspace riêng.
  • GitLab tự host là instance URL duy nhất bạn nhập được. GitHub Enterprise Server và Bitbucket Data Center không có trong lựa chọn, và một kết nối CodeCommit chỉ bao một AWS account và một region.
Review tự động chạy trên cả năm provider. Các thao tác bổ sung thì không: Có hai đoạn text trông giống nhau nhưng đặt ở hai nơi khác nhau: @cloudthinker-ai trong bình luận dùng để hỏi, yêu cầu review lại hoặc sửa lỗi, còn @cloudthinker:ignore trong phần mô tả bỏ qua review cho riêng thay đổi đó. Xem mention commands.

Bắt đầu

Thiết lập Review

Kết nối provider, chọn repository và nhận lần review đầu tiên.

Xác thực provider

Token, scope và webhook cho từng Git provider.