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

# Jira Service Management

> Kết nối Jira Service Management Operations để agent phân loại cảnh báo, kiểm tra lịch on-call và xử lý vòng đời cảnh báo

Kết nối Jira Service Management (JSM) Operations để các agent CloudThinker phân loại cảnh báo, xem ai đang on-call, và acknowledge, thêm ghi chú hoặc escalate cảnh báo trong sự cố. Operations là sản phẩm cảnh báo và on-call của JSM (trước đây là Opsgenie), và kết nối đăng nhập bằng **Atlassian API token** cùng email của tài khoản sở hữu token đó.

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

* Một workspace CloudThinker dùng gói **Scale** trở lên. Ở các gói thấp hơn, nút hiển thị **Upgrade to Connect**.
* Một site JSM đã bật **Operations**.
* Một tài khoản Atlassian có thể mở Operations trên site đó, cùng API token của tài khoản.
* Vai trò **Admin** trong workspace CloudThinker, có quyền thêm và sửa kết nối. Xem [Vai trò](https://docs.cloudthinker.io/vi/guide/security/roles.md).

> [!NOTE]
>
> Kết nối này tách biệt với kết nối [Atlassian](https://docs.cloudthinker.io/vi/guide/connections/atlassian.md), vốn bao gồm Jira issue và Confluence qua OAuth. Atlassian chỉ mở Operations qua API token, nên bạn cần cả hai kết nối cho ticket và cảnh báo.

## Thiết lập

**1. Kiểm tra tài khoản mở được Operations**

Đăng nhập site bằng tài khoản agent sẽ dùng và xác nhận **Operations** xuất hiện trên thanh bên của JSM. Nếu không có, kết nối sẽ thất bại, bất kể token có quyền gì.

**2. Tạo API token**

Đăng nhập bằng tài khoản đó, vào [id.atlassian.com → Security → API tokens](https://id.atlassian.com/manage-profile/security/api-tokens), nhấn **Create API token**, đặt nhãn `cloudthinker` và chọn ngày hết hạn. Sao chép token ngay. Atlassian sẽ không hiển thị lại.

Token ngừng hoạt động vào ngày hết hạn. Hãy đặt lời nhắc trong lịch để tạo token mới và cập nhật kết nối trước ngày đó.

**3. Thêm kết nối trong CloudThinker**

Trên thanh bên, nhấn **More → Workspace settings → Connections**, giữ ở tab **Builtin Connections** và chọn **Jira Service Management**. Điền:

* **Site URL**: site Atlassian của bạn, chẳng hạn `https://acme.atlassian.net`
* **Account email**: tài khoản đã tạo token
* **API token**: token bạn đã sao chép

Nhấn **Connect**.

**Trạng thái thành công:** Jira Service Management hiển thị trạng thái **Connected**. Chạy prompt xác minh bên dưới để xác nhận cảnh báo được trả về.

> [!WARNING]
>
> API token có mọi quyền của tài khoản sở hữu token. Hãy tạo token dưới một tài khoản riêng chỉ thuộc các team mà CloudThinker cần truy cập, không bao giờ dưới site admin. Tài khoản đó cần quyền truy cập Jira Service Management, nên tài khoản này được tính là một user trong gói Atlassian của bạn.

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

| Trường | Mô tả | Ví dụ |
| - | - | - |
| **Site URL** | Site Atlassian của bạn. Dán URL của project hoặc board cũng được. | `https://acme.atlassian.net` |
| **Account email** | Tài khoản Atlassian sở hữu API token | `ops-bot@acme.com` |
| **API token** | Atlassian API token, không phải mật khẩu tài khoản | `<api-token>` |

## Quyền yêu cầu

JSM giới hạn cảnh báo và lịch trực theo team, và token kế thừa quyền truy cập của tài khoản.

* **Để đọc**: thêm tài khoản vào mọi team có cảnh báo và lịch trực mà agent cần xem.
* **Để hành động**: tài khoản cần quyền trong JSM để acknowledge, assign, thêm ghi chú, đóng và escalate cảnh báo trên các team đó.

> [!TIP]
>
> Bắt đầu với tài khoản chỉ thuộc một hoặc hai team. Mở rộng sau khi bạn đã thấy cách agent xử lý cảnh báo ở đó.

## Khả năng của agent

| Khả năng | Agent có thể làm gì | Phê duyệt |
| - | - | - |
| **Phân loại cảnh báo** | Liệt kê cảnh báo đang mở, đọc timeline, ghi chú và responder của một cảnh báo | Không |
| **On-call** | Xem ai đang on-call trên các lịch trực và phát hiện lịch không có người trực | Không |
| **Sự cố liên kết** | Đọc JSM incident issue đứng sau một cảnh báo | Không |
| **Vòng đời cảnh báo** | Acknowledge, assign, thêm ghi chú hoặc thêm responder | Có |
| **Đóng hoặc escalate** | Đóng một cảnh báo, hoặc escalate lên cấp tiếp theo | Có, không bao giờ được AI phê duyệt |

Không thể hoàn tác thao tác đóng cảnh báo từ CloudThinker, còn escalate sẽ page người trực. AI không bao giờ tự phê duyệt hai hành động này, nên cả hai luôn chờ người phê duyệt. Mọi hành động khác tuân theo cài đặt [Approvals](https://docs.cloudthinker.io/vi/guide/approvals/overview.md) của bạn.

Mọi thay đổi do agent thực hiện đều đi qua [Approvals](https://docs.cloudthinker.io/vi/guide/approvals/overview.md) 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](https://docs.cloudthinker.io/vi/guide/approvals/rules.md#khắc-phục-sự-cố) cho workspace của bạn. Chọn **Manual** nếu bạn muốn tự phê duyệt mọi thay đổi.

Các hành động JSM được xếp hàng đợi: Atlassian chấp nhận rồi áp dụng sau đó một lúc. Agent chờ kết quả và không bao giờ gửi lại hành động, nên bạn sẽ không bị page hai lần.

### Dùng với Resolve

Trong **Resolve → Integrations → Jira Service Management**, JSM có thể gửi cảnh báo đến [Resolve](https://docs.cloudthinker.io/vi/guide/incident/overview.md) như một tín hiệu và chạy outcome **Keep the provider alert in step**. Khi bật outcome này, Resolve acknowledge cảnh báo đang xử lý và thêm những gì tìm được dưới dạng ghi chú cảnh báo. Khi không có ai on-call, Resolve thêm team phụ trách lịch trực làm responder thay vì assign cho một người. Bật outcome này đồng nghĩa với phê duyệt trước ba hành động trên. Outcome này không bao gồm đóng hoặc escalate: hai hành động đó đi qua Approvals như mô tả ở trên, nên sẽ chờ người phê duyệt, trừ khi một Rule của bạn quyết định trước (điều này chỉ xảy ra khi workspace đã bật Rule enforcement). Xem [Tích hợp Resolve](https://docs.cloudthinker.io/vi/guide/incident/integrations.md).

### Xác minh kết nối

```text theme={null}
List open JSM alerts by priority and tell me who is on call right now
```

Kết quả mong đợi là danh sách ngắn các cảnh báo và người đang on-call cho từng lịch trực. Danh sách on-call trống là kết quả thật: lịch trực đó hiện không có ai trực.

### Ví dụ prompt

```text theme={null}
Which JSM alerts fired most often this week, and which teams own them?
Show the timeline of the open checkout-latency alert and who has touched it
Acknowledge the checkout-latency alert and add a note with the deploy that preceded it
```

Prompt cuối thay đổi cảnh báo, nên phải đi qua [Approvals](https://docs.cloudthinker.io/vi/guide/approvals/overview.md) của workspace trước.

## Khắc phục sự cố

> **Account does not have access to Opsgenie**
>
> Token hoạt động, nhưng Operations chưa được bật cho site hoặc tài khoản không mở được Operations. Đây không phải vấn đề về scope của token. Xác nhận **Operations** xuất hiện trên thanh bên JSM của tài khoản đó, rồi kết nối lại.

> **Authentication failed (401)**
>
> Token sai, đã hết hạn hoặc bị thu hồi, hoặc email thuộc tài khoản khác. Email phải là của tài khoản đã tạo token. Tạo token mới và sửa kết nối.

> **Site URL không phân giải được**
>
> Nhập địa chỉ site Atlassian, chẳng hạn `https://acme.atlassian.net`. Tên miền tùy chỉnh không trỏ đến một site Atlassian sẽ thất bại.

> **Thiếu một số cảnh báo**
>
> Tài khoản không thuộc team sở hữu các cảnh báo đó. Thêm tài khoản vào team đó trong JSM, rồi hỏi lại.

> **Nút hiển thị Upgrade to Connect**
>
> Gói CloudThinker của bạn không bao gồm các kết nối Atlassian. Các kết nối này cần gói Scale trở lên. Xem [Bảng giá](https://docs.cloudthinker.io/vi/guide/billing/pricing.md).

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

- **Tài khoản riêng**: tạo token từ tài khoản dành riêng cho CloudThinker, để thu hồi token không bao giờ khóa tài khoản của một người thật.
- **Giới hạn theo team**: chỉ để tài khoản đó trong các team mà agent cần xem và hành động. Token truy cập được mọi thứ tài khoản truy cập được.

## Liên quan

> **[Tích hợp Resolve](https://docs.cloudthinker.io/vi/guide/incident/integrations.md)**
>
> Gửi cảnh báo JSM đến Resolve và đồng bộ chúng với sự cố.

> **[Atlassian](https://docs.cloudthinker.io/vi/guide/connections/atlassian.md)**
>
> Kết nối Jira issue và Confluence qua OAuth.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.