Kết nối Linear
Kết nối Linear bằng tài khoản hoặc Personal API key để AI tra cứu issue, dự án, chu kỳ và tài liệu; bật quyền ghi nếu muốn AI tạo issue và bình luận (luôn hỏi bạn trước).
Kết nối Linear cho phép Agent và workflow tra cứu issue, dự án, chu kỳ (cycle) và tài liệu trong Linear của bạn. Nếu bạn bật thêm quyền ghi, AI còn có thể tạo, cập nhật issue và đăng bình luận dưới tên bạn, và luôn hỏi bạn xác nhận trước mỗi thay đổi.
Mở trang kết nối Linear
- Trên thanh bên trái, bấm Công cụ.
- Bấm thẻ Linear.
Chọn quyền: chỉ đọc hay đọc và ghi
Khi chưa kết nối, trang có ô Cho phép cả thao tác ghi trong Linear:
- Bỏ chọn (mặc định): chỉ cấp quyền đọc. AI xem được issue, dự án, tài liệu nhưng không thay đổi gì.
- Chọn: AI có thể tạo, cập nhật issue và đăng bình luận dưới tên bạn. AI luôn nêu rõ thay đổi và hỏi bạn xác nhận trước.
Hai cách kết nối
| Cách | Khi nào dùng | Làm thế nào |
|---|---|---|
| Kết nối với Linear (đăng nhập OAuth) | Cách khuyến nghị | Bấm nút, đăng nhập Linear và đồng ý cấp quyền. Bạn được đưa trở lại trang kết nối. |
| Dùng API key | Khi không đăng nhập OAuth được | Tạo Personal API key trong Linear → Settings → Security & access (quyền Read, thêm Write nếu bật quyền ghi), rồi dán vào hộp thoại. |
API key được mã hoá khi lưu và không bao giờ hiển thị lại.
Sau khi kết nối, trang hiện tên workspace và tài khoản Linear, cách đăng nhập (Đăng nhập bằng OAuth hoặc Personal API key), mức quyền (Chỉ đọc hoặc Đọc và ghi) và thời điểm kết nối.
Linear làm được gì?
| Dịch vụ | Nội dung |
|---|---|
| Issue | Tìm, liệt kê issue theo nhóm, dự án, trạng thái, người phụ trách; xem chi tiết và bình luận. |
| Dự án và chu kỳ | Liệt kê nhóm, dự án; xem tiến độ dự án và các chu kỳ. Chỉ đọc. |
| Tài liệu | Liệt kê và đọc tài liệu dự án. Chỉ đọc. |
| Tạo và cập nhật (tùy chọn) | Tạo/cập nhật issue và bình luận issue. Chỉ hoạt động khi bạn kết nối với quyền đọc và ghi. |
| Công cụ khác | Các công cụ Linear khác (nhãn, mốc, bản phát hành, tệp đính kèm…). Bấm thẻ để xem danh sách Đọc và Ghi / xoá. |
Bật hoặc tắt quyền ghi sau khi đã kết nối
- Đang Chỉ đọc: bấm Bật quyền ghi. Nếu bạn kết nối bằng OAuth, Linear sẽ hỏi cấp quyền lại. Nếu bằng API key, hộp thoại yêu cầu một key có quyền Read và Write.
- Đang Đọc và ghi: bấm Tắt quyền ghi và xác nhận. AI sẽ không tạo hay thay đổi gì trong Linear nữa, kết nối đọc vẫn được giữ.
Linear chỉ cấp quyền đọc?
Nếu bạn yêu cầu quyền ghi nhưng trên trang Linear không chấp thuận đủ quyền, Top AgentIC báo "Linear chỉ cấp quyền đọc nên thao tác ghi đang tắt". Hãy thử lại và chấp thuận quyền ghi, hoặc tiếp tục dùng chỉ đọc.
Dùng Linear trong chat
- "Liệt kê các issue đang In Progress của nhóm ADT được giao cho tôi."
- "Tóm tắt tiến độ dự án X trong chu kỳ hiện tại."
- "Tạo issue cho nhóm ADT: sửa lỗi đăng nhập trên điện thoại, ưu tiên cao." (cần quyền ghi; AI sẽ hỏi xác nhận trước khi tạo)
Khi AI muốn ghi, bạn sẽ thấy một thẻ xác nhận nêu rõ thay đổi. Xem Thẻ xác nhận và gợi ý.
Đổi cách kết nối hoặc ngắt kết nối
Muốn chuyển từ OAuth sang API key (hoặc ngược lại), bấm Ngắt kết nối trước rồi kết nối lại bằng cách mới. Sau khi ngắt kết nối, AI không dùng được tài khoản Linear này cho tới khi bạn kết nối lại.