العودة إلى الفهرس / سلامة الوكلاء
التحقق من عدم العبث باستدعاءات الأدوات المحفوظة قبل استئناف الوكيل
عندما سينفذ استدعاء أداة متوقف عند الاستئناف، تحقق من سلامة معاملاته المحفوظة وامنع الاستدعاء المعدل.
الهدف
احمِ استدعاءات الأدوات المؤكدة أو القابلة للاستئناف من تغيير معاملاتها في مخزن جلسات معدل.
الخطوات
- أدرج الاستدعاءات المؤجلة للتأكيد أو التفويض أو الاستئناف وقيّم صلاحية الكتابة إلى مخزن الجلسات. [integrity]
- سجّل
ToolCallIntegrityPlugin(secret_key=load_key())فيApp(plugins=[...])وحمّل مفتاحاً عشوائياً بطول 32 بايت على الأقل من مدير أسرار. [integrity] - قيّد مصدر المفتاح وصلاحية تدويره ولا تضع مفتاح السلامة في مكان يمكن لمحرري الجلسات قراءته. [integrity]
- في اختبار معزول، غيّر معاملات استدعاء محفوظ وتأكد من فشل التحقق قبل تشغيل المعالج. [integrity]
طريقة التحقق
تُرفض الاستدعاءات المعدلة قبل الآثار الجانبية؛ وتستأنف الاستدعاءات السليمة ولا يظهر المفتاح في السجلات.
معالجة الأعطال
قد لا تغطي الإضافة الأدوات المستخدمة مباشرة كعقد سير عمل؛ أضف حماية على مستوى العقدة وفق هذا القيد الموثق.
الصلاحيات
المتطلبات السابقة
- Python 3.11+ وإصدار google-adk المتوافق مع المراجعة المثبتة وبيئة اختبار معزولة
- بيانات اعتماد مزود النموذج للاستدلال الحي؛ لا تضعها في الشيفرة أو السجلات
الصلاحيات
- استخدم بيانات اختبار مصرحاً بها فقط؛ واعزل الجلسات وبيانات الاعتماد لكل مستخدم؛ واحصل على موافقة بشرية قبل الآثار الخارجية
القيود
يتبع هذا الإجراء Google ADK عند المراجعة المثبتة؛ وقد تختلف الإصدارات أو النماذج أو الخدمات البعيدة في الواجهات ودلالات الأحداث. أعد التحقق من الصلاحيات والاحتفاظ والاستعادة قبل الإنتاج.
المصدر الأصلي المثبت
- المستودع
- google/adk-python
- مسار الملف
- docs/guides/plugins/tool_call_integrity_plugin/index.md
- الإيداع المثبت
e9b74d36140f2594b24c481fb7a3825b2cb01e96- تاريخ فحص المصدر
- 2026-10-14 · تمت المراجعة مقابل المصدر الأصلي المثبت
مقاييس المستودع
تعكس هذه القيم المستودع الأصلي كله، ولا تمثل إعجابات أو شعبية مهارة أو دليل منفرد.
- النجوم
- لم يُجمع
- التفرعات
- لم يُجمع
- وقت الرصد
- لم يُجمع
لا تتوفر لقطة مقاييس بعد.
الترخيص: Apache-2.0
الموضوع الرئيسي
اجعل سلوك الوكيل أكثر أماناً وأسهل للتحقق