أعلنت GitHub عن Copilot SDK for Java، وهي مكتبة عميلة تتيح لتطبيقات Java على الخوادم قيادة وكلاء Copilot برمجياً، من خلال إنشاء جلسات للوكلاء وتسجيل الأدوات وإرسال المطالبات واستقبال استجابات مهيكلة. وتقول GitHub إن المكتبة صُممت لتكون مستقلة عن أطر Java، كما توفر دعماً لخيار BYOK، ما يجعلها غير مرتبطة بمورّد واحد للذكاء الاصطناعي.
تستهدف المكتبة مطوري Java في تطبيقات المؤسسات، وتعمل في بيئات الخوادم بما فيها Jakarta EE وSpring. وتعتمد واجهات مألوفة لمطوري Java، مثل CompletableFuture والتعليقات التوضيحية واللامبدا والخيوط الافتراضية، بدلاً من فرض نهج مرتبط بإطار عمل محدد.
التوفر والمتطلبات
تتوفر المكتبة حالياً باعتبارها اعتماداً لـ Maven، بالإصدار 1.0.7-preview.1. ويتطلب استخدامها ما يلي:
- JDK 17 أو JDK 25، مع توصية باستخدام JDK 25 للاستفادة من الخيوط الافتراضية والميزات الحديثة الأخرى.
- Maven 3.9 أو إصدار أحدث.
- حساب GitHub مع اشتراك Copilot نشط.
- تثبيت Copilot CLI محلياً بالإصدار 1.0.71 أو إصدار أحدث.
ويعرض منشور GitHub تطبيقاً نموذجياً كاملاً مبنياً على Jakarta EE 11، مع توفير الشيفرة المصدرية للتجربة. كما تؤكد الشركة أن المطورين يستطيعون بناء وكلاء خاصين بهم باستخدام أطر ومكتبات Java التي يختارونها.
تطبيق نموذجي لإدارة طلبات العقارات
يستخدم المثال تطبيقاً لإدارة العملاء المحتملين في قطاع العقارات. فعندما يرسل العميل طلباً، مثل البحث عن منزل من ثلاث غرف نوم في لندن بسعر يقل عن 800 ألف جنيه إسترليني، ينشئ النظام وكيلاً معزولاً لـ Copilot على خيط افتراضي لمعالجة الطلب ضمن مسار عمل محدد.
ويستخدم التطبيق Jakarta WebSocket لإرسال تحديثات الحالة في الوقت الفعلي من الخادم إلى المتصفح، بما يتيح متابعة تقدم الوكلاء أثناء استدعائهم للأدوات. كما يمكن إرسال عدة طلبات في الوقت نفسه، بحيث تتم معالجة كل طلب باستقلالية ضمن جلسة Copilot الخاصة به.
تعريف الأدوات وإدارتها
تقدم المكتبة واجهة @CopilotTool لتعريف الأدوات التي يستطيع النموذج استدعاءها. ويحدد المطور الطريقة العادية في Java، بينما تتولى المكتبة إنشاء مخطط JSON وتحليل الوسائط وتوزيع الاستدعاء. ويمكن استخدام @CopilotToolParam لوصف كل وسيط كي يعرف النموذج القيمة المطلوبة منه.
واجهة التعليقات التوضيحية هذه تجريبية حالياً، ولذلك يجب تفعيل واجهات SDK التجريبية عبر خيار المترجم -Acopilot.experimental.allowed=true، إلى جانب تسجيل المكتبة ضمن مسار معالجات التعليقات التوضيحية في إعداد Maven. وتولّد المعالجة بيانات وصفية للأدوات أثناء عملية التجميع.
وإلى جانب التعليقات التوضيحية، يمكن تعريف الأدوات مباشرة في موضع الاستخدام عبر أسلوب اللامبدا باستخدام ToolDefinition.from(...). ويسمح ذلك بإنشاء أداة من دون طريقة مخصصة، كما يوفر الخيار overridesBuiltInTool(true) وسيلة لاستبدال أداة مدمجة بسلوك مخصص. ويمكن أيضاً وضع الأدوات في أصناف منفصلة عن منطق الوكيل، ثم تسجيلها من خلال ToolDefinition.fromObject.
الرسائل ودورة عمل الوكيل
يتيح SDK تخصيص رسالة النظام عبر SystemMessageMode.CUSTOMIZE، مع استبدال أقسام محددة والإبقاء على بقية الرسالة، بما في ذلك حواجز الأمان. كما يوفر وضع APPEND لإضافة محتوى إلى رسالة النظام الافتراضية دون استبدالها.
وتبدأ دورة العمل الكاملة للوكيل عبر sendAndWait(...). فعند إرسال المطالبة، يستطيع النموذج التفكير واستدعاء الأدوات المسجلة عدة مرات ثم إعادة النتيجة النهائية، بينما تتولى المكتبة تمرير نتائج الأدوات إلى النموذج حتى اكتمال المهمة. وتتيح الخيوط الافتراضية الانتظار عبر get() من دون استهلاك خيط تقليدي أثناء انتظار النتيجة. كما يوفر session.on(...) إمكانية التعامل مع الأحداث الصادرة عن الجلسة.