العودة إلى الفهرس / حالة الوكلاء
عزل حالة الوكيل حسب المستخدم والتطبيق والاستدعاء
استخدم نطاقات حالة صريحة للتحكم في القيم المشتركة عبر الجلسات والقيم الخاصة بالاستدعاء.
الهدف
امنع تسرب البيانات المؤقتة إلى جلسات لاحقة واجعل تفضيلات المستخدم ضمن نطاقه فقط.
الخطوات
- أدرج حقول الحالة ومدة حياتها: التطبيق أو المستخدم أو الجلسة أو مؤقتة. [state]
- استخدم البادئات
app:أوuser:أوtemp:أو مفتاحاً على مستوى الجلسة حسب مدة الحياة؛ واستبعد بيانات الاعتماد والبيانات الشخصية غير اللازمة. [state] - اقرأ واكتب عبر Context أو ToolContext وتأكد من استمرار التحديثات اللازمة عبر أحداث الجلسة. [state]
- اختبر مستخدمين وجلسات متعددة لعزل المستخدم ووراثة الجلسة وتنظيف الحقول المؤقتة. [state]
طريقة التحقق
افحص تغييرات الحالة والجلسات النهائية؛ يجب أن يظهر كل حقل ضمن مدة حياته المقصودة فقط.
معالجة الأعطال
إذا لم تُحفظ قيمة، فتحقق من إضافة الحدث إلى خدمة الجلسات؛ وإذا اختلطت، فأصلح النطاقات وربط المستخدم.
الصلاحيات
المتطلبات السابقة
- Python 3.11+ وإصدار google-adk المتوافق مع المراجعة المثبتة وبيئة اختبار معزولة
- خدمة SessionService مضبوطة؛ ويتطلب الاسترجاع بين الجلسات MemoryService أيضاً
الصلاحيات
- استخدم بيانات اختبار مصرحاً بها فقط؛ واعزل الجلسات وبيانات الاعتماد لكل مستخدم؛ واحصل على موافقة بشرية قبل الآثار الخارجية
القيود
يتبع هذا الإجراء Google ADK عند المراجعة المثبتة؛ وقد تختلف الإصدارات أو النماذج أو الخدمات البعيدة في الواجهات ودلالات الأحداث. أعد التحقق من الصلاحيات والاحتفاظ والاستعادة قبل الإنتاج.
المصدر الأصلي المثبت
- المستودع
- google/adk-python
- مسار الملف
- docs/guides/sessions/state/index.md
- الإيداع المثبت
e9b74d36140f2594b24c481fb7a3825b2cb01e96- تاريخ فحص المصدر
- 2026-10-14 · تمت المراجعة مقابل المصدر الأصلي المثبت
مقاييس المستودع
تعكس هذه القيم المستودع الأصلي كله، ولا تمثل إعجابات أو شعبية مهارة أو دليل منفرد.
- النجوم
- لم يُجمع
- التفرعات
- لم يُجمع
- وقت الرصد
- لم يُجمع
لا تتوفر لقطة مقاييس بعد.
الترخيص: Apache-2.0
الموضوع الرئيسي
حوّل مواد الحملة التجارية إلى موجز أسبوعي قابل للمراجعة