BroadRouter

سبب الانتهاء (finish_reason)

آخر تحديث

finish_reason (سبب الانتهاء) حقل في كل خيار ضمن استجابة إكمال المحادثة يوضّح سبب توقف النموذج عن التوليد. وفي صيغة OpenAI قيمه stop وlength وtool_calls وcontent_filter، إضافةً إلى function_call المُهمَلة. وتعبّر Messages API لدى Anthropic عن الفكرة نفسها بالحقل stop_reason.

يُسمّى أيضًا: سبب الانتهاء، سبب التوقف، سبب انتهاء الرد، finish_reason، finish reason، stop reason، stop_reason

الرد الذي يبدو مكتملًا قد لا يكون كذلك. وfinish_reason هو الحقل الوحيد الذي يخبرك هل أنهى النموذج الرد من تلقاء نفسه.

كيف يعمل

كل عنصر في choices يحمل finish_reason. ويسرد المرجع التقني لدى OpenAI هذه القيم:

القيمة المعنى (بحسب OpenAI)
stop نقطة توقف طبيعية، أو بلوغ تسلسل توقف مُرسَل
length “The maximum number of tokens specified in the request was reached” (ترجمة: بُلغ الحد الأقصى لعدد الرموز المحدّد في الطلب)
tool_calls استدعى النموذج أداة
content_filter “Content was omitted due to a flag from our content filters” (ترجمة: حُذف محتوى بسبب إشارة من مرشّحات المحتوى لدينا)
function_call صيغة أقدم مُهمَلة لاستدعاء دالة

تستخدم Messages API لدى Anthropic الحقل stop_reason بقيمها الخاصة، ومنها end_turn وmax_tokens وstop_sequence وtool_use وpause_turn وrefusal وmodel_context_window_exceeded. وحين يُطلَق تسلسل توقف، تُرجع Anthropic أيضًا أيّها في stop_sequence.

choice = r.choices[0]
if choice.finish_reason == "length":
    raise RuntimeError("cut off: raise max_tokens and resend")
if choice.finish_reason == "tool_calls":
    run_tools(choice.message.tool_calls)

لماذا يهم

  • JSON المقطوع. الرد بالقيمة length ناقص. وإغلاق الأقواس يجعله قابلًا للتحليل لكنه يُضيّع بيانات. ويتناول مقال JSON غير الصالح هذه المسألة.
  • حلقات الوكلاء. تعني tool_calls “شغّل الأدوات ثم استدعني مجددًا”، لا “انتهيت”.
  • التخزين المؤقت. لا تخزّن مؤقتًا إلا الردود التي انتهت بـ stop. فالإجابة المقطوعة المخزّنة أسبوعًا تبدو كأنها خلل في النموذج.

في BroadNet Inference

لا يوثّق المرجع التقني لـ BroadNet قيم finish_reason، فسجّل ما تحصل عليه قبل أن تعتمد عليه. لكنه يوثّق السبب الرئيسي لمفاجآت length: إذ تستدل DeepSeek V4.1 Flash وGLM 5.3 وQwen3.8 27B منطقيًا قبل أن تجيب، ورموز الاستدلال تُحتسب ضمن max_tokens. وتقول BroadNet إنه مع حد صغير “the reasoning can use the whole budget and the answer comes back empty.” (ترجمة: قد يستهلك الاستدلال الميزانية كلها فتعود الإجابة فارغة.) اترك 1,000 رمز أو أكثر، أو اضبط reasoning_effort على low. ويشرح دليل الاستجابة الفارغة الإصلاح خطوة بخطوة.

أخطاء شائعة

  • قراءة message.content دون فحص finish_reason أولًا.
  • اعتبار الإجابة الفارغة فشلًا من النموذج، بينما استهلك الاستدلال الميزانية كلها.

أسئلة شائعة

ماذا تعني القيمة "length" في finish_reason؟

بلغ الرد حد الرموز الذي ضبطته فقُطع. وتصفه OpenAI بأن "the maximum number of tokens specified in the request was reached" (ترجمة: بُلغ الحد الأقصى لعدد الرموز المحدّد في الطلب). ارفع max_tokens أو اطلب أقل؛ ولا تحاول إصلاح النص المقطوع.

لماذا تكون finish_reason بالقيمة "stop" حين أضبط تسلسل توقف؟

في صيغة OpenAI، تشمل stop النهاية الطبيعية والتسلسل المطابق معًا. أما Anthropic فتفصل بينهما في end_turn وstop_sequence.

هل يوثّق BroadNet قيم finish_reason؟

لا. لا يسرد المرجع التقني لـ BroadNet قيم finish_reason. سجّل الحقل في طلباتك واختبر قبل أن تبني منطقًا على قيمه.

اقرأها بصيغة Markdownاسأل ChatGPTاسأل Claudeاسأل Perplexity