بقلم: ليلى | محررة أدوات المطورين · صوت تحريري بإشراف بشري
أتاح GitHub رسمياً Copilot SDK بوصفه إطار عمل جاهز للإنتاج، يمكّن المطورين من تضمين محرك الوكلاء نفسه الذي يشغّل Copilot CLI مباشرةً داخل تطبيقاتهم، دون الحاجة إلى بناء طبقة تنسيق من الصفر. الفكرة بسيطة لكن قيمتها عملية: أنت تحدد سلوك الوكيل، وCopilot يتولى التخطيط واستدعاء الأدوات وتعديل الملفات وما يتبعها.
يدعم الـ SDK ست لغات في إصداره الأول المتاح للعموم، مع تفاوت في مستوى التكامل بين كل منها. Node.js/TypeScript وPython و.NET تأتي مع CLI مُحزَّم تلقائياً لا يستلزم تثبيتاً منفصلاً، بينما تتطلب Go وJava وRust تثبيت CLI يدوياً أو التأكد من توافره في PATH — وإن كانت Go وRust تتيحان ميزة تحزيم CLI على مستوى التطبيق للتغلب على هذا القيد.
للبدء، إليك الخطوات الجوهرية:
- ثبّت الـ SDK الخاص بلغتك: بالنسبة لـ Node.js نفّذ
npm install @github/copilot-sdk، ولـ Python استخدمpip install github-copilot-sdk، ولـ Gogo get github.com/github/copilot-sdk/go، ولـ .NETdotnet add package GitHub.Copilot.SDK، ولـ Rustcargo add github-copilot-sdk، أما Java فتعتمد إحداثيات Maven:com.github:copilot-sdk-java. - تحقق من حالة CLI: إن كنت تعمل بـ Node.js أو Python أو .NET فلا إجراء إضافي — الـ CLI محزَّم. أما Go وJava وRust فثبّت CLI يدوياً أو اضبط متغير PATH قبل تشغيل الوكيل.
- اختر طريقة المصادقة المناسبة: يدعم الـ SDK أربعة أساليب — بيانات OAuth المخزّنة من
copilot cli login، أو رمز OAuth من تطبيق GitHub، أو متغيرات البيئةCOPILOT_GITHUB_TOKENأوGH_TOKENأوGITHUB_TOKEN، أو وضع BYOK باستخدام مفاتيح API خاصة بك دون مصادقة GitHub. - عرّف سلوك الوكيل وخصّص الأدوات: الـ SDK يكشف بالافتراضي أدوات Copilot CLI الأساسية مع صلاحية
--allow-all، لكن معالج الصلاحيات في كل SDK يمنحك التحكم الكامل في الموافقة على استدعاءات الأدوات ورفضها أو تعديلها. يمكنك كذلك تعريف وكلاء ومهارات وأدوات مخصصة بالكامل. - راجع توثيق اللغة التفصيلي: لكل SDK دليل Cookbook خاص يتضمن أمثلة استخدام عملية، ولـ Node.js وPython و.NET وGo وRust توجد تعليمات مخصصة لـ Copilot تُسرّع التطوير، بينما لم تُنشر تعليمات Rust المخصصة بعد.
من الناحية المعمارية، يتواصل كل SDK مع خادم Copilot CLI عبر JSON-RPC، والـ SDK يدير دورة حياة عملية CLI تلقائياً. يمكنك أيضاً الاتصال بخادم CLI خارجي إن احتجت إلى نشر موزّع أو بيئة مخصصة — وهو ما يُفصّله دليل Getting Started.
أما مسألة BYOK فتستحق وقفة: الـ SDK يدعم مزودين مثل OpenAI وAzure AI Foundry وAnthropic، لكنه يعتمد المصادقة بالمفتاح فقط — لا يدعم Microsoft Entra ID ولا الهويات المُدارة ولا موفري الهوية الخارجيين. قيد عملي يجب أخذه في الحسبان عند التخطيط لنشر مؤسسي.
من حيث الفوترة، يُحسب كل prompt ضمن حصة استخدامك المعتادة في Copilot CLI، وتتوفر خطة مجانية ذات استخدام محدود لمن لا يملك اشتراكاً مدفوعاً. النقطة الأبرز هنا ليست التقنية بل الموقع الاستراتيجي: GitHub يمنح المطورين محرك وكلاء مختبَراً في الإنتاج بدلاً من إعادة اختراع طبقة التنسيق، وهو رهان واضح على أن Copilot سيصبح بنية تحتية لتطبيقات الطرف الثالث لا مجرد أداة مساعدة للترميز. المجتمع بدأ يسير في هذا الاتجاه أيضاً، إذ ظهرت SDKs غير رسمية لـ Clojure وC++ خارج المسار الرسمي — إشارة إلى شهية واسعة قبل أن يكتمل النظام البيئي الرسمي.
