العودة إلى الفهرس / موثوقية الوكلاء
إيقاف تشغيل الوكيل عند إلغاء المستخدم أو انقطاع العميل
مرّر إشارة إلغاء العميل إلى Runner كي تتوقف الأدوات الطويلة أو عقد سير العمل ويغلق تدفق الأحداث بشكل سليم.
الهدف
أوقف الحساب عندما لا يعود المستخدم منتظراً لتقليل الهدر ومنع الآثار الجانبية اللاحقة.
الخطوات
- حدّد مصادر الإلغاء مثل زر الإيقاف أو مهلة الطلب أو إغلاق اتصال SSE. [abort]
- مرّر
asyncio.Event()كـabort_signalإلىrunner.run_async(..., abort_signal=signal)واستدعِsignal.set()عند إيقاف المستخدم. [abort] - افحص
ctx.is_abortedدورياً في الحلقات المتزامنة الطويلة؛ ويلغي SDK المهام الفرعية ويغلق استدعاءات الأدوات المعلقة وينهي التدفق بحدث إلغاء. [abort] - اختبر الإكمال الطبيعي وانقطاع العميل والإلغاء أثناء التشغيل وتحقق من سلامة سجل الجلسة. [abort]
طريقة التحقق
ينتهي التدفق بسلاسة بحدث `INVOCATION_ABORTED` عند عدم وجود استدعاء معلق، أو برد اصطناعي للاستدعاءات المفتوحة؛ وتبقى الجلسة قابلة للاستخدام.
معالجة الأعطال
إذا استمرت الأداة، فمرر الإلغاء إلى عمليات الإدخال والإخراج اللاحقة وأضف نقاط تحقق آمنة للإجراءات غير القابلة للإلغاء.
الصلاحيات
المتطلبات السابقة
- Python 3.11+ وإصدار google-adk المتوافق مع المراجعة المثبتة وبيئة اختبار معزولة
- بيانات اعتماد مزود النموذج للاستدلال الحي؛ لا تضعها في الشيفرة أو السجلات
الصلاحيات
- استخدم بيانات اختبار مصرحاً بها فقط؛ واعزل الجلسات وبيانات الاعتماد لكل مستخدم؛ واحصل على موافقة بشرية قبل الآثار الخارجية
القيود
يتبع هذا الإجراء Google ADK عند المراجعة المثبتة؛ وقد تختلف الإصدارات أو النماذج أو الخدمات البعيدة في الواجهات ودلالات الأحداث. أعد التحقق من الصلاحيات والاحتفاظ والاستعادة قبل الإنتاج.
المصدر الأصلي المثبت
- المستودع
- google/adk-python
- مسار الملف
- docs/guides/runners/runner/abort.md
- الإيداع المثبت
e9b74d36140f2594b24c481fb7a3825b2cb01e96- تاريخ فحص المصدر
- 2026-10-14 · تمت المراجعة مقابل المصدر الأصلي المثبت
مقاييس المستودع
تعكس هذه القيم المستودع الأصلي كله، ولا تمثل إعجابات أو شعبية مهارة أو دليل منفرد.
- النجوم
- لم يُجمع
- التفرعات
- لم يُجمع
- وقت الرصد
- لم يُجمع
لا تتوفر لقطة مقاييس بعد.
الترخيص: Apache-2.0
الموضوع الرئيسي
حوّل مواد الحملة التجارية إلى موجز أسبوعي قابل للمراجعة