Thiết lập Code Review

Kết nối một Git provider một lần và mọi pull request mới trong các kho được chọn sẽ tự động nhận AI review. Mới với Code Review? Hãy đọc tổng quan trước.

Yêu cầu

Tài khoản GitHub, GitLab, Bitbucket hoặc Azure DevOps với quyền truy cập kho
Quyền cài đặt ứng dụng hoặc tạo access token cho tổ chức của bạn
Một workspace CloudThinker

Kết nối kho

Mở Code Review

Vào Code Review từ menu điều hướng.

Bắt đầu thiết lập

Nhấp Get Started with Code Review để mở trình hướng dẫn thiết lập.

Chọn provider

Chọn GitHub, GitLab, Bitbucket hoặc Azure DevOps làm Git provider của bạn.

Xác thực

Nhấp Install GitHub App để bắt đầu cài đặt GitHub App.GitHub chuyển hướng bạn để chọn tổ chức và cấp quyền truy cập kho. Sau khi bạn ủy quyền, trình hướng dẫn tự động tiếp tục. Webhook được đăng ký bởi GitHub App — không cần cấu hình webhook thủ công.

Cài đặt CloudThinker cho tổ chức GitHub yêu cầu quyền Organization Owner. Nếu bạn không phải owner, hãy nhờ owner cài đặt app.

Sử dụng Project Access Token hoặc Group Access Token cho các instance GitLab tự host hoặc nếu bạn muốn quản lý token thủ công. Bình luận khi đó xuất hiện từ tài khoản bot, token được giới hạn phạm vi cho các dự án hoặc nhóm cụ thể, và quyền truy cập dễ dàng thu hồi. CloudThinker hỗ trợ GitLab tự host phiên bản 12.0 trở lên.Chi tiết kết nối:

GitLab URL: Nhập https://gitlab.com cho GitLab.com, hoặc URL instance tự host của bạn (ví dụ: https://gitlab.example.com)
Token Type: Chọn Project Access Token (một dự án) hoặc Group Access Token (tất cả dự án trong một nhóm)
Access Token: Dán token đã tạo

Cách tạo Project Access Token

Vào dự án → Settings → Access Tokens
Nhấp Add new token
Đặt vai trò là Developer hoặc cao hơn
Chọn phạm vi: api
Đặt ngày hết hạn (khuyến nghị)
Sao chép token đã tạo

Cách tạo Group Access Token

Vào nhóm → Settings → Access Tokens
Nhấp Add new token
Đặt vai trò là Developer hoặc cao hơn
Chọn phạm vi: api
Đặt ngày hết hạn (khuyến nghị)
Sao chép token đã tạo

Token phải có vai trò Developer hoặc cao hơn để đăng bình luận code review. Vai trò Guest và Reporter không thể bình luận trên merge request.

Sau khi kết nối, cấu hình webhook thủ công.

Kết nối bằng Bitbucket access token. Chọn loại token phù hợp với cấp độ truy cập của bạn:

Loại Token	Phạm vi	Gói yêu cầu
Workspace Access Token	Tất cả kho trong một workspace	Premium
Project Access Token	Tất cả kho trong một dự án	Premium
Repository Access Token	Chỉ một kho duy nhất	Free

Chi tiết kết nối:

Token Type: Chọn phạm vi token từ dropdown
Bitbucket Workspace: Nhập workspace slug của bạn (từ URL: bitbucket.org/<workspace>/repo)
Repository Slug (chỉ cho Repository token): Nhập repository slug
Access Token: Dán token đã tạo

Nhấp Validate Token trước để xác minh quyền truy cập, sau đó nhấp Connect để hoàn tất.Quyền token cần thiết:

Account: Read
Repositories: Read, Write
Pull requests: Read, Write
Webhooks: Read and write
Pipelines: Read, Write

Cách tạo Workspace Access Token

Vào Workspace → Settings → Access tokens
Nhấp Create workspace access token
Bật các quyền cần thiết được liệt kê ở trên
Đặt ngày hết hạn (khuyến nghị)
Sao chép token đã tạo

Cách tạo Project Access Token

Vào Project → Project settings → Access tokens
Nhấp Create project access token
Bật các quyền cần thiết được liệt kê ở trên
Đặt ngày hết hạn (khuyến nghị)
Sao chép token đã tạo

Cách tạo Repository Access Token

Vào Repository → Repository settings → Access tokens
Nhấp Create Repository Access Token
Bật các quyền cần thiết được liệt kê ở trên
Đặt ngày hết hạn (khuyến nghị)
Sao chép token đã tạo

Webhook được đăng ký tự động — không cần cấu hình webhook thủ công.

Azure DevOps sử dụng Personal Access Token (PAT) để xác thực.Chi tiết kết nối:

Organization URL: Nhập URL tổ chức Azure DevOps của bạn (ví dụ: https://dev.azure.com/your-org hoặc https://your-org.visualstudio.com)
Project: Nhập tên dự án chứa các kho của bạn
Personal Access Token: Dán PAT đã tạo

Nhấp Validate PAT trước để xác minh quyền truy cập, sau đó nhấp Connect để hoàn tất.Phạm vi PAT cần thiết:

Build — Read
Code — Read & Write
Pull Request Threads — Read & Write

Cách tạo PAT

Vào Azure DevOps → User Settings (góc trên bên phải) → Personal Access Tokens
Nhấp New Token
Đặt tổ chức và ngày hết hạn
Chọn các phạm vi được liệt kê ở trên
Nhấp Create và sao chép token đã tạo

PAT hết hạn vào ngày bạn đặt khi tạo. Xoay vòng PAT trước khi hết hạn để tránh gián đoạn review.Sau khi kết nối, cấu hình webhook thủ công.

Chọn kho

Chọn các kho bạn muốn bật cho code review và nhấp Complete để hoàn tất thiết lập.

Sau khi thiết lập, mở cài đặt kho để điều chỉnh auto-review, chế độ review, giám sát pipeline và bộ lọc theo từng kho.Trạng thái thành công: Các kho của bạn xuất hiện trong dashboard Code Review — CloudThinker hiện đang giám sát pull request và merge request của chúng.

Cấu hình webhook

GitHub và Bitbucket đăng ký webhook tự động — không cần thao tác gì. GitLab và Azure DevOps yêu cầu cấu hình webhook thủ công:

GitLab
Azure DevOps

Sau khi kết nối tài khoản GitLab, cấu hình webhook trong dự án hoặc nhóm GitLab của bạn:

Vào dự án/nhóm → Settings → Webhooks
Dán URL webhook được hiển thị trong trình hướng dẫn thiết lập
Nhập secret token được cung cấp
Bật các trigger sau:
- Merge request events
- Comments
- Pipeline events
Nhấp Add webhook

Tạo pull request

Mở kho của bạn

Điều hướng đến kho được kết nối trên GitHub, GitLab, Bitbucket hoặc Azure DevOps.

Tạo pull request

Tạo pull request mới với các thay đổi code của bạn. CloudThinker phát hiện PR, phân tích diff và đăng bình luận tóm tắt cộng với bình luận nội tuyến — thường trong vòng 1–2 phút, không cần kích hoạt thủ công.

Các phát hiện bao gồm phát hiện lỗi (lỗi logic, tham chiếu null, race condition), lỗ hổng bảo mật (rủi ro injection, secret được mã hóa cứng), chất lượng code (đặt tên, độ phức tạp, trùng lặp) và hiệu suất (truy vấn kém hiệu quả, mẫu N+1).

Xem xét phát hiện

Kiểm tra trạng thái trong CloudThinker

Xem trạng thái review cho tất cả pull request của bạn trong dashboard CloudThinker.

Xem phát hiện trên Git provider

Mở pull request để xem bản tóm tắt do AI tạo và bình luận code nội tuyến. Mỗi bình luận bao gồm mức độ nghiêm trọng (Critical, High, Medium, Low), giải thích vấn đề và đề xuất bản vá.

Trả lời @cloudthinker-ai trên PR để đặt câu hỏi, yêu cầu review lại hoặc bỏ qua review — xem mention commands.

Chế độ review

Cấu hình chế độ review theo từng kho và chuyển đổi bất cứ lúc nào trong cài đặt kho:

Chế độ	Mô tả
Fast	Phân tích nhanh, chi phí thấp hơn. Lý tưởng cho PR nhỏ và phản hồi nhanh.
Advanced	Phân tích sâu được chia cho các agent chuyên biệt về bảo mật, hiệu suất, tính đúng đắn và mẫu. Tốt nhất cho các kho quan trọng.

Giám sát pipeline

CloudThinker giám sát pipeline CI/CD của bạn để phát hiện lỗi. Khi pipeline thất bại, CloudThinker:

Phát hiện lần chạy pipeline thất bại
Lấy và phân tích nhật ký job thất bại
Đăng phát hiện và đề xuất bản vá trực tiếp trên PR

Giám sát pipeline có thể bật/tắt theo workspace và được bật theo mặc định. Với Azure DevOps, CloudThinker giám sát sự kiện build.complete cùng với sự kiện pull request (git.pullrequest.created, git.pullrequest.updated).

Cấu hình bộ lọc

Kiểm soát những PR và MR nào CloudThinker review bằng bộ lọc theo từng kho:

Bộ lọc nhãn: Bao gồm hoặc loại trừ PR có nhãn cụ thể
Bộ lọc tác giả: Bao gồm hoặc loại trừ tác giả cụ thể (hữu ích để loại trừ tác giả bot)
Bộ lọc nhánh: Bao gồm hoặc loại trừ nhánh khớp với mẫu cụ thể (lọc theo nhánh đích — nhánh đang được merge vào)

Bộ lọc Loại trừ được kiểm tra trước. Tất cả bộ lọc Bao gồm phải vượt qua. PR khớp với bộ lọc loại trừ được đánh dấu là FILTERED và bỏ qua hoàn toàn.

Review tăng dần

Khi bạn đẩy commit mới vào PR đang mở, CloudThinker thực hiện review tăng dần — chỉ các thay đổi mới được phân tích, không phải toàn bộ PR. Điều này giữ cho review nhanh và tập trung vào những gì thực sự thay đổi.

Bước tiếp theo

Mention commands

Tương tác với bot review từ bình luận PR — review lại, đặt câu hỏi hoặc bỏ qua review

Leaderboard

Theo dõi hoạt động review của nhóm và đo lường cải thiện chất lượng code theo thời gian

Convention rules

Dạy review quy ước lập trình của nhóm bạn bằng các file đã có trong kho

Thông báo

Cấu hình nơi nhận phát hiện code review

​Yêu cầu

​Kết nối kho

​Cấu hình webhook

​Tạo pull request

​Xem xét phát hiện

​Chế độ review

​Giám sát pipeline

​Cấu hình bộ lọc

​Review tăng dần

​Bước tiếp theo

Mention commands

Leaderboard

Convention rules

Thông báo

Yêu cầu

Kết nối kho

Cấu hình webhook

Tạo pull request

Xem xét phát hiện

Chế độ review

Giám sát pipeline

Cấu hình bộ lọc

Review tăng dần

Bước tiếp theo