Jira Service Management

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

Kết nối này tách biệt với kết nối Atlassian, 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

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

Tạo API token

Đăng nhập bằng tài khoản đó, vào id.atlassian.com → 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 đó.

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

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 đó.

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 của bạn. Mọi thay đổi do agent thực hiện đều đi qua Approvals 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 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 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.

Xác minh kết nối

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

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

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.

Kết nối

Customize

Approvals

Cài đặt workspace

Admin Settings

Triển khai

Artifacts và chia sẻ

Jira Service Management

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

Thiết lập

Chi tiết kết nối

Quyền yêu cầu

Khả năng của agent

Dùng với Resolve

Xác minh kết nối

Ví dụ prompt

Khắc phục sự cố

Bảo mật

Liên quan

Tích hợp Resolve

Atlassian

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

​Thiết lập

​Chi tiết kết nối

​Quyền yêu cầu

​Khả năng của agent

​Dùng với Resolve

​Xác minh kết nối

​Ví dụ prompt

​Khắc phục sự cố

​Bảo mật

​Liên quan

Tích hợp Resolve

Atlassian

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

Thiết lập

Chi tiết kết nối

Quyền yêu cầu

Khả năng của agent

Dùng với Resolve

Xác minh kết nối

Ví dụ prompt

Khắc phục sự cố

Bảo mật

Liên quan