سرفصل‌ها درس 116 از 250 · فراخوانی یک LLM واقعی
فراخوانی یک LLM واقعی

پاسخ را بخوانید

مدل با یک شی JSON پاسخ می‌دهد و SDK آن را به‌عنوان یک پاسخ با یک content لیست، یک stop_reason، و یک usage block. سورپرایز مهم برای مبتدیان: content یک لیست از بلوک‌ها است، نه یک رشتهٔ واحد. بیشتر پاسخ‌ها یک بلوک متنی هستند، اما یک پاسخ می‌تواند چندین بلوک داشته باشد (برای مثال کمی متن، سپس یک درخواست ابزار)، بنابراین نمی‌توانید فرض کنید پاسخ همیشه در اندیس صفر قرار دارد.

در کد واقعی، به این صورت به آن دسترسی پیدا می‌کنید (صرفاً برای نمایش):

resp = client.messages.create(model="claude-opus-5-5", max_tokens=1024,
                              messages=[{"role": "user", "content": "Hi"}])
print(resp.content[0].text)        # the first block's text
print(resp.stop_reason)            # "end_turn", "max_tokens", "tool_use", ...
print(resp.usage.input_tokens, resp.usage.output_tokens)

دسترسی به content[0].text برای مورد ساده کار می‌کند، اما اگر اولین بلوک متن نباشد (بگویید یک ... است) از کار می‌افتد. tool_use بلوک). رویکرد مطمئن این است که همه بلوک‌ها را بررسی کرده و تنها آن‌هایی را که واقعاً متن هستند، به هم متصل کنیم. ما آن JSON پاسخ را به صورت یک dict ساده مدل می‌کنیم تا به صورت آفلاین اجرا شود:

{
  "content": [{"type": "text", "text": "Hello there."}],
  "stop_reason": "end_turn",
  "usage": {"input_tokens": 12, "output_tokens": 5}
}

شما در حال ساختن هستید get_text(resp). Walk resp["content"] و پیوند دادن text هر بلوکی که type است "text"، به ترتیب. هر بلوکی را که نوعش نیست رد کنید "text" (a tool_use این بلوک هیچ متنی برای کاربر ندارد). اگر content اگر خالی یا وجود نداشته باشد، رشتهٔ خالی را بازگردانید "" -> یک پیش‌فرض تمیز و ایمن به جای کرش.

آن را طوری بسازید که پاسخ تک‌بلوک فقط همان متن را بازگرداند، پاسخ چندبلوک متن‌ها را پشت سر هم پیوند دهد، بلوک غیرمتنی نادیده گرفته شود و بلوک خالی یا مفقود content بازمی‌گرداند "".

نوبت شما

نوشتن get_text(resp) که resp پاسخ API را مدل می‌کند {"content": [ {"type": "text", "text": ...}, ... ], "stop_reason": ..., "usage": {...}}. به ترتیب، متصل کنید text هر بلوکی که type == "text"، بدون در نظر گرفتن هر نوع بلوک دیگر (مانند tool_use. بازگردانید "" وقتی content خالی یا وجود نداشته باشد.

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

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

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