jsonscraper
الأسواق
العودة إلى المجلة

GitHub Event Streams ينبه الوكيل عند أحداث طلبات السحب بدلًا من الاستطلاع المتكرر

كيف يغيّر تدفق الأحداث التواصل بين GitHub والوكلاء المحليين، وما الأحداث المتاحة حاليًا في المعاينة

السياسة التحريرية الإبلاغ عن خطأ

كيف يعرف الوكيل أن تعليق مراجعة جديدًا ظهر في طلب سحب، من دون أن يستعلم من GitHub كل دقيقة أو يطلب من المستخدم تشغيل خادم عام؟ في 17 نوفمبر 2026، أطلقت GitHub ميزة Event Streams في مرحلة المعاينة: يشترك العميل في طلب سحب، ويبقي اتصاله بـ GitHub مفتوحًا، ويتلقى الأحداث فور وقوعها.

مقال: GitHub Event Streams ينبه الوكيل عند أحداث طلبات السحب بدلًا من الاستطلاع المتكرر
الملخص: في 17 نوفمبر 2026، أطلقت GitHub ميزة Event Streams في مرحلة المعاينة: يستطيع الوكيل تلقي أحداث طلبات السحب عبر اتصال دائم، من دون الاستعلام من GitHub وفق جدول زمني أو تشغيل خادم webhook عام.
دور الصورة: الغلاف — الفكرة المحورية
القسم: 
الموضوع المرئي: رسم تحريري يصور محطة عمل محلية لتطوير البرمجيات، متصلة عبر تدفق بيانات رفيع وواضح بطلبات سحب مجردة
ينقل تدفق الأحداث تحديث طلب السحب إلى الوكيل المحلي من دون خادم webhook عام.© jsonscraper · أُنشئت بالذكاء الاصطناعي

يتعلق التغيير العملي بالوكلاء المحليين وأنظمة الأتمتة التي تحتاج إلى الاستجابة لتحديثات المستودع. ومن دون مستقبل webhook خاص، تتمثل الطريقة المعتادة لمتابعة التغييرات في الاستعلام الدوري عن واجهة API: فالطلبات المتكررة تستهلك الحصة، بينما تؤخر الطلبات المتباعدة الاستجابة. ويتيح تدفق الأحداث تشغيل المعالجة استجابةً لإشارة تغيير بدلًا من التحقق وفق مؤقت.

الأحداث التي يتلقاها المشترك

تسرد وثائق Event Streams أحداث طلبات السحب، ومنها إرسال تعليق مراجعة، وإضافة إيداع جديد، وظهور تعارض دمج، ودمج الطلب أو إغلاقه، فضلًا عن تغيير مجموعة الفحوص أو اكتمال فحص منفرد. تُنقل الأحداث عبر Server-Sent Events (SSE)، ولا يحتاج العميل إلى نقطة نهاية webhook عامة. ويناسب ذلك، على سبيل المثال، وكيلًا يعمل على حاسوب المطور المحمول ويحتاج إلى الاستجابة لتعليق مراجعة أو إيداع جديد.

يعمل الحدث إشارةً إلى وقوع تغيير، ثم يحصل العميل على البيانات الحالية عبر GitHub REST API. فمثلًا، يشير إشعار تعليق المراجعة الجديد إلى مورد API المرتبط به؛ ويمكن عبره تحميل الحالة الحالية للتعليق أو طلب السحب قبل بدء الإجراء التالي.

الفرق بين تدفق الأحداث والاستطلاع وwebhook

الاستطلاع بسيط: يرسل العميل طلبات على فترات محددة ويقارن الردود. وتحدد الفترة موازنةً بين التأخير وتواتر الطلبات: فإذا كان التحقق مرة كل دقيقة، فقد تنتظر الاستجابة حتى الدورة التالية؛ أما التحقق بوتيرة أعلى فقد يجعل عددًا كبيرًا من الطلبات لا يرصد أي تغيير. وتذكر GitHub هذه المفاضلة تحديدًا سببًا لاستخدام النهج القائم على الأحداث.

مقال: GitHub Event Streams ينبه الوكيل عند أحداث طلبات السحب بدلًا من الاستطلاع المتكرر
الملخص: في 17 نوفمبر 2026، أطلقت GitHub ميزة Event Streams في مرحلة المعاينة: يستطيع الوكيل تلقي أحداث طلبات السحب عبر اتصال دائم، من دون الاستعلام من GitHub وفق جدول زمني أو تشغيل خادم webhook عام.
دور الصورة: رسم توضيحي داعم 2 — جانب محدد مختلف
القسم: الفرق بين تدفق الأحداث والاستطلاع وwebhook
الموضوع المرئي: رسم معلوماتي باللغة العربية يوضح ثلاث طرق لتلقي تحديثات طلبات السحب
يوضح الرسم اتجاه الاتصال وطريقة تسليم التحديثات عند استخدام الاستطلاع وwebhook وEvent Streams.© jsonscraper · رسم توضيحي مولّد بالذكاء الاصطناعي

مع Event Streams، ينشئ العميل اشتراكًا واحدًا في طلب السحب، ويتصل بـ GitHub، ثم ينتظر الأحداث عبر اتصال مفتوح. وينقل webhook الأحداث أيضًا، لكن عمليات التكامل تحتاج عادةً إلى نقطة نهاية استقبال متاحة للعامة. لذلك يناسب التدفق عميلًا تفاعليًا أو وكيلًا محليًا، بينما يناسب webhook خدمةً تستقبل الطلبات الواردة أصلًا. ويظل الاستطلاع خيارًا مفهومًا لعمليات التحقق المتباعدة التي لا تتطلب استجابة سريعة.

ومن النتائج العملية الأخرى إعداد الاشتراك لمورد بعينه. وتصف وثائق GitHub مسارًا للاشتراك في طلب سحب واحد، لا موجزًا عامًا بكل تحديثات المستودع. لذا صمّم المعالج حول طلب سحب محدد وأنواع الأحداث التي يحتاج إليها.

كيف يمكن أن يعمل وكيل محلي

لنتصور وكيلًا يساعد في مراجعة طلب سحب. فعند وقوع حدث تعليق مراجعة، يحصل الوكيل على البيانات الحالية ويمكنه إعداد تحليل للملاحظات؛ وبعد إيداع جديد، يعيد تشغيل الفحوص؛ وبعد الإغلاق أو الدمج، ينهي المهمة المرتبطة. هذا مثال على استخدام يستند إلى أنواع الأحداث التي تسردها GitHub، وليس نتيجة اختبار لهذا السيناريو نشرتها الشركة.

والتسلسل الدقيق مهم: فالحدث يفيد بوقوع تغيير، ثم يطلب العميل الحالة الراهنة من مورد API المحدد. ولأن الأحداث قد تتكرر أو تصل بترتيب غير متسلسل، يُستحسن أن يتحمل المعالج إعادة التسليم بأمان وأن يراجع الحالة عبر API، بدلًا من اعتبار ترتيب الإشعارات سجلًا كاملًا للتغييرات.

ترسل GitHub الحدث عبر اتصال مفتوح؛ ثم يحمّل العميل المحلي الحالة الحالية لطلب السحب ويشغّل المعالج المناسب.

قيود ينبغي أخذها في الحسبان

اعتبارًا من 18 نوفمبر 2026، تتوفر Event Streams في مرحلة المعاينة على جميع خطط GitHub بعد الموافقة على طلب الانضمام إلى قائمة الانتظار. ويُفعّل الوصول لحساب بعينه، لذا لا تظهر الميزة تلقائيًا لكل مستخدم. كما توضح الوثائق أن الميزة متاحة على GitHub.com، لكنها غير متاحة بعد على GHE.com.

يشمل الاشتراك طلب سحب واحدًا، وتنتهي صلاحيته بعد 24 ساعة من إنشائه. ولا يعيد التدفق تشغيل الأحداث التي وقعت قبل الاتصال، أو خلال فترة قصيرة بعد إنشاء الاشتراك، أو أثناء انقطاع الاتصال. وتوصي GitHub بجلب الحالة الحالية لطلب السحب مرة واحدة بعد الاشتراك، وبالاعتماد على بيانات API عند تكرار الأحداث أو وصولها بترتيب غير متسلسل. ويعني ذلك عمليًا أن الوكيل يحتاج إلى معالجة إعادة الاتصال ومزامنة الحالة، لا إلى اتصال مفتوح فحسب.

تتوفر في مرحلة المعاينة أحداث طلبات السحب؛ وتصف الوثائق المجموعة الحالية، كما تنبه إلى احتمال تغيّر API وأنواع الأحداث والحدود. إذا كانت الأتمتة تحتاج إلى أحداث أخرى للمستودع أو إلى تسليم مضمون من الخادم، فتحقق مما إذا كان التدفق يغطي احتياجاتها؛ وإلا فاستخدم webhook أو التحقق عبر API.

بالنسبة إلى وكيل محلي يحتاج إلى الاستجابة لأحداث طلبات السحب من دون خادم عام، توفر Event Streams قناة مباشرة قائمة على الأحداث بدلًا من الطلبات المتكررة. وثمن هذا الاختيار هو اشتراك مؤقت في طلب واحد، والحاجة إلى استعادة الحالة الحالية بعد تفويت أحداث. ويمكن الإبقاء على الاستطلاع لعمليات التحقق المتباعدة، بينما تُبنى عمليات التكامل الخادمية حول webhook إذا كانت تحتاج إلى تسليم البيانات إلى عنوانها الخاص.

الناس

لم يتم إدراج أي أشخاص لهذه المقالة حتى الآن.

استمر في القراءةربطت GitHub Copilot ببيئات سحابية مع حدّ مشترك لاستهلاك GitHub Actions
إقرأ المقال التالي

حوّل ما تقرأه إلى تكامل عملي

استكشف واجهات API للبيانات الاجتماعية من jsonscraper واختبر الطلبات وأنشئ سير عملك التالي.

استكشف واجهات API