الانتقال إلى المحتوى الرئيسي
لم تُحدَّث ترجمة هذه الصفحة بعد، والنسخة الإنجليزية هي الأحدث والأصح، وقد يختلف المحتوى أدناه عنها. اقرأ النسخة الإنجليزية.
موديلات الـ reasoning تفكّر قبل أن ترد. خيار reasoning يحدد مقدار التفكير. والـ run يُرجع لك ما فكّر فيه الموديل منفصلًا عن الجواب: كأحداث reasoning.* في agent.stream()، وكـ result.reasoning. بادئة vendor/ في اسم الموديل هي التي تختار الـ provider. ومع OpenRouter استخدم openrouter/<vendor>/<model> (مثال openrouter/anthropic/claude-sonnet-4.5).

الخيار

reasoning إما مستوى effort، 'none' | 'minimal' | 'low' | 'medium' | 'high'، أو object: حدده في createAgent({ reasoning }) لكل run، أو لكل call عن طريق send(input, { reasoning }) / stream(input, { reasoning }). الـ sub-agent يستخدم reasoning الخاص به، لا الخاص بالأب. AgentExecutor.execute() يأخذه كـ ExecuteOptions.reasoning، والـ provider المخصص يستلمه كـ GenerateOptions.reasoning. 'none' لا يرسل شيئًا: يعمل الموديل بالإعداد الافتراضي لدى الـ provider (موديلات الـ reasoning من OpenAI تبقى تفكّر بمستوى الـ effort الافتراضي لديها).

ما يصل لكل provider

هناك قيود تطبّقها حزم الـ providers نيابة عنك: @ai-sdk/anthropic يضيف ميزانية التفكير فوق max_tokens (فتبقى الميزانية دائمًا أقل منه) ويحذف temperature وtopP، لأن Anthropic لا تسمح بهما مع التفكير؛ و@ai-sdk/openai يحذف temperature لموديلات الـ reasoning. وكل حزمة تسجّل تحذيرًا عندما تحذف إعدادًا.

أي الموديلات توصلها الخيارات

تُرسل الخيارات فقط لعائلات الموديلات المعروف أنها تقبلها. أي أن الموديل الذي لا يدعم reasoning لن يتلقى خطأ «خيار غير معروف» أبدًا: لأي model id آخر (fine-tune أو عائلة جديدة) مرّر { effort, force: true }. وإذا كان reasoning مضبوطًا والموديل لا تصله الخيارات، يُسجَّل تحذير مرة واحدة لكل provider وموديل.

الأحداث والنتائج

agent.stream() يصدر reasoning.start، ثم reasoning.delta (مع text) بينما يفكّر الموديل، ثم reasoning.done (text: النص كاملًا؛ وtokens إذا كان الـ provider قد أبلغ عن عدد الـ reasoning tokens حينها). تأتي الأحداث داخل الـ step، قبل أول text.delta أو tool.start فيها. والـ provider الذي لا يستطيع إجراء streaming يُبلغ عن reasoning الخطوة كـ start/delta/done واحدة قبل نصها. result.reasoning هو نص الـ reasoning لخطوات الـ run، ويُفصل بين كل خطوة والتي تليها بسطر فارغ. وresult.usage.reasoningTokens (وكل عنصر في stepUsage) يعدّ الـ reasoning tokens عندما يُبلغ الـ provider عنها؛ والـ span الخاص بـ chat يحملها في lousho.usage.reasoning_tokens. المستهلِكون يعرضونه أيضًا: reduceAgentEvents() تحتفظ به كـ reasoning في رسالة الـ assistant، وtoUIMessageStream() تصدر أجزاء reasoning-start / reasoning-delta / reasoning-end لـ useChat، وlousho acp يرسل تحديثات agent_thought_chunk، وlousho chat يطبعه بلون باهت.

ما يُحفظ في الـ transcript

لا يُكتب الـ reasoning أبدًا في الـ transcript كنص، ولا يُعاد إرساله إلى الـ model كمحتوى. هناك استثناء واحد يفرضه الـ provider: تحتاج Anthropic الـ thinking blocks الخاصة بالـ turn، دون تعديل ومع توقيعاتها، عندما تكمل بعد الـ tool calls في الـ turn نفسها. وبالتالي:
  • رسالة الـ assistant التي نفّذت tool calls تحتفظ بالـ thinking blocks الموقَّعة (أو المحجوبة) في message.reasoning؛ والـ provider الخاص بـ Anthropic يعيد إرسالها أولًا في تلك الـ turn. وتبقى موجودة بعد الـ step التالية، والـ checkpoint، والاستئناف بعد crash، وتوقّف الـ approval (الموافقة)، لأنها جزء من الرسائل المحفوظة.
  • الـ reasoning غير الموقَّع (OpenAI و Ollama و OpenRouter) وreasoning الرد النهائي لا يُحفظان في messages. وعناصر الـ reasoning المشفّرة عند OpenAI لا تنتقل بين الخطوات.
  • باقي الـ providers تتجاهل message.reasoning.