دليل الدخل بالوكلاءموارد عامة مجانية
中文 EN العربية

العودة إلى الفهرس / موثوقية الوكلاء

إيقاف تشغيل الوكيل عند إلغاء المستخدم أو انقطاع العميل

مرّر إشارة إلغاء العميل إلى Runner كي تتوقف الأدوات الطويلة أو عقد سير العمل ويغلق تدفق الأحداث بشكل سليم.

الهدف

أوقف الحساب عندما لا يعود المستخدم منتظراً لتقليل الهدر ومنع الآثار الجانبية اللاحقة.

الخطوات

  1. حدّد مصادر الإلغاء مثل زر الإيقاف أو مهلة الطلب أو إغلاق اتصال SSE. [abort]
  2. مرّر asyncio.Event() كـ abort_signal إلى runner.run_async(..., abort_signal=signal) واستدعِ signal.set() عند إيقاف المستخدم. [abort]
  3. افحص ctx.is_aborted دورياً في الحلقات المتزامنة الطويلة؛ ويلغي SDK المهام الفرعية ويغلق استدعاءات الأدوات المعلقة وينهي التدفق بحدث إلغاء. [abort]
  4. اختبر الإكمال الطبيعي وانقطاع العميل والإلغاء أثناء التشغيل وتحقق من سلامة سجل الجلسة. [abort]

طريقة التحقق

ينتهي التدفق بسلاسة بحدث `INVOCATION_ABORTED` عند عدم وجود استدعاء معلق، أو برد اصطناعي للاستدعاءات المفتوحة؛ وتبقى الجلسة قابلة للاستخدام.

معالجة الأعطال

إذا استمرت الأداة، فمرر الإلغاء إلى عمليات الإدخال والإخراج اللاحقة وأضف نقاط تحقق آمنة للإجراءات غير القابلة للإلغاء.

الصلاحيات

المتطلبات السابقة

الصلاحيات

القيود

يتبع هذا الإجراء Google ADK عند المراجعة المثبتة؛ وقد تختلف الإصدارات أو النماذج أو الخدمات البعيدة في الواجهات ودلالات الأحداث. أعد التحقق من الصلاحيات والاحتفاظ والاستعادة قبل الإنتاج.

المصدر الأصلي المثبت

https://github.com/google/adk-python/blob/e9b74d36140f2594b24c481fb7a3825b2cb01e96/docs/guides/runners/runner/abort.md

المستودع
google/adk-python
مسار الملف
docs/guides/runners/runner/abort.md
الإيداع المثبت
e9b74d36140f2594b24c481fb7a3825b2cb01e96
تاريخ فحص المصدر
2026-10-14 · تمت المراجعة مقابل المصدر الأصلي المثبت

مقاييس المستودع

تعكس هذه القيم المستودع الأصلي كله، ولا تمثل إعجابات أو شعبية مهارة أو دليل منفرد.

النجوم
لم يُجمع
التفرعات
لم يُجمع
وقت الرصد
لم يُجمع

لا تتوفر لقطة مقاييس بعد.

الترخيص: Apache-2.0

الموضوع الرئيسي

حوّل مواد الحملة التجارية إلى موجز أسبوعي قابل للمراجعة

موارد ذات صلة