Chuyển đến nội dung chính
Kết nối Backlog của Nulab để các agent CloudThinker đọc project, issue, milestone, wiki và pull request của bạn, đồng thời tạo hoặc cập nhật issue, milestone và trang wiki khi bạn yêu cầu. Backlog xác thực bằng API key, và key có cùng quyền truy cập project với người dùng Backlog đã tạo ra nó.

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

  • Một người dùng Backlog là thành viên của mọi project bạn muốn CloudThinker đọc.
  • Quyền truy cập API đã bật cho space của bạn. Nếu space hạn chế quyền này, quản trị viên space phải bật trước.
  • Quyền ghi trên project cho người dùng đó, chỉ khi bạn muốn agent tạo hoặc cập nhật issue, milestone hay trang wiki trong project đó.
  • Quyền quản lý kết nối trong workspace CloudThinker của bạn. Backlog dùng được trên mọi gói CloudThinker.

Thiết lập

1

Tạo API key trong Backlog

Trong Backlog, mở menu hồ sơ và vào Personal Settings → API. Nhập ghi chú, ví dụ cloudthinker, đăng ký key rồi sao chép key.Hãy tạo key từ người dùng có đúng quyền truy cập bạn muốn cấp cho CloudThinker. Ai giữ key cũng hành động với tư cách người dùng đó.
2

Mở Backlog trong CloudThinker

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

Nhập domain và key

Điền vào BACKLOG_DOMAIN host đầy đủ của space, ví dụ myorg.backlog.com hoặc myorg.backlog.jp. Dán key vào BACKLOG_API_KEY, rồi nhấn Connect.Trạng thái thành công: CloudThinker kiểm tra key và Backlog hiển thị trạng thái Connected.

Chi tiết kết nối

Quyền yêu cầu

Backlog không có scope riêng cho từng key. Key làm được mọi việc mà người dùng của key làm được trong Backlog. Thao tác đọc chạy mà không cần hỏi. Thao tác ghi đi qua Approvals: Approval mode của bạn quyết định CloudThinker chạy thao tác, hỏi bạn trước hay từ chối, và khi Rule enforcement đã bật cho workspace, Rules của bạn quyết định trước. Trong chat, CloudThinker chỉ đề xuất thao tác ghi khi bạn nêu rõ mục cần đổi và thay đổi cần làm. Ngoại lệ là ticket theo dõi của Resolve: các ticket này chạy theo outcome bạn bật trong Triggers & Outcomes của Resolve.
Hãy tạo key từ một người dùng Backlog riêng, chỉ là thành viên của các project CloudThinker cần. Chỉ cấp quyền ghi trên những project bạn muốn agent tạo hoặc cập nhật ticket. Người dùng riêng này có thể bị tính vào giới hạn người dùng của gói Backlog.

Khả năng của agent

Xác minh kết nối

Bạn sẽ nhận được tên project kèm key như PLATFORM, và key issue như PLATFORM-42 mà bạn mở được trong Backlog.

Ví dụ prompt

Prompt thứ ba là thao tác ghi, nên CloudThinker hiển thị bình luận và gửi qua quy trình phê duyệt của bạn trước khi đăng.

Khắc phục sự cố

Key sai, đã bị xóa, hoặc quyền truy cập API đang tắt cho space. Tạo key mới trong Personal Settings → API, xác nhận với quản trị viên space rằng truy cập API được cho phép, rồi cập nhật BACKLOG_API_KEY trên kết nối.
BACKLOG_DOMAIN chỉ chứa space key (myorg) hoặc sai vùng. Nhập host đầy đủ đúng như trên trình duyệt, ví dụ myorg.backlog.com hoặc myorg.backlog.jp, rồi kết nối lại.
Người dùng của key không phải thành viên của các project đó. Thêm người dùng vào project trong Backlog, rồi yêu cầu CloudThinker liệt kê lại project.
Người dùng của key đọc được project nhưng không ghi được. Cấp quyền ghi trên project cho người dùng đó, hoặc tạo lại key từ người dùng đã có quyền này, rồi phê duyệt lại thao tác.
CloudThinker giới hạn mỗi phản hồi Backlog ở khoảng 10.000 token để câu trả lời dễ đọc. Thu hẹp yêu cầu vào một project, milestone, trạng thái hoặc người được giao, hoặc hỏi số lượng trước rồi đi sâu sau.

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.
  • Key chính là người dùng. Key mang mọi quyền của người dùng Backlog đã tạo ra nó, nên hãy tạo key từ một người dùng riêng có quyền tối thiểu và xóa key trong Backlog khi bạn gỡ kết nối.
  • Thao tác ghi đi qua Approvals. Thay đổi issue, wiki và milestone đi qua Approvals, nơi Approval mode quyết định từng thay đổi. Chọn Manual nếu cần một người xem mọi thay đổi, và không cấp cho key nhiều quyền ghi hơn mức các thay đổi đó cần.

Liên quan

Kết nối

Xem mọi dịch vụ mà agent CloudThinker có thể dùng.

Triggers & Outcomes của Resolve

Bật ticket theo dõi trong Backlog sau sự cố.