Chuyển đến nội dung chính
Kết nối CircleCI để các agent CloudThinker đọc trạng thái pipeline, lấy log build và test để tìm lý do một lượt chạy thất bại, phát hiện test flaky và kiểm tra file .circleci/config.yml của bạn. Kết nối dùng personal API token của CircleCI, nên agent truy cập đúng những project mà người dùng của token nhìn thấy.

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

  • Một tài khoản CircleCI nhìn thấy organization và các project bạn muốn agent điều tra.
  • Ít nhất một project mà tài khoản đó follow. Agent tìm project từ danh sách đã follow. Để follow, đăng nhập CircleCI bằng người dùng của token, mở Projects và nhấn Follow Project bên cạnh từng repository.
  • Với test flaky và kết quả test của job: các job phải tải kết quả JUnit lên bằng store_test_results. Nếu không, CircleCI không có dữ liệu test để trả về.
  • Để agent khởi chạy hoặc chạy lại pipeline: cùng tài khoản đó cần quyền trigger pipeline trên các project này.
  • Với CircleCI Server tự lưu trữ: CloudThinker phải truy cập được server qua HTTPS. Xem Truy cập dịch vụ riêng tư.

Thiết lập

1

Tạo personal API token

Trong CircleCI, mở User Settings → Personal API Tokens (app.circleci.com/settings/user/tokens) và nhấn Create New Token. Đặt tên là cloudthinker.Sao chép token ngay. CircleCI chỉ hiển thị token một lần.
2

Thêm kết nối

Mở More → Workspace settings → Connections, giữ nguyên tab Builtin Connections và chọn CircleCI. Điền:
  • CIRCLECI_TOKEN: token bạn vừa tạo.
  • CIRCLECI_BASE_URL: giữ https://circleci.com với CircleCI cloud. Chỉ đổi khi bạn dùng bản cài đặt CircleCI Server tự lưu trữ.
Nhấn Connect.Trạng thái thành công: hộp thoại đóng lại và kết nối hiển thị Connected.
3

Xác nhận token hoạt động

Chạy prompt trong phần Xác minh kết nối. CloudThinker không kiểm tra token với CircleCI khi bạn kết nối, nên trạng thái Connected chưa chứng minh token hợp lệ.

Chi tiết kết nối

Bạn không cần nhập ID organization hay project. Agent tự xác định chúng từ các project mà người dùng của token đã follow.

Quyền yêu cầu

Personal API token có cùng quyền truy cập với người dùng CircleCI đã tạo ra nó. Quyền truy cập project của người dùng đó là giới hạn trên cho những gì agent đọc hoặc thay đổi được. Evaluation test là bài test prompt template của CircleCI: agent chạy chúng dưới dạng một pipeline trên CircleCI.
Hãy tạo token dưới một người dùng CircleCI riêng, chỉ thuộc các project bạn muốn điều tra. Người dùng này cần là thành viên của organization GitHub hoặc Bitbucket, nên cách thường dùng là một machine user của VCS. Kiểm tra xem người dùng này có bị tính vào gói CircleCI của bạn không. Thao tác ghi vẫn đi qua Approvals: token đặt giới hạn trên, còn Approvals quyết định từng thao tác.

Khả năng của agent

Trước mọi thao tác ghi, agent cho bạn biết điều sẽ xảy ra (ví dụ: “khởi chạy pipeline trên gh/acme/api branch main”) và hiển thị chính xác đầu vào. Với rollback, agent còn liệt kê phiên bản hiện tại, phiên bản đích và yêu cầu bạn xác nhận phiên bản đích. Mọi thay đổi do agent thực hiện đều đi qua Approvals của workspace trước. Ở chế độ mặc định Auto · Rules + AI · Ask me, AI judgment có thể cho một thay đổi an toàn chạy mà không cần hỏi. Allow Rule cũng vậy, sau khi CloudThinker bật Rule enforcement cho workspace của bạn. Chọn Manual nếu bạn muốn tự phê duyệt mọi thay đổi. Để được hỏi mỗi lần, chọn Manual làm Approval mode để một người phê duyệt mọi thay đổi. Khi CloudThinker bật Rule enforcement cho workspace của bạn, một Rule Ask first có thể áp dụng riêng cho kết nối này.

Xác minh kết nối

Kết quả gồm từng project đã follow theo slug (ví dụ gh/acme/api) kèm trạng thái pipeline mới nhất. Nếu thiếu một project bạn mong đợi, người dùng của token chưa follow project đó.

Ví dụ prompt

Khắc phục sự cố

Token bị thiếu, đã hết hạn hoặc đã bị thu hồi. Tạo personal API token mới và cập nhật trường CIRCLECI_TOKEN trên kết nối.
Người dùng của token đọc được project nhưng không trigger được pipeline. Tạo token dưới người dùng có quyền trigger trên project đó, rồi cập nhật kết nối.
Người dùng của token chưa follow project nào. Follow ít nhất một project trong CircleCI, rồi hỏi lại.
Các job không tải kết quả test lên. Thêm bước store_test_results trỏ đến đầu ra JUnit XML, đợi vài pipeline chạy xong, rồi hỏi lại.
Slug project cần tiền tố VCS: gh/<org>/<repo> với GitHub hoặc bb/<org>/<repo> với Bitbucket. Yêu cầu agent liệt kê các project đã follow và dùng slug trong danh sách đó.
Dữ liệu sử dụng cần UUID của organization, và không API nào của CircleCI trả về giá trị này. Sao chép UUID từ Organization Settings → Overview → Organization ID trong CircleCI và dán vào chat. Usage API chỉ có ở gói trả phí và mỗi yêu cầu bao phủ tối đa 32 ngày.
CIRCLECI_BASE_URL vẫn là https://circleci.com, hoặc có kèm path. Chỉ đặt host của CircleCI Server, ví dụ https://circleci.example.com.

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.
  • Dùng người dùng riêng: personal token của CircleCI không có scope riêng, nên quyền thành viên project của người dùng token là cách duy nhất để giới hạn phạm vi truy cập.
  • Giữ các thao tác điều khiển sau phê duyệt: mỗi lượt chạy pipeline tốn chi phí compute và có thể deploy. Hãy để các thao tác này đi qua Approval mode thay vì tự động phê duyệt.

Liên quan

Buildkite

Sức khỏe pipeline, phân loại build lỗi và chạy lại sau phê duyệt.

Approvals

Cách CloudThinker quyết định thao tác nào cần một người phê duyệt.