Bitbucket

Kết nối Bitbucket để các agent CloudThinker đọc repository, pull request và pipeline của bạn, và Review có thể đăng review mã bằng AI trên pull request. Bạn đăng nhập bằng OAuth, hoặc dán một access token cấp workspace, project hoặc repository. Cả hai cách đều cần workspace slug của bạn.

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

Một tài khoản Bitbucket Cloud có quyền truy cập workspace mà bạn muốn agent đọc. Kết nối làm việc với bitbucket.org và không có trường cho URL Bitbucket Data Center hoặc Server.
Workspace slug của bạn: phần sau bitbucket.org/ trong URL repository. Trong bitbucket.org/acme/payments-api, slug là acme.
Với cách dùng token: quyền admin trên workspace, project hoặc repository nơi bạn tạo token.
Với Review qua OAuth: quyền admin trên các repository mà Review chạy, vì Bitbucket chỉ cho admin repository thêm webhook.
Vai trò Admin trong workspace CloudThinker, vai trò có thể thêm và sửa kết nối. Xem Vai trò.

Chọn phương thức

Phương thức	Dùng khi	Gói Bitbucket
OAuth	Bạn muốn thiết lập nhanh nhất và quyền truy cập khớp với tài khoản của chính bạn	Bất kỳ
Workspace Access Token	Một thông tin xác thực duy nhất cần bao phủ mọi repository trong workspace	Premium
Project Access Token	Quyền truy cập chỉ nằm trong một project Bitbucket	Premium
Repository Access Token	Quyền truy cập bao phủ đúng một repository	Bất kỳ, kể cả Free

Mỗi workspace chỉ có một kết nối Bitbucket. Để thử CloudThinker trên nhiều repository, hãy dùng token cấp project hoặc workspace, hoặc OAuth, thay vì nhiều token repository.

Thiết lập

Mở kết nối trước. Trong thanh bên, nhấn More → Workspace settings → Connections. Ở tab Builtin Connections, tìm Bitbucket và nhấn Connect. Hộp thoại mở với hai tab: OAuth và Access Token.

OAuth
Access Token

Nhập workspace slug

Ở tab OAuth, nhập slug vào Bitbucket workspace (ví dụ acme). Connect to Bitbucket bị vô hiệu cho đến khi trường này có giá trị.

Cấp quyền cho CloudThinker

Nhấn Connect to Bitbucket. Đăng nhập bằng một người dùng Bitbucket thấy được workspace, rồi chấp thuận yêu cầu. CloudThinker yêu cầu quyền đọc và ghi repository, quyền API cho webhook và pull request, và thông tin tài khoản của bạn (username, email).Trạng thái thành công: bạn quay lại CloudThinker với Bitbucket Connected! và Bitbucket hiển thị Connected ở tab Builtin Connections.

Tạo token trong Bitbucket

Chọn loại token từ Chọn phương thức, rồi mở màn hình tương ứng:

Loại token	Nơi tạo	Nút
Workspace	Workspace → Settings → Access tokens	Create workspace access token
Project	Project → Project settings → Access tokens	Create project access token
Repository	Repository → Repository settings → Access tokens	Create Repository Access Token

Cấp các quyền trong Quyền yêu cầu, đặt ngày hết hạn và sao chép token.

Nhập thông tin kết nối

Ở tab Access Token, chọn Token Type và điền các trường trong Chi tiết kết nối.

Xác thực và kết nối

Nhấn Validate Token. CloudThinker hiển thị Token works cùng số repository mà token thấy được. Sau đó nhấn Connect.Trạng thái thành công: CloudThinker hiển thị Connected to Bitbucket và Bitbucket hiển thị Connected ở tab Builtin Connections.

CloudThinker tự đăng ký webhook Bitbucket cho Review. Bạn không cần thêm thủ công. Chọn các repository mà Review chạy trong thiết lập Review.

Chi tiết kết nối

OAuth chỉ cần workspace slug. Bitbucket cấp thông tin xác thực và CloudThinker lưu trữ chúng.

Trường	Mô tả	Ví dụ
Token Type	Workspace Access Token, Project Access Token hoặc Repository Access Token	Workspace Access Token
Bitbucket Workspace	Workspace slug của bạn	`acme`
Repository slug	Chỉ với token repository: repository mà token bao phủ	`payments-api`
Access Token	Token bạn đã tạo trong Bitbucket	`<your-token>`

Quyền yêu cầu

Phương thức	Yếu tố quyết định quyền truy cập
OAuth	Mọi thứ người dùng Bitbucket đã đăng nhập thấy được trong workspace
Access token	Các quyền bên dưới, giới hạn trong workspace, project hoặc repository của token

Mọi loại token cần cùng các scope, và cả ba loại đều cung cấp chúng:

Scope	Quyền	Lý do
Repositories	Write (bao gồm Read)	Đọc mã, push nhánh và commit sửa lỗi qua phê duyệt
Pull requests	Write (bao gồm Read)	Đọc pull request và đăng bình luận Review
Webhooks	Read and write	Tự động đăng ký webhook Review
Pipelines	Write (bao gồm Read)	Phân tích pipeline

Access token không có scope cho issue, nên agent không thể đọc issue tracker của Bitbucket qua token. Kết nối bằng OAuth nếu bạn cần issue. Review cần quyền ghi để đăng ký webhook và đăng bình luận. Thao tác ghi của agent vẫn đi qua Rules và Approval mode trước khi có gì thay đổi.

Bắt đầu với token repository trên một repository để thử CloudThinker. Cách này dùng được trên mọi gói, và thu hồi token không ảnh hưởng gì khác. Chuyển sang token workspace hoặc project khi triển khai rộng hơn.

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 thu hẹp những gì agent làm. Mở More → Workspace settings → Connections, chọn Bitbucket và xem trong Settings.

Cài đặt	Tùy chọn	Tác dụng
Repository access	All hoặc Selected	All cho agent đọc mọi repository mà thông tin xác thực tiếp cận được, kể cả repository mới. Selected giới hạn agent trong các repository bạn chọn, và repository mới bị loại trừ cho đến khi bạn thêm. Chuyển sang All rồi quay lại sẽ khôi phục lựa chọn trước đó.
Allow writes	Bật (mặc định) hoặc tắt	Bật: agent có thể đề xuất thay đổi, và Rules cùng Approval mode quyết định từng thay đổi. Tắt: agent chỉ có thể đọc, và mọi thay đổi bị từ chối.

Các cài đặt này chỉ thu hẹp những gì Bitbucket đã cấp. Chọn repository mà Review chạy 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 hỏi. Thao tác ghi cần bật Allow writes và đi qua Rules cùng Approval mode trước.

Khả năng	Agent có thể làm gì
Repositories	Liệt kê các repository mà kết nối tiếp cận được và đọc mã cùng lịch sử
Pull requests	Tóm tắt các pull request đang mở, người review và thảo luận
Pipelines	Tìm pipeline thất bại và đọc log từng bước để giải thích lỗi
Issues	Đọc issue để có ngữ cảnh phân loại và tiến độ triển khai, khi repository dùng issue tracker của Bitbucket (chỉ OAuth)
Changes	Tạo nhánh, bình luận hoặc mở pull request, mỗi việc đều qua phê duyệt

Xác minh kết nối

List the Bitbucket repositories you can reach and how many open pull requests each one has

Kết nối hoạt động sẽ nêu tên các repository thực và số liệu. Nếu thiếu repository nào, hãy kiểm tra loại token và Repository access.

Ví dụ prompt

Which open pull requests in the acme workspace have had no review for more than 3 days?
Why did the latest pipeline on main fail in the payments-api repository?
Summarize the pull requests merged into main across our Bitbucket repositories this week

Khắc phục sự cố

Connect to Bitbucket vẫn bị vô hiệu

Luồng OAuth cần workspace slug trước. Nhập phần sau bitbucket.org/ từ bất kỳ URL repository nào, rồi nhấn Connect to Bitbucket.

Validate Token thất bại

Token đã hết hạn hoặc bị thu hồi, thiếu một trong các quyền yêu cầu, hoặc không khớp với gói của bạn. Token workspace và project cần Bitbucket Premium. Tạo token mới với mọi quyền trong Quyền yêu cầu và xác thực lại.

Confirm Bitbucket workspace

Cảnh báo này xuất hiện trên kết nối OAuth chưa lưu workspace slug. Bitbucket không còn cho CloudThinker tự phát hiện workspace, nên bạn nhập một lần. Cảnh báo hiển thị trên bảng chi tiết của kết nối và trong Review → Settings. Nhấn Set workspace, nhập slug và nhấn Save workspace.

Agent không tìm thấy một repository

Token repository chỉ tiếp cận một repository, và token project chỉ tiếp cận project đó. Dùng token workspace, hoặc đăng nhập OAuth bằng người dùng thấy được repository. Sau đó kiểm tra Repository access có bao gồm repository đó.

Agent đọc được nhưng mọi thay đổi bị từ chối

Allow writes đang tắt trên kết nối, hoặc một Rule chặn hành động. Bật Allow writes trong Settings, rồi kiểm tra Rules.

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.

Ưu tiên token có phạm vi hẹp. Token repository hoặc project giữ CloudThinker trong phạm vi mã cần thấy, và thu hồi token không ảnh hưởng gì khác.
Đặt ngày hết hạn. Xoay vòng token trước khi hết hạn, nếu không Review và agent sẽ mất quyền truy cập vào ngày đó. Để thay token mới, mở Review → Settings, mở menu Connection actions (⋯) trong mục Connection và nhấn Update token.

Kết nối

Customize

Approvals

Cài đặt workspace

Admin Settings

Triển khai

Artifacts và chia sẻ

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

Chọn phương thức

Thiết lập

Chi tiết kết nối

Quyền yêu cầu

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

Khả năng của agent

Xác minh kết nối

Ví dụ prompt

Khắc phục sự cố

Bảo mật

Liên quan

Thiết lập Review

Xác thực provider

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

​Chọn phương thức

​Thiết lập

​Chi tiết kết nối

​Quyền yêu cầu

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

​Khả năng của agent

​Xác minh kết nối

​Ví dụ prompt

​Khắc phục sự cố

​Bảo mật

​Liên quan

Thiết lập Review

Xác thực provider

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

Chọn phương thức

Thiết lập

Chi tiết kết nối

Quyền yêu cầu

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

Khả năng của agent

Xác minh kết nối

Ví dụ prompt

Khắc phục sự cố

Bảo mật

Liên quan