الترحيل إلى كلود فيبل 5.1 من فيبل 5 أو أوبس 5: كل التغييرات الكاسرة

الانتقال إلى Claude Fable 5.1 هو في الأغلب مجرد تبديل لمعرف النموذج. تتطابق واجهة برمجة التطبيقات، والحدود، والتسعير لكل رمز، والمُحلل اللغوي، والتفكير التكيفي الدائم، ومعالجة الرفض جميعها مع Fable 5. لكن ثلاثة تغييرات تُعيد أخطاء لم يقم Fable 5 بإعادتها قط، وواحد منها، وهو فحص تعديل السجل، يمكن أن يؤدي بصمت إلى تدهور أداء مجموعة أدوات الوكيل التي كانت تعمل بشكل جيد لمدة عام. القدوم من Opus 5 يضيف أربعة بنود أخرى.

هذا الدليل هو قائمة التحقق التي تحتوي على نص الخطأ الدقيق والإصلاح لكل بند، بالترتيب الذي ستصادفه فيه، وهو مبني على دليل الهجرة الخاص بـ Anthropic وما الجديد في Claude Fable 5.1. يمكن لصق كل مقتطف في Apidog وتشغيله مقابل نقطة النهاية الحقيقية قبل وصوله إلى الإنتاج. للحصول على نظرة عامة عن النموذج، ابدأ بـ ما هو Claude Fable 5.1.

الخطوة 0: تأكد مما إذا كان ينبغي عليك الترحيل على الإطلاق

تقول وثائق Anthropic أن تبدأ بـ Opus 5 وتستخدم Fable 5.1 "للتفكير المتطلب والعمل الوكيلي طويل الأمد، أو عندما لا تزال تقييماتك على Claude Opus 5 بجهد أعلى قصيرة." إذا نجح Opus 5 في تقييماتك، فإن الترحيل يضاعف سعر الرمز الواحد دون مكاسب ملموسة. إذا كنت تستخدم Fable 5، فهو نفس السعر مع قراءات ذاكرة تخزين مؤقت أرخص وأرقام مُدَّعاة أفضل، لذا فإن السؤال هو فقط مقدار العمل الذي يتطلبه الأمر. تُغطي المقارنات بين Fable 5.1 و Fable 5 و Fable 5.1 و Opus 5 هذا القرار.

ثلاثة فحوصات أهلية أولاً:

• الاحتفاظ بالبيانات. يتطلب Fable 5.1 الاحتفاظ بالبيانات لمدة 30 يومًا وهو غير متاح بموجب سياسة عدم الاحتفاظ بالبيانات (ZDR) ما لم تسمح به Anthropic صراحةً. تحصل المنظمة التي تعمل بسياسة ZDR على خطأ 400 invalid_request_error في كل طلب بدون أي تلميح آخر. يتوفر Opus 5 بموجب سياسة ZDR.
• فئة الأولوية. غير مدعوم في Fable 5.1. يدعمه Fable 5.
• حدود المعدل. يتشارك Fable 5.1 مجمع "Fable 5.x" واحدًا مع Fable 5، لذا فإن التحول التدريجي يسحب من نفس المساحة المتاحة.

الخطوة 1: تحديث اسم النموذج

model = "claude-fable-5"    # Before
model = "claude-opus-5"     # Or before
model = "claude-fable-5-1"  # After

على Amazon Bedrock، المعرّف هو anthropic.claude-fable-5-1. تستخدم Google Cloud، و Microsoft Foundry، ومنصة Claude على AWS المعرّف claude-fable-5-1. إذا كنت تستخدم Claude Managed Agents، فهذا هو التغيير الوحيد المطلوب.

تغيير جذري 1: الاستخدام القسري للأدوات يعيد 400

قبل Fable 5، كانت قيم tool_choice المقبولة هي auto وnone وany وtool. يرفض Fable 5.1 القيمتين الأخيرتين، وذلك على Messages API، و Batches API، ونقطة نهاية عد الرموز:

tool_choice: type "tool" and "any" are not supported for this model.

سبب Anthropic: التفكير يكون دائمًا قيد التشغيل، والمكالمة القسرية ستتجاوزه، لذا سيكتب النموذج خطوات عمله في وسائط الأداة.

قبل (Fable 5):

response = client.messages.create(
    model="claude-fable-5",
    max_tokens=16000,
    tools=[record_summary_tool],
    tool_choice={"type": "tool", "name": "record_summary"},
    messages=[{"role": "user", "content": "Summarize: The meeting moved to Thursday."}],
)

بعد (Fable 5.1): اترك tool_choice على auto، وسمِ الأداة في التعليمات، واضبط strict: true (الاستخدام الصارم للأداة) بحيث تتطابق الوسائط مع مخططك.

record_summary_tool["strict"] = True
record_summary_tool["input_schema"]["additionalProperties"] = False

response = client.messages.create(
    model="claude-fable-5-1",
    max_tokens=16000,
    tools=[record_summary_tool],
    tool_choice={"type": "auto"},
    messages=[{"role": "user", "content": "Summarize: The meeting moved to Thursday. Call the record_summary tool with your result."}],
)

رحّل بناءً على النية. إذا كنت تفرض استخدام أداة للحصول على JSON، فاستبدلها بمخرجات منظمة (output_config.format). إذا كان التطبيق يتطلب الاستدعاء في هذه الجولة، ألحق رسالة role: "system" بعد آخر جولة للمستخدم تسمي الأداة وتقول إن الاستدعاء مطلوب، واحتفظ بها في السجل بعد ذلك. إذا كنت تعتمد على any لـ "أداة واحدة بالضبط"، فإن disable_parallel_tool_use: true لا يزال يعمل مع auto ولكنه يعني الآن استدعاء واحدًا على الأكثر. احذف أي حلقة إعادة محاولة عند فقدان أداة؛ تقول Anthropic إن Fable 5.1 يتبع تعليمات الأداة الصريحة بشكل موثوق. في مؤسسة CMEK، لا يتوفر strict: true والمخرجات المنظمة في نماذج Fable، لذا اعتمد على التعليمات وحدها.

تغيير جذري 2: النماذج القديمة لا يمكنها قراءة كتل التفكير في Fable 5.1

يسجل كل كتلة تفكير النموذج الذي أنتجها. يقرأ Fable 5.1 الكتل من Opus 5، و Fable 5، و Mythos 5، والنماذج الأقدم، لذا فإن المحادثة التي تنتقل إلى Fable 5.1 تحتفظ بتفكيرها. باستثناء Mythos 5.1، لا يمكن لأي نموذج آخر قراءة كتلة Fable 5.1.

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

لا يوجد شيء لإصلاحه في الكود. استمر في تمرير كتل التفكير مرة أخرى دون تغيير؛ يمكن أن يؤدي تجريدها بنفسك إلى تشغيل أخطاء 400. للرؤية، أرسل الرأس التجريبي thinking-binding-controls-2026-08-01 ويحتوي الرد على مصفوفة input_transformations تسمي كل كتلة تم إسقاطها بـ reason: "model_binding_mismatch".

تغيير جذري 3: تعديل الجولات السابقة يبطل كتل التفكير

هذا هو البند الذي يجب تخصيص وقت له. كتلة تفكير Fable 5.1 صالحة فقط مقابل المطالبة الدقيقة system، ومصفوفة tools، وسجل الرسائل الذي سبقها (التفكير المحفوظ). حيث يتم تطبيق الفحص، يتم رفض الطلب الذي يعيد تشغيل كتلة بعد أي تغيير في ذلك:

messages.5.content.0: Invalid `signature` in `thinking` block. The block is bound to a different conversation. Remove the block, or set `thinking.block_binding.prefix_mismatch_behavior` to "drop_block". That setting requires the `thinking-binding-controls-2026-08-01` value in the `anthropic-beta` header.

من ينفذ عليه. الحسابات التي تم إنشاؤها في أو بعد 31 أغسطس 2026. تسجل الحسابات القديمة عدم التطابق ولكنها تتصرف بناءً عليه فقط إذا قام الطلب بتعيين thinking.block_binding.prefix_mismatch_behavior. تقول Anthropic إن النماذج المستقبلية ستفرض ذلك على كل حساب. إذا قمت بشحن أداة يقوم الآخرون بتشغيلها باستخدام مفتاح API الخاص بهم، فاختبرها مع تعيين الحقل: سيتم تطبيق ذلك على المستخدمين لديك في الحسابات الجديدة قبلك. يحافظ Claude Code، و claude.ai، و Managed Agents، و Agent SDK على البادئة سليمة لك؛ ولا يقوم Mythos 5.1 بتشغيل الفحص على الإطلاق.

ما الذي يبطل كل كتلة لاحقة: التحرير، أو إعادة الترتيب، أو إزالة جولة سابقة (بما في ذلك حذف نتائج الأداة القديمة)؛ حقن نص لكل طلب تقوم بإزالته في الطلب التالي؛ إعادة بناء system أو tools بين الطلبات؛ عنوان URL لصورة يقدم بايتات مختلفة لاحقًا. ما الذي يبقي الكتل صالحة: السجلات التي تُضاف فقط إليها، إزالة سلسلة رائدة من كتل التفكير الأقدم أولاً، تغيير أي معلمة خارج system، و tools، و messages، وتحريك علامات cache_control، وضغط جانب الخادم أو تحرير السياق.

طوق النجاة. أرسل الرأس التجريبي واضبط الحقل على "drop_block":

response = client.beta.messages.create(
    model="claude-fable-5-1",
    max_tokens=16000,
    thinking={"type": "adaptive", "block_binding": {"prefix_mismatch_behavior": "drop_block"}},
    betas=["thinking-binding-controls-2026-08-01"],
    messages=history,
)
for t in response.input_transformations or []:
    print(t.path, t.reason)   # prefix_binding_mismatch or model_binding_mismatch

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

قادماً من Opus 5: أربعة بنود إضافية

1. لا يمكن تعطيل التفكير بأي جهد. كان Opus 5 يقبل thinking: {"type": "disabled"} عند مستوى high أو أقل. يعيد Fable 5.1 خطأ 400 عند أي جهد. قم بإزالة الحقل، وتحكم في الإنفاق بجهد أقل، وأعد النظر في max_tokens للمسارات التي تعمل بدون تفكير.

2. السرد بين الأدوات ينتقل إلى كتل التفكير. في Opus 5، كان النص بين استدعاءات الأداة يعود ككتل text. في Fable 5.1، يعود ككتل thinking لتحديث التقدم تكون فارغة ضمن الإعداد الافتراضي display: "omitted". إذا كانت واجهة المستخدم الخاصة بك تعرض هذا السرد، فاضبط thinking: {"type": "adaptive", "display": "updates"} مع الرأس thinking-display-updates-2026-08-18.

3. مجموعة المصنفات أوسع. يشغل Opus 5 مصنفات إلكترونية فقط. يغطي Fable 5.1 cyber، وbio، وfrontier_llm، وreasoning_extraction، وgeneral_harms. تعامل مع stop_reason: "refusal" قبل قراءة content، واختر fallbacks: "default" مع الرأس server-side-fallback-2026-07-01. الأهداف المسموح بها هي Opus 4.8 و Opus 5، لذا يمكن لطلب مرفوض أن يعود إلى النموذج الذي قمت بالترحيل منه.

4. السعر والاحتفاظ. 10 دولارات و 50 دولارًا بدلاً من 5 دولارات و 25 دولارًا، مع قراءات ذاكرة التخزين المؤقت بسعر 0.25 دولارًا بدلاً من 0.50 دولارًا. تُفقد ميزة ZDR. يحتوي تحليل الأسعار على التفاصيل الحسابية.

إذا كنت قادمًا من Opus 4.8 أو أقدم، طبق أولاً ترحيل Opus 4.8 إلى Opus 5، ثم هذا الدليل. غالبًا ما تقوم التكاملات المكتوبة لـ Opus 4.8 باقتطاع الجولات القديمة أو إعادة بناء المطالبة النظامية في كل طلب، ولم يعترض Opus 4.8 على ذلك قط.

تغييرات السلوك للاختبار عليها

لا يوجد أي منها يعيد أخطاء، ولكل منها إصلاح من سطر واحد في دليل المطالبة. في الحلقات الطويلة، قد يصدر Fable 5.1 استدعاء أداة واحدًا لكل جولة حيث كان Fable 5 يجمع عدة استدعاءات؛ قم بقياس حصة الجولات متعددة الاستدعاءات وأضف حافز التجميع إذا انخفضت. يكتب رسائل تقدم أقل، لذا اضبط display: "updates" وقم بإزالة أسطر المطالبة التي تطلب منه حجب النتائج. عند الجهد low، فإنه يستدعي أدوات البحث بشكل أقل تكرارًا، لذا ارفع الجهد للجولات التي تحتاج إلى بيانات حديثة.

التغييرات الموصى بها

• الجهد لكل رسالة (تجريبي mid-conversation-output-config-2026-07-01). غيّر الجهد برسالة role: "system" ذات محتوى فارغ تحمل output_config بدلاً من تغيير القيمة العلوية، مما يعيد ضبط ذاكرة التخزين المؤقت.
• ابدأ بـ high وقم بالمسح. أكبر المكاسب على Fable 5 تكون عند xhigh و max؛ تقول Anthropic إن medium يطابق Fable 5 تقريبًا بتكلفة أقل. أسماء المستويات لا تنتقل عبر النماذج.
• تقليم السياق على الخادم. لا يُعد الضغط من جانب الخادم (تجريبي compact-2026-01-12) وتحرير السياق تعديلات على السجل.

قائمة التحقق للترحيل

• [ ] تأكيد الاحتفاظ بالبيانات لمدة 30 يومًا وعدم الاعتماد على فئة الأولوية (Priority Tier).
• [ ] تحديث اسم النموذج إلى claude-fable-5-1.
• [ ] استبدال كل tool_choice من النوع any أو tool بـ auto بالإضافة إلى تعليمات و strict: true، أو مخرجات منظمة.
• [ ] من Opus 5: إزالة thinking: {"type": "disabled"} وإعادة النظر في max_tokens.
• [ ] تمرير كتل التفكير مرة أخرى دون تغيير في كل جولة، بما في ذلك الكتل الفارغة.
• [ ] إذا كان الكود الخاص بك يبني messages، قم بتشغيل جلسة باستخدام prefix_mismatch_behavior: "drop_block"، وسجل input_transformations، وقم بإصلاح كل prefix_binding_mismatch.
• [ ] تجميد system و tools في بداية الجلسة؛ نقل التذكيرات لكل جولة إلى رسائل نظام ذات نطاق جولة لا تحذفها أبدًا.
• [ ] اختر prefix_mismatch_behavior للإنتاج وراقبه.
• [ ] التعامل مع stop_reason: "refusal"؛ إضافة fallbacks: "default".
• [ ] إذا كانت واجهة المستخدم الخاصة بك تعرض نصًا بين الأدوات، فاضبط display: "updates".
• [ ] أعد تشغيل مسح الجهد بدءًا من high وأعد تحديد التكلفة الأساسية. لم تتغير أعداد الرموز عن Fable 5؛ وقراءات ذاكرة التخزين المؤقت بربع السعر.

تشغيل قائمة التحقق في Apidog

أنشئ مجموعة مع طلب واحد لكل تغيير جذري: استدعاء tool_choice قسري (توقع الخطأ 400 المذكور أعلاه)، استدعاء thinking: disabled (توقع الخطأ 400)، وتسلسل من طلبين يقوم بتحرير مطالبة النظام بين الجولات مع تعيين رأس ربط التفكير (توقع إدخال prefix_binding_mismatch). أضف الإصدارات الناجحة بجانبها مع تأكيدات على stop_reason ومصفوفة input_transformations فارغة، وقم بتشغيله في CI عبر واجهة سطر أوامر Apidog عند كل تغيير في مجموعة الأدوات. حمّل Apidog لبنائه؛ يحتوي شرح واجهة برمجة التطبيقات على نصوص الطلبات.

الأسئلة الشائعة

هل الترحيل من Fable 5 إلى Fable 5.1 تغيير مباشر؟ في الأغلب نعم. يعيد tool_choice القسري خطأ 400، ولا تستطيع النماذج القديمة قراءة كتل التفكير في Fable 5.1، ويؤدي تعديل الجولات السابقة إلى إبطال كتل التفكير اللاحقة في الحسابات التي يتم تطبيق القواعد عليها. كل شيء آخر ينتقل.

ماذا يعني "مرتبط بمحادثة مختلفة"؟ قام الكود الخاص بك بتغيير شيء قبل كتلة تفكير Fable 5.1 ثم أعاد تشغيل الكتلة. توقف عن تحرير السجل، أو أرسل الرأس thinking-binding-controls-2026-08-01 مع prefix_mismatch_behavior: "drop_block".

هل يفرض حسابي فحص تحرير السجل؟ إذا تم إنشاؤه في أو بعد 31 أغسطس 2026، فنعم. تفرض الحسابات القديمة ذلك فقط عندما تقوم بتعيين prefix_mismatch_behavior.

هل يمكنني الاحتفاظ بمطالبات Fable 5 الخاصة بي؟ نعم. تقول Anthropic إنها يجب أن تؤدي بشكل جيد دون تغييرات. أعد تشغيل مسح الجهد وتوقع عددًا أقل من استدعاءات الأدوات المتوازية في الحلقات الطويلة.

ما الذي يتعطل عند الترحيل من Opus 5؟ كل شيء في قائمة Fable 5، بالإضافة إلى thinking: disabled يعيد خطأ 400 بأي جهد، ينتقل السرد بين الأدوات إلى كتل التفكير، وتصبح مجموعة المصنفات أوسع، ويتضاعف السعر، وتُفقد ميزة ZDR.

هل لدى Bedrock و Google Cloud نفس التغييرات الجذرية؟ تغييرات النموذج، نعم. كانت عناصر التحكم في ربط التفكير متاحة على Claude API ومنصة Claude على AWS عند الإطلاق وستصل لكل نموذج على Bedrock و Google Cloud. بدون عناصر التحكم، يكون الحل هو تجريد كتل التفكير وإعادة المحاولة مرة واحدة.