● رسمي
anthropics
⚡ فوري
Anthropic Cookbook
بواسطة anthropics · anthropics/anthropic-cookbook
كتاب وصفات Anthropic الرسمي لـ Claude — التخزين المؤقت للـ prompt والمعالجة الدفعية وRAG والوكلاء والوسائط المتعددة والاقتباسات — مع دفاتر ملاحظات قابلة للتشغيل.
anthropics/anthropic-cookbook هو مجموعة الوصفات الرسمية لـ Claude API. كل وصفة دفتر ملاحظات مُركَّز: التخزين المؤقت للـ prompt ومعالجة الرسائل الدفعية وحلقات الوكلاء وRAG مع الاقتباسات ورؤية الوسائط المتعددة والتصنيف والتقييم. استخدمه كمورد مهارة حتى يستند Claude في اقتراحات التنفيذ إلى أمثلة مُختبَرة.
لماذا تستخدمه
الميزات الأساسية
- وصفات التخزين المؤقت للـ prompt (أنماط توفير tokens)
- معالجة الرسائل الدفعية للوظائف غير المتزامنة
- قوالب حلقة الوكلاء
- RAG مع الاقتباسات
- أمثلة رؤية الوسائط المتعددة
- أُطر التقييم
عرض مباشر
كيف يبدو في الممارسة
جاهز
حالات الاستخدام
استخدامات عملية: Anthropic Cookbook
متى تستخدمه: الإنفاق على API يرتفع ولديك سياق متكرر في كل طلب.
الخطوات
-
قراءة الوصفة
Use anthropic-cookbook. Show me the prompt caching pattern for repeated system prompts.✓ تم النسخ
→ مثال cache_control
-
التطبيق على كودي
Adapt to my service that re-sends a 5k-token style guide every call.✓ تم النسخ
→ system prompt مُخزَّن مؤقتاً؛ تقدير التكلفة
-
التحقق من التوفير
Measure cache hit rate and cost delta over 100 calls.✓ تم النسخ
→ تخفيض ملموس في التكلفة
النتيجة: توفير حقيقي في التكاليف (~50-80% على الجزء المُخزَّن مؤقتاً).
المزالق
- مدة الـ cache قصيرة — أعباء العمل عالية الحركة تستفيد أكثر — API منخفضة الحركة قد لا ترى hits؛ قيّم قبل التحسين
متى تستخدمه: الوظيفة غير متزامنة ولديك >100 استدعاء.
الخطوات
-
استخدام وصفة الدُّفعات
Apply batching from the cookbook to my classification job.✓ تم النسخ
→ تكامل نقطة نهاية الدُّفعات موضّح
-
التحقق من الإكمال والتكلفة
Compare batched cost vs sync for 1000 prompts.✓ تم النسخ
→ التكلفة تنخفض ~50%
النتيجة: أعباء عمل غير متزامنة أرخص، دقة مطابقة.
متى تستخدمه: المستخدمون سيتحدّون الإجابات؛ تحتاج إلى اقتباسات يمكنهم التحقق منها.
الخطوات
-
اعتماد نمط الاقتباسات
Use the citations recipe. Apply to my doc set.✓ تم النسخ
→ الإجابات تُشير إلى معرفات المصادر
-
إضافة روابط مدمجة
Map source IDs to URLs so users can click through.✓ تم النسخ
→ اقتباسات مُحوَّلة إلى روابط
النتيجة: RAG موثوق مع مسار تدقيق.
التركيبات
اجمعها مع خوادم MCP أخرى لتحقيق نتائج x10
كتاب الوصفات = التطبيق، الدورات = النظرية
Read the eval course chapter, then lift the cookbook eval harness for your prompt.✓ تم النسخ
هيكل التطبيق + وصفات كتاب الوصفات
Quickstart the customer-support template, then layer in caching from cookbook.✓ تم النسخ
التكلفة والحدود
تكلفة التشغيل
- حصة API
- الوصفات تستدعي الـ API — رسوم الاستخدام تنطبق عند التشغيل
- الرموز لكل استدعاء
- متغير لكل وصفة
- التكلفة المالية
- مجاني (MIT)
- نصيحة
- استخدم Sonnet أثناء التطوير؛ انتقل إلى Opus فقط للموجهات التي تحتاجه
الأمان
الصلاحيات والأسرار ونطاق الأثر
الحد الأدنى من الصلاحيات: anthropic-api-key
تخزين بيانات الاعتماد: ANTHROPIC_API_KEY في البيئة
نقل البيانات الخارجي: Anthropic API
استكشاف الأخطاء
الأخطاء الشائعة وحلولها
الوصفة تستخدم إصدار SDK قديم
ارقَ anthropic SDK؛ تغييرات API طفيفة قد تحتاج تحديثين سطريين
مصادر cache تُظهر 0 في الإنتاج
مفتاح cache حساس للمحتوى؛ حتى فرق token واحدة = miss. استقرّ على prefixes.
البدائل
Anthropic Cookbook مقابل البدائل
| البديل | متى تستخدمها | المقايضة |
|---|
| anthropics/anthropic-quickstarts | تريد تطبيقات كاملة لا وصفات | حبيبية مختلفة |
| anthropics/courses | تريد البيداغوجيا لا التنفيذ | النظرية مقابل التطبيق |