سرفصل‌ها درس 245 از 250 · کار با پاسخ‌های مدل
کار با پاسخ‌های مدل

خواندن یک پاسخ واقعی: بلوک‌ها و دلایل توقف

چرا اهمیت دارد هر باگی در این ماژول به یک شکل شروع می‌شود: کدی که می‌خواند reply["content"][0]["text"] و فرض می‌کند که این پاسخ است. در یک مدل کنونی، بلوک اول اغلب اصلاً متن نیست.

یک پاسخ از API پیام‌های کلود یک dict است. پاسخ در content، یک لیست از بلوک‌ها، و هر بلوک دارای یک type:

  • "thinking": مدل قبل از پاسخ دادن استدلال کرد. در مدل‌های فعلی این بلوک اغلب در ابتدا قرار می‌گیرد و به‌طور پیش‌فرض متن thinking آن خالی است (استدلال انجام شده اما نمایش داده نمی‌شود).
  • "text": کلمات برای کاربر. ممکن است بیش از یک بلوک متن وجود داشته باشد؛ پاسخ، همهٔ آن‌ها که به هم متصل شده‌اند است.
  • "tool_use": مدل می‌خواهد شما یک ابزار را اجرا کنید (درس‌های بعدی).

در کنار محتوا قرار دارد stop_reason، که دلیل توقف مدل را نشان می‌دهد: "end_turn" (پایان یافت)، "max_tokens" (به محدودیت طول رسیدید، بنابراین پاسخ ممکن است ناقص یا حتی حذف شده باشد)، "tool_use" (منتظر نتیجه ابزار) یا "refusal" (رد شده). چند مورد دیگر هم وجود دارد، مانند "stop_sequence" و "pause_turn"، بنابراین هر چیزی غیر از "end_turn" به عنوان ناتمام در نظر بگیرید. همیشه قبل از اعتماد به محتوا، آن را بررسی کنید.

{'id': 'msg_01',
 'type': 'message',
 'role': 'assistant',
 'model': 'claude-opus-5-5',
 'content': [{'type': 'thinking', 'thinking': '', 'signature': 'EuYBCkQYAiJA...'},
             {'type': 'text',
              'text': 'A context window is the amount of text a model can read at once.'}],
 'stop_reason': 'end_turn',
 'stop_sequence': None,
 'usage': {'input_tokens': 412, 'output_tokens': 60}}

درباره این پاسخ‌ها: آن‌ها شبیه‌سازی شده‌اند. هر یک دقیقاً به شکلی که API Claude Messages بازمی‌گرداند (بلاک‌های محتوا، stop_reason, usage)، و هر یک چیزی را که مدل‌های واقعی انجام می‌دهند، کپی می‌کند. این‌ها ضبط یک مدل زنده نیستند، بنابراین واژه‌بندی دقیق از آن ماست؛ ساختارها و مشکلات، واقعی هستند و کدی که می‌نویسید با آن‌ها روبه‌رو خواهد شد.

نوبت شما

نوشتن reply_text(reply) بازگرداندن همهٔ بلوک‌های متنی به‌صورت پیوسته (یک رشتهٔ خالی اگر بلوکی وجود نداشته باشد)، با نادیده گرفتن هر نوع بلوک در هر بار. بنویسید finished(reply) بازگرداندن True فقط وقتی stop_reason است "end_turn". نگهدارندهٔ starter's REPLIES همان‌طور که هست باقی بماند: بررسی آن را می‌خواند.

مشکلی در این درس دیدید؟ گزارشش کنید · دربارهٔ این درس بپرسید

این تمرین به‌زودی باز می‌شود

درس پیش از آن را تمام کنید تا این یکی باز شود. کل دوره رایگان است، حساب کاربری لازم نیست، و می‌توانید همین الان این درس را بخوانید.