Skip to main content
Kết nối space Backlog của bạn để cho phép các agent CloudThinker theo dõi issue, lập kế hoạch milestone, đọc wiki và lấy ngữ cảnh ticket trong quá trình code review. Backlog xác thực bằng API key theo phạm vi space kế thừa quyền truy cập project của người dùng tạo ra nó.

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

  • Một space Backlog có quyền truy cập các project bạn muốn làm việc.
  • Một API key theo phạm vi space, được tạo từ tab Personal Settings → API của người dùng tạo.
  • Để thực hiện thao tác tạo/cập nhật: người dùng của key cần có quyền dự án tương ứng.
Theo dõi chỉ đọc hoạt động với bất kỳ key nào mà người dùng có thể xem các project mục tiêu. Tạo hoặc cập nhật issue, wiki và pull request ngoài ra còn yêu cầu người dùng đó có quyền ghi trên project. Nếu space của bạn hạn chế quyền truy cập API, quản trị viên space phải bật nó trước khi có thể tạo key.

Thiết lập

1

Tạo API key

Trong Backlog, mở menu hồ sơ và vào Personal Settings → API. Nhập ghi chú (ví dụ: cloudthinker) và nhấp Submit để tạo key, sau đó sao chép nó.
2

Thêm kết nối trong CloudThinker

Điều hướng đến Connections → Backlog và nhập:
  • Domain: domain Backlog đầy đủ của bạn, ví dụ: <myorg>.backlog.com — toàn bộ host, không chỉ space key
  • API Key: key bạn vừa tạo
Nhấp Connect. CloudThinker xác minh thông tin xác thực và hiển thị trạng thái Connected.
Sao chép API key khi bạn tạo và lưu trữ an toàn. Xử lý nó như mật khẩu — bất kỳ ai có key đều có quyền truy cập của người dùng tạo ra nó vào space.

Chi tiết kết nối


Quyền hạn cần thiết

API key kế thừa quyền truy cập của người dùng đã tạo ra nó. Các thao tác đọc hoạt động với bất kỳ key nào mà người dùng có thể xem các project mục tiêu. Các thao tác tạo, cập nhật và xóa ngoài ra còn yêu cầu người dùng có quyền ghi trên project phê duyệt rõ ràng trong CloudThinker.
Tuân thủ nguyên tắc đặc quyền tối thiểu: tạo key từ người dùng chỉ có quyền truy cập project mà CloudThinker cần, và giữ các thao tác ghi được kiểm soát phê duyệt thay vì bỏ biện pháp bảo vệ.

Khả năng của agent

Sau khi kết nối, các agent có quyền đọc các project, issue, wiki và repository Backlog của bạn, cộng thêm một tập hợp các thao tác ghi được kiểm soát phê duyệt.

Xác minh kết nối

Các lệnh mẫu

Với các space có nhiều project, hãy giới hạn yêu cầu vào một project hoặc milestone duy nhất để agent trả về kết quả tập trung hơn.

Xử lý sự cố

API key bị thiếu, đã hết hạn hoặc bị thu hồi — hoặc quyền truy cập API chưa được bật cho space. Tạo key mới trong Personal Settings → API, xác nhận space cho phép truy cập API và kết nối lại.
BACKLOG_DOMAIN được đặt thành space key thay vì domain đầy đủ. Sử dụng host đầy đủ, ví dụ: <myorg>.backlog.com và kết nối lại.
Người dùng của key không phải thành viên của bất kỳ project nào, hoặc thiếu quyền xem các project bạn mong đợi. Thêm người dùng vào project mục tiêu trong Backlog, sau đó chạy lại khám phá.
Người dùng của key thiếu quyền ghi trên project. Tạo lại key từ người dùng có vai trò project phù hợp và phê duyệt hành động khi được nhắc.
Các phản hồi rất lớn bị cắt bớt để giữ câu trả lời tập trung. Giới hạn yêu cầu vào một project, milestone hoặc trạng thái đơn lẻ, hoặc yêu cầu đếm trước rồi đi sâu vào chi tiết.

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.
  • Người dùng đặc quyền tối thiểu — tạo API key từ người dùng chỉ có quyền truy cập project mà CloudThinker cần.
  • Domain chính xác — lưu domain đầy đủ (<myorg>.backlog.com), không chỉ space key.

Liên quan

Kết nối Atlassian

Theo dõi issue Jira và Confluence và kiến thức cơ sở

Phê duyệt

Cách thức hoạt động của các hành động được kiểm soát phê duyệt