العودة إلى الفهرس / مخرجات الوكلاء
حفظ الملفات الكبيرة التي ينتجها الوكيل كعناصر ذات إصدارات
خزّن التقارير أو الرسوم أو الملفات كعناصر ثنائية مع إبقاء الاسم والإصدار فقط في سياق النموذج.
الهدف
تجنب إدراج الملفات الكبيرة مراراً في المطالبات مع دعم استرجاعها حسب الجلسة والإصدار.
الخطوات
- اختر مخزن العناصر وحدد عزل التطبيق والمستخدم والجلسة. [artifact]
- احفظ الجزء من الأداة باستخدام
await ctx.save_artifact(filename, part)بدلاً من إرجاع حمولة كبيرة كنص. [artifact] - أعد اسم الملف ورقمه؛ واستخدم
await ctx.load_artifact(filename, version=n)لجلب الإصدار عند الحاجة. [artifact] - حدّد قواعد الحجم والنوع والاحتفاظ والحذف لمنع التخزين غير المحدود. [artifact]
طريقة التحقق
بعد الحفظ، يظهر مرجع العنصر فقط في سياق النموذج؛ ويطابق المحتوى المسترجع الإصدار المحدد.
معالجة الأعطال
إذا اقتُطع المحتوى، فتحقق من نوع MIME وتنسيق الجزء؛ وإذا اختلف الإصدار، فمرّر رقم الإصدار وتحقق منه صراحةً.
الصلاحيات
المتطلبات السابقة
- Python 3.11+ وإصدار google-adk المتوافق مع المراجعة المثبتة وبيئة اختبار معزولة
- اضبط InMemoryArtifactService للاختبار أو خدمة عناصر دائمة
الصلاحيات
- استخدم بيانات اختبار مصرحاً بها فقط؛ واعزل الجلسات وبيانات الاعتماد لكل مستخدم؛ واحصل على موافقة بشرية قبل الآثار الخارجية
القيود
يتبع هذا الإجراء Google ADK عند المراجعة المثبتة؛ وقد تختلف الإصدارات أو النماذج أو الخدمات البعيدة في الواجهات ودلالات الأحداث. أعد التحقق من الصلاحيات والاحتفاظ والاستعادة قبل الإنتاج.
المصدر الأصلي المثبت
- المستودع
- google/adk-python
- مسار الملف
- docs/guides/artifacts/artifact_service/index.md
- الإيداع المثبت
e9b74d36140f2594b24c481fb7a3825b2cb01e96- تاريخ فحص المصدر
- 2026-10-14 · تمت المراجعة مقابل المصدر الأصلي المثبت
مقاييس المستودع
تعكس هذه القيم المستودع الأصلي كله، ولا تمثل إعجابات أو شعبية مهارة أو دليل منفرد.
- النجوم
- لم يُجمع
- التفرعات
- لم يُجمع
- وقت الرصد
- لم يُجمع
لا تتوفر لقطة مقاييس بعد.
الترخيص: Apache-2.0
الموضوع الرئيسي
حوّل مواد الحملة التجارية إلى موجز أسبوعي قابل للمراجعة