اكتشف كيف بنى فريق GitHub بروتوكول مضيف الوكيل المفتوح للحفاظ على جلسات وكيلك متاحة عبر المحررات والتطبيقات والهواتف والسحابة.
أصبحت النماذج الآن جيدة بما يكفي للعمل لساعات أو حتى أيام بمفردها. لا يتعين عليك مراقبة كل ما تفعله، ولكن لا يزال يتعين عليك أن تكون قادرًا على التحقق منها، بغض النظر عن مكان وجودك. لا يمكن للوكيل أن يعيش داخل تطبيق واحد فقط. يجب أن يستمر العمل حتى إذا أغلقت نافذة أو بدلت الأجهزة.
في GitHub Copilot، يمكنك بدء جلسة وكيل في مكان واحد واستئنافها في مكان آخر. تعتمد استمرارية الجلسة هذه على بروتوكول مضيف الوكيل (AHP)، وهو معيار مفتوح تم بناؤه أولاً في VS Code وتم اعتماده عبر GitHub. إليك كيفية عمله، وما تعلمه فريق GitHub من بنائه، وكيف يمكنك استخدامه لإحضار وكلائك إلى تطبيقاتك وسير عملك الخاصة.
لماذا توقف التكامل الواحد لكل عميل عن العمل؟
تم بناء GitHub Copilot لأول مرة في VS Code كامتداد يضم حزمة خاصة به. وقد أتاح لك ذلك الوصول إلى وكلائك في VS Code، لكنه ربط عمرهم بالمحرر. ترتبط الامتدادات بنافذة VS Code واحدة. أغلق تلك النافذة، ويختفي الوكيل. قم بتحديث VS Code، وتتوقف جميع الوكلاء مع إعادة تشغيل التطبيق. اتصل بجهاز بعيد، وستحصل على مضيف امتداد جديد تمامًا مرتبط بإصدار بيئة عمل VS Code لديك.
في الوقت نفسه، كان يجري تطوير تطبيق Copilot، إلى جانب تطبيقات GitHub المحمولة الحالية لنظامي iOS وAndroid. كان كل منتج يقوم بتكامله المميز مع الوكلاء المستندين إلى السحابة للعمل نحو توفير استمرارية الجلسة.
حل كل من هذه التكاملات المشكلة لمنتج واحد، لكن المطورين ما زالوا يرغبون في أن يكونوا قادرين على سحب وكلائهم إلى سير عملهم الخاص – سواء كان ذلك محررًا، أو طرفية، أو هاتفًا، أو أداة قاموا ببنائها بأنفسهم – ولا يمكنهم فعل ذلك إذا كان كل عميل يحتاج إلى تكامل خاص به لمرة واحدة. لهذا السبب احتاج المطورون إلى بروتوكول: لغة قياسية ذات إصدارات مستقلة عبر إصدارات VS Code، وتطبيق GitHub Copilot، وتطبيقات الهاتف المحمول، وأي عميل آخر قد يستضيف وكيلًا.
كيف يحل البروتوكول مشكلة التكاملات المتعددة؟
تصميم بروتوكول للوكلاء على كل عميل
كان على البروتوكول أن يسمح لعدة عملاء بالتفاعل مع نفس مجموعة الوكلاء بسلاسة. ابدأ جلسة في السحابة من هاتفك، على سبيل المثال، ثم تابعها من جهاز الكمبيوتر المحمول الخاص بك. يجب أن يتحمل انقطاعات الشبكة، وإعادة الاتصال، والتعديلات المتزامنة للعميل. وكان يجب أن يكون غنيًا بالميزات بما يكفي لتتمكن من القيام بعمل حقيقي من كل من عملائك.
في الوقت نفسه، كان على البروتوكول أن يبقى بعيدًا عن سلوك الوكيل. على عكس المجالات التي أنتجت بروتوكول خادم اللغة (Language Server Protocol) وبروتوكول محول التصحيح (Debug Adapter Protocol)، يتطور عالم الوكلاء بسرعة. لهذا السبب يتجنب AHP ترميز كيفية عمل الوكلاء، وبدلاً من ذلك يركز على كيفية تفاعلك معهم.
تحتاج أيضًا إلى أن يكون البروتوكول بسيطًا بما يكفي لتطبيقه على عميلك أو خادمك الخاص. بينما ستكون مجموعة الميزات الكاملة واسعة بالضرورة، كان يجب أن يكون البروتوكول الأساسي بسيطًا.
كانت نتيجة هذه المتطلبات هي بروتوكول مضيف الوكيل (AHP). يجب على كل خادم تنفيذ قنوات الجذر والجلسة والدردشة، ولكن يمكنه أيضًا تنفيذ المزيد من القنوات التي توفر دعم الطرفية، أو إضافات MCP، أو تقارير OTel، على سبيل المثال.
الخادم هو الحكم في الحالة، ويرسل كل عميل تسلسلًا من الإجراءات التي إما تعدل الحالة أو تؤدي إلى آثار جانبية، مثل إرسال رسالة دردشة. يوفر هذا بعض الخصائص الجيدة جدًا. العملاء والخوادم سهلة التصحيح. وتعمل الحالة القائمة على المخفضات أيضًا بشكل جيد مع أطر عمل واجهة المستخدم الشائعة مثل React.
ما هي المكونات الأساسية لبروتوكول مضيف الوكيل؟
شحن خمسة عملاء ومضيفين اثنين
تطلب اعتماد بروتوكول مضيف الوكيل في VS Code بناء حزمة جديدة ومكدس وكلاء تحته. امتداد Copilot Chat، الذي كان يوفر جميع إمكانيات الذكاء الاصطناعي والوكلاء في VS Code، كان ينمو لأكثر من ثلاث سنوات، ووصل إلى أكثر من 400,000 سطر من TypeScript، دون احتساب الاختبارات. ولكن، كامتداد لـ VS Code، كان منظمًا حول دورة حياة نافذة VS Code ويعتمد كليًا على واجهة برمجة تطبيقات امتداد VS Code. لن يكون هذا العمر ولا تلك الواجهات البرمجية متاحة في عملية مضيف وكيل مستقلة.
عندما بدأ فريق GitHub في بناء بروتوكول مضيف الوكيل في أوائل عام 2026، كان يجري أيضًا تطوير Copilot SDK، وكان من المنطقي الاستفادة منه كأساس لمكدس الوكلاء الجديد. كان هذا انتقالًا كبيرًا.
لدى GitHub وكلاء سحابيون لـ Copilot منذ عامين، مما يسمح للمطورين بتشغيل المهام في السحابة من أي جهاز. بينما كانت VS Code تطور بروتوكول مضيف الوكيل بهدوء، كانت GitHub تتطلع إلى توسيع هذه القدرة لتنسيق الجلسات التي تعمل على أجهزتك الخاصة عبر تطبيق Copilot، أو في بيئات اختبار سحابية. كانت هذه بالضبط مشكلة N:M التي بني AHP لحلها، لذا كان اعتماد نفس التكنولوجيا منطقيًا تمامًا.
منذ البداية، كان لمضيف وكيل GitHub متطلبات مختلفة عن تطبيق VS Code. يشغل VS Code المضيف محليًا ويمكنه إسقاط مضيفه على أجهزة حوسبة أخرى عبر SSH، أو الحاويات، أو WSL، أو Dev Tunnels، وهو في الواقع مدرج كجزء من حزمة VS Code Server. كان مضيف وكيل GitHub بحاجة إلى العمل في السحابة وعبر مجموعة أوسع بكثير من البنى التحتية، والبيئات، وقيود الأمان.
هذه المتطلبات المختلفة هي سبب كونها تطبيقات منفصلة مكتوبة بلغات مختلفة: VS Code في TypeScript وGitHub في Rust. في الوقت الحالي، كان وجود مضيفين للوكلاء بمثابة اختبار حقيقي للبروتوكول نفسه. ما مدى جودته عندما يقوم فريقان مختلفان تمامًا ومجموعتان من الوكلاء بتطبيق نفس البروتوكول بشكل مستقل؟
جيد جدًا، كما اتضح. مثل MCP، يوفر بروتوكول مضيف الوكيل مخارج هروب عبر طرق مخصصة و_metadata على الكائنات التي يمكن للمستهلكين استخدامها للإشارة خارج النطاق. بعد عدة أشهر من العمل المكثف على تطبيقات GitHub الخاصة، كانت مهمة الفريق الأولى بينما كان يعمل نحو التوحيد هي جرد الطرق التي وسع بها كل تطبيق البروتوكول. العديد من هذه الامتدادات تظل خاصة بـ GitHub بشكل معقول، مثل استخدام مضيف وكيل GitHub للبيانات الوصفية للربط بلوحات المشاريع. في حالات أخرى، كان التباين علامة على وجود فجوة في البروتوكول؛ الإصدارات المبكرة، على سبيل المثال، لم تتمكن من تمثيل مخرجات أداة من نوع shell بدقة لم تكن مدعومة بواسطة PTY. وبعضها كان افتراضات سيئة، مثل افتراض عميل VS Code لهيكل معين لمعرفات URI للجلسة التي تلقاها من مضيف الوكيل. البروتوكول الذي يحتوي على تطبيق واحد فقط ليس قابلاً للنقل حقًا؛ بينما علّم فريق GitHub عملاءه وخوادمه التحدث مع بعضهم البعض، أصبح AHP قابلاً للنقل عمليًا، وليس نظريًا فقط.
اليوم، يوفر بروتوكول مضيف الوكيل نفس الاستمرارية عبر جميع واجهات VS Code وGitHub. تتشارك جلسات الوكلاء التي تعمل محليًا في تطبيق GitHub Copilot، وفي بيئات الاختبار السحابية، وفي VS Code نفس البروتوكول الأساسي. لمعرفة كيفية استخدامه، اقرأ عن كيفية العمل من أي مكان باستخدام تجربة Copilot السحابية المتصلة الجديدة.
استخدام بروتوكول مضيف الوكيل
تم تصميم AHP ليكون سهل الاستخدام في العملاء والخوادم. تتوفر مكتبات بروتوكول مضيف الوكيل في Rust وTypeScript وKotlin وSwift و.NET وGo، ويمكن للوكلاء بناء عملاء وخوادم بقليل من التوجيه. لدى كاتب المقال لوحة مفاتيح صغيرة على مكتبه تعكس حالة وكيله في الوقت الفعلي، وقد بنى آخرون كل شيء من تطبيقات الساعات الذكية إلى أدوات إدارة المهام على غرار Kanban ضد البروتوكول. سواء كنت تريد تطبيقًا مصاحبًا لوكلائك الخاصين، أو طريقة لإحضار جلسات الوكلاء إلى أدوات فريقك، أو دعم AHP في محرر أو وكيل خاص بك، فإن البروتوكول مفتوح لك للبناء عليه.
يمكنك الاتصال بمضيف وكيل تقوم بتطبيقه في تطبيق Copilot (قم بتمكين Experimental > Direct Connections، ثم انتقل إلى Environments > Add Agent Host Protocol Host) وفي VS Code (عبر Add Remote Agent Host في نافذة Agents). يمكنك تشغيل إصدار مستقل من مضيف وكيل VS Code عن طريق تشغيل code agent host في الطرفية الخاصة بك، أو رؤية نقاط النهاية للذي في محرر الخاص بك عن طريق تشغيل code agent endpoints، ويمكن أن تساعدك العينات أنت ووكيلك على البدء.
بروتوكول مضيف الوكيل هو معيار مفتوح، والأسئلة والاقتراحات مرحب بها على GitHub.
ترميز سعيد!
جرّب الأداة: منسق ومتحقق JSON




