دليل الانتقال إلى Claude Opus 4.7: ما الذي يجب فحصه قبل الترقية؟

1. أصلح التغيير الكاسر أولًا: من extended thinking إلى adaptive thinking

قبل تعديل المطالبات، افحص إعدادات API. تقول Anthropic إن المطورين يستطيعون استخدام claude-opus-4-7 عبر Claude API؛ فإذا كان تطبيقك يحدد model ID مباشرة، اجعل تغيير الاسم جزءًا من اختبار صغير النطاق أو shadow eval قبل تعميمه.

الأهم هو إعداد التفكير. يوضح دليل الهجرة من Anthropic أن Claude Opus 4.7 أو النماذج اللاحقة لا تدعم إعداد extended thinking القديم بصيغة

thinking: {type: "enabled", budget_tokens: N}

عمليًا، ابدأ بثلاث خطوات:

• ابحث في الكود، وطبقات SDK، ومشغلات المطالبات، والمنصات الداخلية عن budget_tokens.
• أزل إعدادات extended thinking القديمة، واستبدلها بإعداد adaptive thinking الذي تدعمه واجهة API أو المزود الذي تستخدمه.
• لا تجعل ميزانية thinking الثابتة هي أداة التحكم الرئيسية. استخدم بدلًا منها مستويات effort، وميزانيات المهام، وقيود prompt، واختبارات eval لضبط عمق المهمة.

تضع وثائق أفضل ممارسات prompting لدى Anthropic مستويات effort، وtask budgets، وإعدادات thinking، وإزالة معاملات sampling، وtokenization ضمن تغييرات API التي يجب مراجعتها عند الانتقال من Opus 4.6 إلى Opus 4.7.

2. انقل التحكم في sampling إلى prompt وeval

إذا كان سير العمل القديم يعتمد على temperature أو top_p أو top_k للتحكم في الإبداع، أو الثبات، أو تنوع المخرجات، فلا تفترض أن نفس الأسلوب سيبقى صالحًا. تضع وثائق Anthropic إزالة معاملات sampling ضمن ملاحظات الانتقال إلى Opus 4.7، كما يذكر دليل OpenRouter للهجرة إلى Claude 4.7 إزالة معاملات sampling، واعتماد adaptive-only thinking، وسلوك effort الخاص بكل مزود.

هذا يؤثر عادة في ثلاث فئات:

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

بعد الترقية، يكون التحكم الأكثر استقرارًا عبر prompt وeval: عرّف النبرة، والتنسيق، والممنوعات، ومعايير النجاح بوضوح. استخدم أمثلة few-shot لتثبيت الأسلوب. اطلب مخرجات مهيكلة عند الاستخراج أو التصنيف أو إنشاء التقارير. وحوّل أمثلة Claude القديمة الناجحة إلى regression eval تقارن Opus 4.7 في الالتزام بالتنسيق، والدقة، والتكلفة، وزمن الاستجابة.

3. Tool use: اكتب سياسة صريحة لما يجب على النموذج فعله

إذا كان سير العمل القديم يعطي Claude هدفًا عامًا ويترك له تقدير متى يستخدم أداة خارجية، فهذه نقطة تستحق إعادة التصميم. تشير أفضل ممارسات prompting لدى Anthropic إلى أن أحدث نماذج Claude مدربة على اتباع التعليمات بدقة، وتستفيد من توجيه صريح لاستخدام أدوات محددة. كما تربط الوثائق adaptive thinking بأعباء العمل ذات السلوك agentic، مثل الاستخدام متعدد الخطوات للأدوات، ومهام البرمجة المعقدة، وحلقات agents طويلة الأمد.

اكتب هذه القواعد داخل system prompt أو policy سير العمل، مثلًا:

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

هذه السياسة قد تكون أهم من مجرد تغيير model ID، لأنها تحدد ما إذا كان الـ agent سيتجاهل مصدرًا مهمًا، أو سيخمن عند نقص البيانات، أو سيبدو واثقًا أكثر من اللازم عند تضارب الأدلة.

4. في المهام الطويلة: فكّر بميزانية effort والمهمة، لا بإخراج الرسالة فقط

أحد محاور الانتقال إلى Opus 4.7 هو التحكم في ميزانية المهام الطويلة والـ agentic workflows. توضح وثائق What’s new أن Opus 4.7 يقدّم task budgets؛ كما تشير الوثائق إلى أن معامل effort يتيح الموازنة بين القدرة والسرعة واستهلاك التوكنات، وأن task budget يعطي Claude تقديرًا تقريبيًا للتوكنات المتاحة للمهمة ككل.

إذا كان لديك coding agent، أو research agent، أو browser agent، أو معالجة بيانات طويلة، أو حلقة متعددة الأدوات، فقسّم الميزانية إلى ثلاث طبقات:

• ميزانية الرد الواحد: كم token يمكن أن يستخدمها الإخراج النهائي.
• ميزانية التفكير والأدوات: كم reasoning، وtool calls، وtool results يمكن أن تدخل في المهمة متعددة الخطوات.
• ميزانية المهمة كاملة: الحد الأعلى للتكلفة وزمن الاستجابة عبر كامل agent loop.

لا تقدّر تكلفة agent loop كاملة من خلال حد الإخراج النهائي فقط. التكلفة قد تأتي من عدة استدعاءات أدوات، وإعادة إدخال نتائج الأدوات إلى السياق، وتحليل الصور أو ملفات PDF، وإعادة المحاولة، ثم الإخراج النهائي. وجود task budgets وtokenizer جديد في Opus 4.7 يعني أن إعادة benchmark ليست رفاهية بل خطوة أساسية قبل الإطلاق.

5. التوكنات، RAG، التخزين المؤقت، والمهام الدفعة: أعد القياس

هذا أكثر بند يتم التقليل من شأنه. تذكر وثائق Anthropic أن tokenizer الجديد في Opus 4.7 قد يستخدم عند معالجة النصوص ما يقارب 1x إلى 1.35x من عدد التوكنات مقارنة بالنماذج السابقة، وأن /v1/messages/count_tokens سيعيد عددًا مختلفًا لـ Opus 4.7 عمّا كان يعيده لـ Opus 4.6. وتوصي Anthropic باستخدام هذا endpoint لإعادة التقدير.

قبل الترقية، أعد اختبار:

• حجم RAG chunks والتداخل overlap.
• حدود قصّ المستندات الطويلة.
• طول ذاكرة المحادثة conversation memory.
• معدل نجاح prompt caching وتقدير تكلفته.
• سقوف تكلفة batch jobs.
• حجم نتائج الأدوات التي يمكن إعادتها في كل جولة من agent.
• استراتيجية معالجة الصور وملفات PDF قبل إرسالها.

إذا كان سير العمل القديم قريبًا من سقف التكلفة أو حدّ السياق، فلا تستخدم حسابات token القديمة كما هي. اختبر المطالبات الأساسية، ونماذج المستندات الطويلة، والمهام عالية المرور، ثم قرر إن كنت تحتاج إلى تعديل chunking أو حدود القص أو تصميم cache keys.

6. الصور ولقطات الشاشة وPDF: أعد ضبط المعالجة المسبقة

تشير وثائق Opus 4.7 إلى دعم الصور عالية الدقة، كما تنبه الوثائق إلى أنه إذا لم تكن الدقة البصرية الإضافية ضرورية، فينبغي خفض دقة الصور قبل إرسالها إلى Claude لتجنب زيادة استخدام التوكنات.

هذا مهم خصوصًا في ثلاثة أنواع من سير العمل:

• فهم لقطات الشاشة: مثل اختبار واجهات المستخدم، أو قراءة جداول مصورة، أو تحليل dashboards.
• معالجة المستندات المصورة: مثل ملفات PDF الممسوحة ضوئيًا، أو لقطات العقود، أو شرائح العروض.
• computer-use وbrowser automation: عندما يحتاج النموذج إلى فهم مواضع الأزرار، والحقول، ورسائل الخطأ على الشاشة.

عند الانتقال من Opus 4.6، تظل قدرات PDF وvision ضمن نفس مجموعة القدرات الرئيسية التي تذكرها Anthropic؛ ما يجب اختباره فعليًا هو حجم الصورة المرسلة، وهل تحتاج حقًا إلى دقة عالية، وهل تبقى النصوص والعناصر المهمة قابلة للقراءة بعد downsample.

7. المزود أو البوابة الداخلية: لا تفترض أن خريطة المعاملات كما هي

إذا كنت لا تستدعي Anthropic API مباشرة، بل تمر عبر OpenRouter أو منصة سحابية أو gateway داخلية، فلا تفترض أن أسماء الحقول، أو قواعد تجاهل المعاملات، أو سلوك effort متطابقة. دليل OpenRouter للهجرة إلى Claude 4.7 يذكر بشكل مستقل إزالة معاملات sampling، وadaptive-only thinking، وسلوك effort الخاص بالمزود.

لذلك راجع ملاحظات الهجرة الخاصة بالمزود الفعلي الذي تستخدمه، إلى جانب وثائق Anthropic. هذا مهم خصوصًا في أنظمة multi-model router، وبوابات fallback، ومنصات prompt الداخلية، لأنها قد تغلّف API الأصلية بحقولها الخاصة. قبل الإطلاق، تأكد من الحقول التي ما زالت فعّالة، والحقول التي سيتم تجاهلها، والحقول التي ستسبب خطأ.

ما الذي لا يحتاج غالبًا إلى إعادة بناء؟

إذا كنت تنتقل من Opus 4.6 إلى Opus 4.7، فليست كل البنية الأساسية جديدة. يوضح دليل الهجرة من Anthropic أن Opus 4.7 يدعم نفس مجموعة القدرات الرئيسية في Opus 4.6، بما في ذلك نافذة سياق 1M token، وحد إخراج أقصى 128k token، وadaptive thinking، وprompt caching، وbatch processing، وFiles API، ودعم PDF، وvision، والمجموعة الكاملة من أدوات server-side وclient-side مثل bash، وتنفيذ الكود، وcomputer use، ومحرر النصوص، وweb search، وweb fetch، وMCP connector، وmemory.

لذلك، لا تكون الأولوية عادة إعادة بناء هذه العناصر من الصفر:

• مسار رفع الملفات عبر Files API.
• وجود دعم PDF أو vision بحد ذاته.
• توفر prompt caching أو batch processing.
• قدرة استدعاء الأدوات نفسها.
• قدرة السياق الطويل نفسها.

ما يحتاج إلى إعادة ضبط هو طريقة التحكم بهذه القدرات: متى تُستخدم الأدوات، وكم token تُستهلك، وما مستوى effort المناسب، وما حجم الصور المرسلة، وكيف يتصرف النظام عند الفشل أو نقص الأدلة.

Checklist عملي قبل الترقية

يمكن إعطاء هذه القائمة لفريق الهندسة، أو مالك منصة الذكاء الاصطناعي، أو الفريق المسؤول عن سير عمل Claude لاكتشاف نقاط الخطر بسرعة.

API والمعاملات

• غيّر اسم النموذج إلى claude-opus-4-7، وابدأ باختبار صغير أو shadow eval؛ تقول Anthropic إن المطورين يستطيعون استخدام هذا model ID عبر Claude API.
• ابحث عن thinking وbudget_tokens وأي wrapper قديم لـ extended thinking، وانقلها إلى adaptive thinking؛ Opus 4.7 وما بعده لا يدعم الإعداد القديم وسيعيد 400.
• ابحث عن temperature وtop_p وtop_k وغيرها من أدوات sampling، وانقل التحكم في الثبات إلى prompt وfew-shot وschema وeval.
• إذا كنت تستخدم Claude عبر OpenRouter أو طبقة وسيطة أخرى، راجع دليل الهجرة وخريطة المعاملات الخاصة بذلك المزود.

Prompt وtool use

• اكتب في system prompt متى يجب استخدام الأداة؛ توضح وثائق Anthropic أن أحدث نماذج Claude تستفيد من تعليمات صريحة لاستخدام أدوات محددة.
• حدّد متى لا يجوز للنموذج التخمين، وكيف يرد عند نقص البيانات.
• اكتب سلوك fallback عند تضارب نتائج الأدوات، أو فشل الأداة، أو عدم كفاية المصادر الخارجية.
• أضف تنسيق إخراج مهيكل لمسارات استخراج البيانات، والتصنيف، وإنشاء التقارير.

Agents والبرمجة

• أعد ضبط effort وميزانية المهمة في coding agents وresearch agents وbrowser agents؛ تربط وثائق Anthropic adaptive thinking بالاستخدام متعدد الخطوات للأدوات، ومهام البرمجة المعقدة، وحلقات agents طويلة الأمد.
• قيّم استخدام task budgets؛ تذكر وثائق Opus 4.7 هذه الميزة، وتنبه إلى أن حساب التوكنات يختلف عن الإصدار السابق.
• لا تستخدم حد الإخراج النهائي وحده لتقدير تكلفة agent loop؛ أدخل tool calls وtool results وإعادة المحاولة والإخراج النهائي في النموذج المالي.
• ابنِ regression eval من حالات نجاح الإصدار القديم، وقارن Opus 4.7 في معدل النجاح، والالتزام بالتنسيق، والزمن، والتكلفة.

التوكنات والمستندات والصور

• استخدم /v1/messages/count_tokens لإعادة تقدير تكلفة المطالبات الأساسية، وRAG chunks، والمستندات الطويلة، والمهام الدفعة.
• أعد اختبار chunk size، وحدود القص، وconversation memory، واستراتيجية prompt caching.
• ضع سياسة downsample للصور ولقطات الشاشة وصفحات PDF؛ إذا لم تكن الدقة العالية ضرورية، خفّض الدقة قبل الإرسال للحد من استهلاك التوكنات.

ترتيب ترقية مقترح

النهج الأكثر أمانًا ليس استبدال كل شيء دفعة واحدة، بل التدرج:

1. فحص ثابت: ابحث عن model ID، وإعدادات thinking، ومعاملات sampling، وحساب token، ومعالجة الصور، ومعاملات المزود الخاصة.
2. Eval صغير النطاق: استخدم golden set موجودة لمقارنة النموذج القديم وOpus 4.7 في جودة الإخراج، والالتزام بالتنسيق، واستخدام الأدوات، والتكلفة، وزمن الاستجابة.
3. أعد كتابة المطالبات عالية المخاطر: ابدأ بـ tool use، وRAG، وcoding agents، واستخراج البيانات، ومهام الامتثال.
4. وسّع الإطلاق تدريجيًا: راقب استهلاك التوكنات، وعدد tool calls، ومعدل الأخطاء، وزمن الاستجابة، وملاحظات البشر.

الخلاصة: الانتقال إلى Claude Opus 4.7 لا يعني بالضرورة إعادة كتابة كل المطالبات. المخاطرة الحقيقية هي ترك منطق التحكم القديم مخفيًا داخل معاملات لم تعد مناسبة أو تقديرات تكلفة قديمة. اجعل thinking adaptive، وانقل sampling إلى prompt وeval، وتعامل مع المهام الطويلة بمنطق الميزانيات، وأعد benchmark للتوكنات والصور؛ بهذه الطريقة تحصل على ترقية أكثر أمانًا وتحافظ على قابلية التحكم في سير العمل.