شرح التخزين المؤقت للمطالبات: قياس التوفير على GetVibe

غالبًا ما تعيد وكلاء البرمجة والمساعدات متعددة الأدوار إرسال مطالبة النظام نفسها، وتعريفات الأدوات نفسها، وبادئة المحادثة نفسها. يمكن للتخزين المؤقت أن يجعل رموز الإدخال المتكررة هذه أقل تكلفة، ولكن فقط عندما يدعمها النموذج ونقطة النهاية وبنية الطلب. وهو لا يخصم من تكلفة المخرجات المُنشأة، كما أن تكرار نص مشابه لا يكفي إذا تغيّر مفتاح التخزين المؤقت. يفصل هذا الدليل بين المسار التلقائي المتوافق مع OpenAI وسلوك نقاط التوقف الصريحة في Claude.

ما الذي يتغير في الفاتورة؟

تُحتسب قراءة البيانات المخزنة مؤقتًا وفق سعر الإدخال المخزن مؤقتًا بدلًا من سعر الإدخال العادي. ينشر كتالوج نماذج GetVibe دعم التخزين المؤقت وأسعاره إلى جانب أسعار النماذج. في لقطة الكتالوج التي تم التحقق منها في 3 أكتوبر 2026، تشمل الأمثلة $0.0055 الإدخال · $0.0274 الإخراج لكل مليون رمز لـ GPT-6 Luna و$0.168 الإدخال · $0.84 الإخراج لكل مليون رمز لـ Claude Sonnet 5.5. تُعرض قيم الأسعار هذه من صفحات النماذج المباشرة. راجع تفاصيل التخزين المؤقت هناك أيضًا؛ ولا تفترض أن كل نموذج يستخدم المعامل نفسه أو سياسة الكتابة نفسها.

التقدير البسيط لبادئة متكررة هو: عدد رموز الإدخال المتكررة مضروبًا في سعر الإدخال العادي، مقارنةً بعدد رموز الإدخال المتكررة مضروبًا في سعر القراءة من التخزين المؤقت. الفرق هو مقدار التوفير المحتمل في الإدخال. اطرح أي تكلفة كتابة للتخزين المؤقت إذا كان النموذج يفرضها. يلزم استخدام الطلب الفعلي الذي ترصده لتحويل هذا التقدير إلى نتيجة مقاسة.

النماذج المتوافقة مع OpenAI: حافظ على ثبات البادئة

بالنسبة إلى المسارات المدعومة من عائلة OpenAI، يكون التخزين المؤقت تلقائيًا. لا يوجد حقل للتحكم في التخزين المؤقت ينبغي إضافته في طلب Chat Completions عادي. يجب أن تظل البداية المتكررة كما هي. ضع تعليمات النظام والأمثلة الثابتة وتعريفات الأدوات قبل القيم الخاصة بالمستخدم. تجنب وضع الطوابع الزمنية أو المعرّفات العشوائية أو أعلام الميزات الخاصة بكل طلب في البداية. حافظ على ترتيب الأدوات حتميًا.

لا تعِد كتابة أدوار المحادثة السابقة عند متابعة جلسة وكيل إذا كنت تتوقع مطابقة البادئة نفسها. أضف الأدوار الجديدة. يؤدي تبديل النماذج إلى بدء ذاكرة تخزين مؤقت مختلفة للنموذج. قد يكون الطلب صالحًا ومع ذلك يُبلغ عن عدم وجود رموز مخزنة مؤقتًا لأن البادئة أقل من الحد الأدنى للتخزين المؤقت للنموذج أو لأن التخزين المؤقت انتهت صلاحيته.

Claude: نقاط التوقف ونقطة نهاية Messages

يستخدم التخزين المؤقت في Claude نقاط توقف للتحكم في التخزين المؤقت. يمكن لتكامل GetVibe إدراج نقطة توقف عند عدم وجودها في طلبات Claude المدعومة؛ وإذا كنت تدير نقاط التوقف بنفسك، فتحقق من وثائق التخزين المؤقت الحالية وحافظ على وجود العلامة في قسم ثابت. يستخدم Claude Code نقطة نهاية Anthropic Messages؛ ويغطي دليل تكامل Claude Code عنوان URL الأساسي وبيانات الاعتماد الخاصة به.

curl https://getvibeapi.com/v1/messages \
  -H "x-api-key: $GETVIBE_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-5.5",
    "max_tokens": 300,
    "system": [{"type":"text","text":"Stable instructions shared by every request."}],
    "messages": [{"role":"user","content":"A request-specific question."}]
  }'

يوضح هذا المثال قسم نظام ثابتًا ورسالة مستخدم متغيرة. استخدم الوثائق الحالية لمعرفة حقل نقطة التوقف الدقيق الذي يدعمه عميلك ونموذجك.

تحقق من إصابة التخزين المؤقت بدلًا من افتراضها

أرسل البادئة الطويلة نفسها مرتين، مع تغيير لاحقة قصيرة فقط. افحص استخدام الاستجابة. تُبلغ الاستجابات ذات البنية المتوافقة مع OpenAI عن الإدخال المخزن مؤقتًا ضمن prompt_tokens_details.cached_tokens؛ بينما تكشف الاستجابات ذات البنية المتوافقة مع Anthropic عن حقول قراءة التخزين المؤقت وإنشائه. ويمكن لصفحة استخدام الحساب أن تعرض معلومات التخزين المؤقت أيضًا. إذا ظلت هذه الأعداد صفرًا، فتحقق من تطابق البادئة، والحد الأدنى للطول القابل للتخزين المؤقت، ودعم النموذج، وما إذا كنت قد غيّرت المسار المحدد.

استخدم عينة كبيرة بما يكفي لتتجاوز الحد الأدنى للتخزين المؤقت للنموذج. قد لا تُحدث مطالبة نظام من جملة واحدة فرقًا ظاهرًا. قارن عدة استدعاءات متكررة، لأن مدة بقاء التخزين المؤقت وجدولة الطلبات تؤثران في استمرار سخونة البادئة.

اختبار عملي للتوفير

1. اختر مطالبة حقيقية ذات بادئة قابلة لإعادة الاستخدام بحجم كبير.
2. سجّل استخدام الإدخال العادي وأسعار النموذج الحالية في صفحة النموذج.
3. كرّرها مع تغيير لاحقة المستخدم فقط.
4. تأكد من أن الاستجابة تُبلغ عن إدخال مخزن مؤقتًا.
5. قارن تكلفة دفتر الحسابات للطلبات المتكررة.

حافظ على تشابه طول المخرجات أثناء التجربة حتى لا تحجب تكلفة المخرجات تغير تكلفة الإدخال. لا تدّعِ تحقيق التوفير اعتمادًا على معامل التخزين المؤقت وحده؛ تحقّق من عدد مرات إصابة التخزين المؤقت والاستخدام المفوتر.

أسباب شائعة لفشل التخزين المؤقت

• ظهور طابع زمني أو معرّف طلب قبل التعليمات الثابتة.
• تسلسل تعريفات الأدوات بترتيب مختلف في كل طلب.
• تغيير التطبيق للمسافات البيضاء أو اقتطاع السجل بطريقة مختلفة.
• تغيير النموذج بين الأدوار.
• قِصر البادئة أكثر من اللازم أو انتهاء مدة نافذة التخزين المؤقت.

عندما يعمل التخزين المؤقت، يمكنه جعل محادثات الوكلاء الطويلة أكثر اقتصادية، لكنه ليس سببًا لإرسال سياق مستودع غير ضروري. حافظ على تركيز المطالبات وقيّم التكلفة الإجمالية للمهمة. لمزيد من تفاصيل نقاط النهاية، اقرأ دليل تنفيذ التخزين المؤقت وصفحة السعر المباشر للنموذج.