الرد الذي يبدو مكتملًا قد لا يكون كذلك. و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 أولًا. - اعتبار الإجابة الفارغة فشلًا من النموذج، بينما استهلك الاستدلال الميزانية كلها.