Linear

เชื่อมต่อ Linear เพื่อให้เอเจนต์ยื่น issue จากการสืบสวน อัปเดตสถานะ และทำให้ตัวติดตาม issue ของคุณตรงกับสิ่งที่พบ

การตั้งค่า

1. ใน Linear เปิด Settings แล้วไปที่ Security & access
2. ใต้ Personal API keys สร้างคีย์ มันต้องมีสิทธิ์เขียนเพื่อให้เอเจนต์สร้างและอัปเดต issue ได้
3. วางคีย์ใน Polylane Polylane ตรวจสอบกับ workspace ของ Linear ของคุณและเชื่อมต่อ

คีย์ของคุณถูกเข้ารหัสก่อนจัดเก็บ และเอเจนต์ไม่มีทางเห็นมัน

สิ่งที่เอเจนต์ทำได้

• แสดงรายการทีม สถานะเวิร์กโฟลว์ สมาชิก และโปรเจกต์
• แสดงรายการ ค้นหา และอ่าน issue พร้อมความเห็นล่าสุด
• สร้าง issue จากสิ่งที่พบในการสืบสวน พร้อมร่องรอยหลักฐานในคำอธิบาย
• อัปเดตสถานะ ความสำคัญ ผู้รับผิดชอบ โปรเจกต์ ป้ายกำกับ และวันครบกำหนดของ issue
• แสดงความเห็นบน issue พร้อมสิ่งที่พบและสถานะ
• รัน GraphQL ใดก็ได้กับ Linear API สำหรับสิ่งที่ไม่ครอบคลุมข้างต้น mutation ผ่านด่านยืนยันเดียวกัน

การเขียน issue ขอการยืนยันก่อนดำเนินการเสมอ

webhook และการคัดกรอง

การเชื่อมต่อลงทะเบียน webhook ของ Polylane ใน workspace ของ Linear ของคุณ ครอบคลุม issue ในทุกทีมสาธารณะ เมื่อมี webhook แล้ว:

• issue ที่กลายเป็นเร่งด่วนมาถึงเป็น alert และถูกคัดกรองเมื่อทำงาน การลดระดับหรือทำ issue ให้เสร็จจะแก้ไข alert

การสร้าง webhook ต้องให้ผู้ใช้ของคีย์ API เป็นผู้ดูแล workspace ใน Linear คีย์ที่ไม่ใช่ผู้ดูแลยังเชื่อมต่อได้และทุกเครื่องมือของเอเจนต์ใช้งานได้ เฉพาะการคัดกรองที่ขับเคลื่อนด้วย webhook เท่านั้นที่ถูกข้าม

การแก้ปัญหา

ข้อผิดพลาด "Invalid API key"

• ใช้ personal API key จาก Security & access ไม่รองรับโทเค็น OAuth Polylane ส่งคีย์ตามที่เป็นใน header Authorization โดยไม่มีคำนำหน้า Bearer ตรงตามที่ Linear คาดหวังสำหรับคีย์ส่วนตัว
• ตรวจว่าคีย์ไม่ได้ถูกเพิกถอนใน Linear

ไม่มี alert หรือ trigger จาก Linear

• การสร้าง webhook ต้องใช้คีย์ของผู้ดูแล workspace เชื่อมต่อใหม่ด้วยคีย์ของผู้ดูแลเพื่อเปิดใช้การคัดกรองและ trigger ที่ขับเคลื่อนด้วย webhook

การยกเลิกการเชื่อมต่อ

ยกเลิกการเชื่อมต่อ Linear ใน Polylane ซึ่งลบ webhook ที่มันลงทะเบียนไว้ด้วย แล้วเพิกถอนคีย์ API ใน Linear