ข้ามไปยังเนื้อหา
กลับหน้ารายการบทความ

GitHub App จัดการ Copilot Seat ระดับ Enterprise ผ่าน API ได้แล้ว

GitHub เปิดให้ Enterprise GitHub App จัดสรรและยกเลิก Copilot seat ผ่าน REST API โดยใช้สิทธิ์ใหม่ Enterprise Copilot license management

GitHub App จัดการ Copilot Seat ระดับ Enterprise ผ่าน API ได้แล้ว

GitHub ประกาศเมื่อวันที่ 10 พฤศจิกายน 2026 ว่า GitHub App ที่ติดตั้งในระดับ Enterprise สามารถเรียก API จัดการสิทธิ์ใช้งาน Copilot ระดับ Enterprise ได้แล้ว การเปลี่ยนแปลงนี้เปิดทางให้ทีมไอทีเชื่อมระบบจัดการบัญชีพนักงานกับการจัดสรร Copilot seat โดยใช้ตัวตนของแอป แทนการผูกกระบวนการอัตโนมัติไว้กับโทเคนของบุคคลใดบุคคลหนึ่ง GitHub เพิ่มสิทธิ์แบบละเอียดชื่อ Enterprise Copilot license management สำหรับงานนี้โดยเฉพาะ

สิ่งที่ API ทำได้จริง

เอกสาร REST API ของ GitHub ระบุ endpoint สำหรับดูรายการ seat ที่กำลังคิดค่าบริการทั่ว Enterprise, ดูรายละเอียด seat ของผู้ใช้, เพิ่มหรือลบผู้ใช้รายคน และเพิ่มหรือลบ Enterprise team ออกจากการสมัครใช้ Copilot การเพิ่มผู้ใช้หรือทีมมีผลต่อจำนวน seat ที่คิดเงิน ส่วนการลบจะทำให้ seat เข้าสถานะรอยกเลิกและผู้ใช้เสียสิทธิ์เมื่อจบรอบบิล หากยังมีสิทธิ์ผ่านทีมอื่นหรือองค์กรอื่น ผู้ใช้อาจยังเข้าถึง Copilot ได้ตามเส้นทางสิทธิ์นั้น จึงควรตรวจผลจากรายการ seat หลังดำเนินการ ไม่ควรตีความว่าคำสั่งลบหนึ่งครั้งเท่ากับหยุดคิดเงินหรือหยุดเข้าถึงทันที

API รายการ seat ยังมีรายละเอียดกิจกรรมล่าสุด แต่เอกสารระบุว่าข้อมูลกิจกรรมใน IDE ขึ้นกับการเปิด telemetry ของผู้ใช้ ดังนั้นค่า last_activity_at ที่ว่างหรือเก่าจึงไม่ใช่หลักฐานเด็ดขาดว่าบัญชีนั้นไม่ใช้ Copilot ทีมที่ออกแบบนโยบายเรียกคืน seat ควรประกอบข้อมูลจากระบบบุคลากร การเป็นสมาชิกทีม และการอนุมัติของเจ้าของงบประมาณ แทนการตัดสินจากเวลาใช้งานเพียงฟิลด์เดียว

ออกแบบ GitHub App อย่างไร

สิทธิ์ใหม่นี้แยก read สำหรับการดูข้อมูลออกจาก write สำหรับการเพิ่มและลบ seat ผู้ดูแลควรเริ่มจาก App ที่มีสิทธิ์อ่านเพื่อทำ inventory และตรวจความถูกต้องของการจับคู่ผู้ใช้กับทีมก่อน หากต้องมีระบบปรับ seat อัตโนมัติจึงเพิ่มสิทธิ์เขียนให้ App ที่ทำงานนั้น และจำกัดผู้ที่อนุมัติการติดตั้งหรือเปลี่ยนสิทธิ์ของ App ตามกระบวนการภายในองค์กร เอกสาร GitHub ระบุว่าทั้ง GitHub App user access token และ installation access token ใช้กับ endpoint เหล่านี้ได้เมื่อมีชุดสิทธิ์ที่กำหนด

ตัวอย่าง endpoint สำหรับดูรายการคือ GET /enterprises/{enterprise}/copilot/billing/seats โดยรองรับการแบ่งหน้า และ total_seats นับผู้ใช้ที่ได้สิทธิ์จากหลายทีมเพียงครั้งเดียว ขณะที่ข้อมูลใน seats อาจมีหลายรายการตามเส้นทางที่มอบสิทธิ์ให้ผู้ใช้คนเดียวกัน หากระบบภายในรวมจำนวนจากความยาวของอาร์เรย์โดยตรง อาจรายงานจำนวนที่นั่งคลาดเคลื่อน ทีมพัฒนาควรใช้ค่ารวมตามความหมายที่เอกสารกำหนดและทดสอบกรณีผู้ใช้สังกัดหลายทีม

สำหรับการเพิ่มผู้ใช้ API ใช้ POST /enterprises/{enterprise}/copilot/billing/selected_users พร้อม selected_usernames ส่วนการเพิ่ม Enterprise team ใช้เส้นทาง selected_enterprise_teams การลบใช้วิธี DELETE ในเส้นทางเดียวกัน คำตอบของ API มีจำนวน seat ที่สร้างหรือรอยกเลิก ซึ่งเหมาะสำหรับบันทึกผลการทำงานและกระทบยอดกับรายการ seat รอบถัดไป ระบบอัตโนมัติควรเก็บบันทึกว่าใครหรือกระบวนการใดร้องขอการเปลี่ยนแปลง เวลาใด และ API ตอบอย่างไร โดยไม่บันทึก access token ลง log

จุดที่ผู้ดูแลต้องระวัง

การจัดสรร seat เป็นการเปลี่ยนแปลงที่มีผลต่อค่าใช้จ่าย เอกสาร GitHub ระบุว่าการเพิ่ม seat จะทำให้ Enterprise ถูกเรียกเก็บเงินตามเงื่อนไขบริการ อีกทั้ง endpoint บางรายการตอบ 422 เมื่อยังไม่เปิด Copilot หรือยังตั้งค่าการเรียกเก็บเงินและนโยบายที่จำเป็นไม่ครบ ดังนั้นก่อนเปิดใช้ automation ควรทดลองกับผู้ใช้กลุ่มเล็ก ตรวจสถานะ subscription และเตรียมวิธีจัดการผลลัพธ์ที่ไม่สำเร็จโดยไม่เรียกซ้ำแบบไม่จำกัด

การเพิ่มทีมต่างจากการเพิ่มชื่อผู้ใช้รายคน เพราะการเปลี่ยนสมาชิกทีมในอนาคตอาจเปลี่ยนกลุ่มผู้มีสิทธิ์ด้วย หาก Enterprise ใช้ทีมเป็นหน่วยจัดสรรหลัก ควรระบุเจ้าของทีมและกระบวนการรับสมาชิกให้ชัดเจน รวมทั้งตรวจว่าพนักงานที่ย้ายฝ่ายหรือออกจากองค์กรถูกถอดจากทีมตามเวลา ระบบที่ทำ reconciliation เป็นรอบควรอ่านสถานะปัจจุบันก่อนส่งคำสั่ง และตรวจผลหลังส่ง เพื่อไม่ให้ข้อมูลจากระบบบุคลากรกับ GitHub แยกจากกันโดยไม่มีผู้เห็น

GitHub ระบุในเอกสารว่า endpoint เหล่านี้ยังอยู่ใน public preview และอาจเปลี่ยนแปลงได้ ทีมพัฒนาจึงควรระบุเวอร์ชัน REST API ในคำขอ ติดตามเอกสารเมื่ออัปเดต และแยกส่วนเรียก API ออกจากตรรกะนโยบายภายใน เพื่อปรับการเชื่อมต่อได้เมื่อรูปแบบคำขอหรือคำตอบเปลี่ยน ข่าวครั้งนี้มีความหมายต่อองค์กรที่มี seat จำนวนมาก เพราะสามารถทำบัญชีสิทธิ์ อ่านจำนวนที่ถูกคิดเงิน และดำเนินการมอบหรือยกเลิกสิทธิ์ผ่าน GitHub App ที่กำหนดขอบเขตชัดเจนได้

แหล่งข่าว: GitHub Changelog ประกาศวันที่ 10 พฤศจิกายน 2026 https://github.blog/changelog/2026-11-10-github-app-support-for-enterprise-copilot-seat-management/ และเอกสาร REST API ทางการ https://docs.github.com/en/enterprise-cloud@latest/rest/copilot/copilot-user-management?apiVersion=2026-03-10