> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cloudthinker.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Backlog

> Kết nối Backlog của Nulab với CloudThinker để theo dõi issue, lập kế hoạch milestone, wiki và ngữ cảnh pull request

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.

<Info>
  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.
</Info>

***

## Thiết lập

<Steps>
  <Step title="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ó.
  </Step>

  <Step title="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**.
  </Step>
</Steps>

<Warning>
  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.
</Warning>

***

## Chi tiết kết nối

| Trường                | Mô tả                                                           | Ví dụ                 |
| --------------------- | --------------------------------------------------------------- | --------------------- |
| **BACKLOG\_DOMAIN**   | Domain Backlog đầy đủ cho space của bạn, không chỉ là space key | `<myorg>.backlog.com` |
| **BACKLOG\_API\_KEY** | API 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](/vi/guide/approval) rõ ràng trong CloudThinker.

<Tip>
  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ệ.
</Tip>

***

## 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ăng                     | Mô tả                                                                                                                                |
| ---------------------------- | ------------------------------------------------------------------------------------------------------------------------------------ |
| **Khám phá project & space** | Liệ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 issue**           | Tì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ành**    | Liệ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 request**       | Kiể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

```text theme={null}
@alex list my Backlog projects and show the open issues in one of them
```

### Các lệnh mẫu

```text theme={null}
@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
```

<Note>
  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.
</Note>

***

## Xử lý sự cố

<Accordion title="401 Unauthorized">
  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.
</Accordion>

<Accordion title="Yêu cầu trả về 404 hoặc sai space">
  **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.
</Accordion>

<Accordion title="Kết nối hoạt động nhưng không thấy project hoặc issue nào">
  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á.
</Accordion>

<Accordion title="Thao tác tạo hoặc cập nhật thất bại với lỗi quyền">
  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.
</Accordion>

<Accordion title="Kết quả bị cắt bớt trên các project lớn">
  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.
</Accordion>

***

## 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

<CardGroup cols={2}>
  <Card title="Kết nối Atlassian" icon="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" href="/vi/guide/connections/atlassian" width="24" height="24" data-path="images/icons/atlassian.svg">
    Theo dõi issue Jira và Confluence và kiến thức cơ sở
  </Card>

  <Card title="Phê duyệt" icon="shield-check" href="/vi/guide/approval">
    Cách thức hoạt động của các hành động được kiểm soát phê duyệt
  </Card>
</CardGroup>