Tạo và quản lý phiếu

Hướng dẫn này chỉ cho bạn cách tạo và quản lý phiếu.

Tạo một phiếu

Từ giao diện

Nhấn Phiếu trong thanh bên của không gian làm việc.
Nhấn Phiếu mới.
Điền vào:
- Tiêu đề — tóm tắt ngắn. Đây là trường bắt buộc duy nhất.
- Mô tả — markdown, có thanh công cụ định dạng.
- Trạng thái — Mở (mặc định) hoặc Backlog. Các trạng thái đã bắt đầu và trạng thái kết thúc chỉ đạt được qua vòng đời, chứ không phải khi tạo.
- Độ ưu tiên — không, khẩn cấp, cao, trung bình hoặc thấp.
- Người được gán — chính bạn hoặc bất kỳ agent nào trong không gian làm việc.
- Dự án — nhóm tùy chọn.
Nhấn Tạo, hoặc bật Tạo thêm trước để giữ hộp thoại mở cho việc nhập nhanh liên tục.

Hộp thoại không có hộp chọn nhà cung cấp. Phiếu được tạo theo nhà cung cấp phiếu đang hoạt động của không gian làm việc.

Từ một agent

Hãy nhờ một agent trong space:

Tạo một phiếu để sửa lỗi hết thời gian chờ đăng nhập trên các kết nối chậm.

Nó gọi công cụ MCP create_ticket. Trên công cụ đó, độ ưu tiên là một số nguyên, không phải tên:

create_ticket(
  workspace_id: "...",
  title: "Fix login timeout on slow connections",
  description: "...",
  priority: 2
)

Giá trị	Độ ưu tiên
`0`	Không
`1`	Khẩn cấp
`2`	Cao
`3`	Trung bình
`4`	Thấp

Chỉ workspace_id và title là bắt buộc; description, priority, assignee (id của agent) và team_id là tùy chọn. Công cụ này được xếp vào loại ghi đồng bộ nhà cung cấp và sẽ hỏi ý kiến phê duyệt của bạn trước khi chạy.

Cập nhật trạng thái phiếu

Phiếu tuân theo vòng đời này:

backlog → open → inProgress ⇄ blocked
                    ↓   ↑
                 inReview
                    ↓
              done / failed   (terminal)

done, failed và cancelled là các trạng thái kết thúc. cancelled có thể đạt được từ bất kỳ trạng thái không kết thúc nào. done và failed có thể đạt được từ inProgress hoặc inReview; open cũng có thể chuyển thẳng sang blocked. Hộp chọn trạng thái trong giao diện liệt kê mọi trạng thái trừ failed — agent đánh dấu trạng thái đó bằng fail_ticket.

Để thay đổi trạng thái, hãy dùng một trong các cách sau:

hàng Trạng thái trong thanh thuộc tính của phiếu,
menu con Trạng thái trong menu chuột phải của một phiếu trong danh sách,
chip Trạng thái trên thanh nổi sau khi chọn nhiều phiếu.

Các thay đổi trạng thái phát ra sự kiện miền (TicketStatusChanged, TicketCompleted và những sự kiện khác) có thể kích hoạt quy trình. Xem Thiết lập trình kích hoạt quy trình.

Gán một phiếu

Mở phiếu.
Trong thanh thuộc tính, đặt Người được gán — chính bạn, một thành viên khác của không gian làm việc, hoặc một agent.

Thêm nhãn

Nhãn được áp dụng hàng loạt từ danh sách phiếu, chứ không phải từ một phiếu riêng lẻ — thanh thuộc tính không có điều khiển nhãn.

Di chuột qua một hàng trong danh sách phiếu và tích vào hộp kiểm của hàng đó. Tích bao nhiêu hàng tùy ý; một thanh nổi sẽ xuất hiện ngay khi có thứ gì đó được chọn.
Trong thanh đó, mở chip Nhãn.
Chọn một nhãn. Nhãn đó được thêm vào mọi phiếu đã chọn mà chưa có nó; các nhãn sẵn có không bao giờ bị gỡ mất. Xóa nhãn sẽ gỡ toàn bộ nhãn. Hộp chọn liệt kê những nhãn đã có trên một phiếu nào đó trong không gian làm việc. Agent có thể thêm tên nhãn mới qua update_ticket hoặc tickets.patch.

Liên kết phiếu

Các quan hệ nằm trên thẻ Liên kết của phiếu trong thanh thuộc tính, hoặc sau mục Liên kết với trong menu chuột phải của danh sách.

Mở phiếu và tìm thẻ Liên kết.
Nhấn nút thêm của thẻ và chọn quan hệ:

Quan hệ	Ý nghĩa
Phiếu con của…	Phiếu cha của phiếu này là phiếu kia
Phiếu cha của…	Phiếu kia là phiếu con của phiếu này
Bị chặn bởi…	Phiếu này bị phiếu kia chặn
Đang chặn…	Phiếu này chặn phiếu kia
Liên quan đến…	Đối xứng, không ngụ ý hướng nào
Trùng với…	Phiếu này là bản trùng của phiếu kia

Chọn phiếu đích.

Bị trùng bởi xuất hiện trên thẻ nhưng không có trong hộp chọn — nó là quan hệ nghịch đảo của Trùng với và được đặt từ phiếu kia. Mỗi quan hệ được liệt kê đều có thể nhấn để mở phiếu được liên kết và có thể gỡ bỏ khi di chuột qua.

Quan hệ cha và phiếu con được lưu trên chính phiếu chứ không phải dưới dạng các hàng liên kết, nên xóa một phiếu cha sẽ xóa theo dây chuyền các phiếu con của nó (xem bên dưới), còn các liên kết chặn và liên quan thì không.

Thêm cộng tác viên

Cộng tác viên là một danh sách trên phiếu — ai tham gia và với vai trò gì.

Mở phiếu.
Nhấn nút thêm người trên thẻ Thêm cộng tác viên.
Chọn một agent.

Ba vai trò là assignee, collaborator (mặc định) và reviewer. Hộp chọn trong giao diện chỉ liệt kê các agent trong không gian làm việc và luôn ghi vai trò mặc định; con người có thể xuất hiện dưới dạng các hàng nhưng không được đưa ra trong menu đó. Công cụ MCP add_ticket_collaborator nhận một role.

Thêm một cộng tác viên chỉ ghi một hàng và không phát ra sự kiện miền nào; nó không cấp quyền truy cập space nào. Để đưa một agent vào một cuộc hội thoại, hãy thêm nó làm người tham gia từ tiêu đề space — xem Dùng space.

Xóa một phiếu

Dùng Xóa phiếu ở cuối thanh thuộc tính, trong menu chuột phải, hoặc thao tác xóa trên thanh nổi sau khi chọn nhiều phiếu.