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

العودة إلى الفهرس / مخرجات الوكلاء

حفظ الملفات الكبيرة التي ينتجها الوكيل كعناصر ذات إصدارات

خزّن التقارير أو الرسوم أو الملفات كعناصر ثنائية مع إبقاء الاسم والإصدار فقط في سياق النموذج.

الهدف

تجنب إدراج الملفات الكبيرة مراراً في المطالبات مع دعم استرجاعها حسب الجلسة والإصدار.

الخطوات

  1. اختر مخزن العناصر وحدد عزل التطبيق والمستخدم والجلسة. [artifact]
  2. احفظ الجزء من الأداة باستخدام await ctx.save_artifact(filename, part) بدلاً من إرجاع حمولة كبيرة كنص. [artifact]
  3. أعد اسم الملف ورقمه؛ واستخدم await ctx.load_artifact(filename, version=n) لجلب الإصدار عند الحاجة. [artifact]
  4. حدّد قواعد الحجم والنوع والاحتفاظ والحذف لمنع التخزين غير المحدود. [artifact]

طريقة التحقق

بعد الحفظ، يظهر مرجع العنصر فقط في سياق النموذج؛ ويطابق المحتوى المسترجع الإصدار المحدد.

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

إذا اقتُطع المحتوى، فتحقق من نوع MIME وتنسيق الجزء؛ وإذا اختلف الإصدار، فمرّر رقم الإصدار وتحقق منه صراحةً.

الصلاحيات

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

الصلاحيات

القيود

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

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

https://github.com/google/adk-python/blob/e9b74d36140f2594b24c481fb7a3825b2cb01e96/docs/guides/artifacts/artifact_service/index.md

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

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

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

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

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

الترخيص: Apache-2.0

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

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

موارد ذات صلة