Chuyển đến nội dung chính
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

TrườngMô tảVí dụ
BACKLOG_DOMAINDomain Backlog đầy đủ cho space của bạn, không chỉ là space key<myorg>.backlog.com
BACKLOG_API_KEYAPI key theo phạm vi space dùng để xác thực 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 và 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.
Khả năngMô tả
Khám phá project & spaceLiệt kê project, danh mục, trường tùy chỉnh, mức ưu tiên và hoạt động gần đây của space
Theo dõi issueTìm kiếm, đọc và đếm issue; tạo và cập nhật issue, thay đổi trạng thái và thêm bình luận — thao tác ghi yêu cầu phê duyệt
Milestone & phát hànhLiệt kê milestone/phiên bản và lập kế hoạch phát hành; tạo hoặc cập nhật chúng — thao tác ghi yêu cầu phê duyệt
Wiki & tài liệuĐọc wiki và tài liệu project; tạo hoặc cập nhật trang wiki — thao tác ghi yêu cầu phê duyệt
Git & pull requestKiểm tra repository và pull request, lấy ngữ cảnh ticket trong code review và bình luận trên PR — thao tác ghi yêu cầu phê duyệt

​
Xác minh kết nối

@alex list my Backlog projects and show the open issues in one of them

​
Các lệnh mẫu

@alex summarize the open Backlog issues for the PLATFORM project and #report anything overdue
@alex this PR references PROJ-123 — pull the Backlog ticket and #recommend whether the change matches it
@alex list the milestones for my main project and their completion status
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

https://mintcdn.com/cloudthinker/aLd-ttc-SCW-aFky/images/icons/atlassian.svg?fit=max&auto=format&n=aLd-ttc-SCW-aFky&q=85&s=64fcf0381646a233832602a9086a14eb

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