Chuyển đến nội dung chính
Kết nối Azure DevOps để các agent CloudThinker có thể đọc repository, pull request và build trong một project, và Review có thể đăng AI code review trên pull request. Bạn xác thực bằng personal access token (PAT): một token bạn tạo trong Azure DevOps, hoạt động với quyền truy cập của tài khoản bạn và giới hạn trong các scope bạn chọn.

​
Điều kiện tiên quyết

  • Tài khoản Azure DevOps có quyền truy cập organization và project mà bạn muốn agent đọc.
  • URL organization của bạn, ví dụ https://dev.azure.com/acme, và tên project chứa các repository của bạn.
  • Với Review: quyền tạo service hook trong project (Project Settings → Service hooks).
  • Quyền tạo PAT. Kết nối chỉ chấp nhận PAT, nên nếu chính sách của organization hạn chế việc tạo PAT, hãy nhờ admin Azure DevOps cho phép tạo một PAT cho tài khoản bạn dùng.
  • Vai trò Admin trong workspace CloudThinker, cần để thêm và sửa kết nối. Xem Vai trò.

​
Thiết lập

1

Tạo PAT trong Azure DevOps

Vào dev.azure.com/<org>, nhấn biểu tượng User settings (góc trên bên phải, cạnh avatar), và chọn Personal access tokens. Nhấn New Token, chọn organization và đặt ngày hết hạn. Azure DevOps mặc định là 30 ngày và cho phép tối đa một năm, nên hãy chọn ngày phù hợp với chính sách xoay vòng của bạn. Chọn scope Custom defined:
  • Build: Read
  • Code: Read & Write
  • Pull Request Threads: Read & Write
Nhấn Create và sao chép token ngay. Azure DevOps chỉ hiển thị token một lần.
2

Mở kết nối trong CloudThinker

Trong thanh bên, nhấn More → Workspace settings → Connections. Trên tab Builtin Connections, tìm Azure DevOps và nhấn Connect.
3

Nhập chi tiết kết nối

Điền Organization URL, Project và Personal Access Token theo Chi tiết kết nối.
4

Kiểm tra và kết nối

Nhấn Validate PAT. CloudThinker hiển thị Token works cùng số repository trong project mà token có thể truy cập. Sau đó nhấn Connect.Trạng thái thành công: CloudThinker hiển thị Connected to Azure DevOps và Azure DevOps hiển thị Connected trên tab Builtin Connections.

​
Thêm service hook cho Review

Azure DevOps không tự gửi sự kiện pull request đến CloudThinker. Câu hỏi cho agent vẫn hoạt động mà không cần service hook, nhưng Review cần chúng. Trình hướng dẫn thiết lập Review hiển thị URL và Secret token của webhook. Cấu hình webhook có đường dẫn thao tác đầy đủ. Tạo một subscription cho mỗi sự kiện trong Project Settings → Service hooks → + Create subscription → Web Hooks:

​
Chi tiết kết nối

Một kết nối bao phủ một project, và một workspace chứa một kết nối Azure DevOps. Bước kiểm tra chỉ đếm các repository trong project đó.

​
Quyền yêu cầu

Cấp cho PAT đúng các scope sau: PAT không bao giờ có thể truy cập nhiều hơn tài khoản của chính bạn. Thao tác ghi của agent vẫn đi qua Rules và Approval mode của bạn trước khi có bất kỳ thay đổi nào.
Tạo PAT từ một service account chuyên dụng chỉ thuộc project mà CloudThinker cần thấy. Cấp cho tài khoản này access level Basic, vì quyền Stakeholder không dùng được Repos. Khi đó bình luận Review đến từ tài khoản này, và không có token của đồng nghiệp nào bị vô hiệu khi họ rời đi.

​
Kiểm soát quyền truy cập trong CloudThinker

Hai cài đặt trên bảng chi tiết của kết nối giúp thu hẹp những gì agent làm. Mở More → Workspace settings → Connections, chọn Azure DevOps, và xem trong Settings. Các cài đặt này chỉ thu hẹp những gì PAT đã cấp. Chọn repository cho Review là một bước riêng trong Thiết lập Review.

​
Khả năng của agent

Thao tác đọc chạy mà không cần hỏi. Thao tác ghi cần bật Allow writes và đi qua Rules cùng Approval mode của bạn trước.

​
Xác minh kết nối

Kết nối hoạt động tốt sẽ nêu tên các repository thực trong project của bạn. Nếu danh sách trống, hãy kiểm tra tên Project.

​
Ví dụ prompt

​
Khắc phục sự cố

PAT đã hết hạn hoặc bị thu hồi, thiếu một trong ba scope, hoặc thuộc organization khác với Organization URL. Tạo PAT mới trong đúng organization với Build (Read), Code (Read & Write) và Pull Request Threads (Read & Write), rồi kiểm tra lại.
Tên Project không khớp với project mà tài khoản của PAT có thể thấy, hoặc project không có repository nào. Sao chép tên từ danh sách project trong Azure DevOps và kiểm tra lại.
PAT đã đến ngày hết hạn (30 ngày nếu bạn không chọn ngày khác). Tạo PAT mới với cùng scope. Sau đó mở Review → Settings, mở menu Connection actions (⋯) trong mục Connection, và nhấn Update token.
Thiếu một hoặc nhiều service hook. Azure DevOps cần một subscription riêng cho mỗi sự kiện. Kiểm tra Project Settings → Service hooks đối chiếu với Cấu hình webhook.

​
Bảo mật

  • Quyền tối thiểu — chỉ cấp các quyền mà agent cần cho trường hợp sử dụng của bạn; bắt đầu với quyền chỉ đọc và mở rộng sau.
  • Chỉ đọc theo mặc định — sử dụng thông tin xác thực chỉ đọc trừ khi bạn muốn agent thực hiện thay đổi qua kết nối này.
  • Xoay vòng thông tin xác thực — xoay vòng khóa và token theo lịch trình thông thường của bạn; CloudThinker sẽ lấy giá trị mới khi bạn cập nhật kết nối.
  • Thu hồi khi bàn giao — xóa thông tin xác thực tại nhà cung cấp khi bạn xóa một kết nối hoặc khi đồng nghiệp rời nhóm.
  • Chỉ dùng ba scope. Agent và Review không cần gì ngoài Build (Read), Code (Read & Write) và Pull Request Threads (Read & Write). Tránh dùng token Full access.
  • Xoay vòng trước khi hết hạn. Thay PAT trước ngày hết hạn để review không dừng giữa sprint.

​
Liên quan

Thiết lập Review

Chọn repository và bắt đầu AI code review trên pull request

Xác thực provider

Thêm service hook của Azure DevOps và so sánh với các Git provider khác