عندما يرسل تطبيق الذكاء الاصطناعي تعليمات طويلة أو مستندات ثابتة مع كل سؤال، قد يعيد دفع تكلفة معالجة المحتوى نفسه. تعالج ميزة Prompt caching هذا النمط بإعادة استخدام مقدمة طلب سبق معالجتها. هذا شرح للتحضير لعام 2027 وفق توثيق Claude API المرصود في 27 أكتوبر 2026، وليس إعلان ميزة جديدة في ذلك العام.
ما الذي يحفظ مؤقتًا؟
المقصود مقدمة الطلب حتى نقطة محددة، لا الإجابة النهائية. يفحص النظام إن كانت هذه المقدمة موجودة في التخزين المؤقت، فيعيد استخدامها عند التطابق، وإلا يعالجها ويكتبها في الذاكرة المؤقتة. يظل السؤال الجديد بحاجة إلى المعالجة وتوليد إجابة تناسبه.
يظهر نفع هذا الأسلوب مع أمثلة ثابتة كثيرة، أو وثيقة طويلة تطرح عليها أسئلة متكررة، أو محادثات متعددة الأدوار. أما تكرار فكرة السؤال بصياغة مختلفة فلا يضمن تطابق المقدمة المخزنة.
طريقتان للتفعيل
- التخزين التلقائي: إضافة الحقل
cache_controlعلى مستوى الطلب، ليتولى النظام وضع نقطة التخزين على آخر جزء مؤهل وتحريكها مع نمو المحادثة. - نقاط صريحة: وضع الحقل على كتل المحتوى المطلوبة للتحكم في نهاية الجزء المراد إعادة استخدامه.
للحالة ذات المقدمة الثابتة والجزء المتغير، ضع الثابت أولًا والسؤال المتغير بعده. فإدخال توقيت يتغير في بداية كل طلب قد يمنع مشاركة المقدمة نفسها. ولا تغير محتوى ثابتًا أو ترتيبه بلا حاجة ثم تفترض استمرار إصابة التخزين المؤقت.
كم تبقى البيانات المؤقتة؟
المدة الافتراضية خمس دقائق، وتجدد عند إعادة استخدام المحتوى. وتقاس من بداية الطلب الذي يكتب المدخل أو يقرؤه، لا من انتهاء الإجابة. لذلك إذا استغرق توليد الإجابة أربع دقائق، لا تبقى خمس دقائق كاملة إضافية بعد وصولها.
يتاح أيضًا خيار ساعة بتكلفة كتابة أعلى. اختيار المدة الأطول ليس توفيرًا تلقائيًا؛ يرتبط بفواصل الاستخدام وعدد مرات إعادة القراءة، وبالنموذج والمنصة وتسعيرهما.
كيف تتأكد أن الميزة تعمل؟
راجع حقلي الاستخدام cache_creation_input_tokens وcache_read_input_tokens في الاستجابة على Claude API. إذا كان كلاهما صفرًا، لم يحدث تخزين مؤقت أو قراءة منه. ومن الأسباب المحتملة عدم بلوغ الحد الأدنى لطول المقدمة، وهو يختلف باختلاف النموذج والمنصة؛ فلا تفترض أن كل طلب قصير سيستفيد من إضافة الحقل.
كما لا تصبح المقدمة متاحة للطلبات المتزامنة إلا بعد بدء الاستجابة الأولى. وعند قياس الجدوى، افصل تكلفة الكتابة الأولى عن القراءات اللاحقة، وقارن الطلبات الفعلية بدل وصف الميزة بأنها تخفض كل فاتورة بنسبة واحدة ثابتة.
