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

بار پیام‌ها را بسازید

هر فراخوانی به یک مدل چت صرفاً یک درخواست HTTP است که یک بدنه JSON را حمل می‌کند، و درست کردن آن بدنه اولین کاری است که کد واقعی انجام می‌دهد. در سراسر این ماژول، شما دقیقاً همان دیکت‌ها و لیست‌هایی را که API آنتروپیک مصرف و بازمی‌گرداند، به‌صورت دستی و با پایتون ساده خواهید ساخت؛ بنابراین کل فرایند به‌صورت آفلاین اجرا شده و قابل نمره‌دهی است. هر درس همچنین یک خط واقعی را که با کلید API روی سیستم خودتان اجرا می‌کنید، نشان می‌دهد. ساختارهایی که اینجا می‌سازید دقیقاً همان ساختارهایی هستند که از طریق شبکه ارسال می‌شوند.

با نصب SDK، ارسال یک پیام به این شکل است (صرفاً برای نمایش -> ما در اینجا شبکه را فراخوانی نمی‌کنیم):

import anthropic
client = anthropic.Anthropic()   # reads ANTHROPIC_API_KEY from the environment
resp = client.messages.create(
    model="claude-opus-5-5",
    max_tokens=1024,
    system="You are a terse assistant.",
    messages=[{"role": "user", "content": "Hello"}],
)

به شکل توجه کنید: system یک فیلد سطح بالا (top-level) است (این یک پیام نیست)، و messages یک لیست از چرخش‌ها است، که هر کدام یک dict با یک role و content. تنها نقش‌های معتبر درون messages هستند "user" و "assistant"، به‌صورت متناوب مانند یک گفتگو. یک باگ رایج قرار دادن دستورالعمل‌ها در یک {"role": "system", ...} نوبت در ابتدای messages، همان‌طور که برخی دیگر از APIها این کار را می‌کنند. API آنتروپیک یک نوبت سیستم را به‌عنوان اولین پیام رد می‌کند: دستورالعمل سیستم جایگاه سطح بالایی خود را دارد. (مدل‌های اخیر Claude پیام سیستمی را در مراحل بعدی گفتگو برای دستوری که در میانهٔ مکالمه می‌رسد می‌پذیرند، اما این یک ویژگی پیشرفته است؛ این دوره همیشه از اسلات سطح بالا استفاده می‌کند، بنابراین build_request هر دور سیستمی را رد می‌کند.)

شما در حال ساختن هستید build_request(system, messages, model="claude-opus-5-5", max_tokens=1024). این دیکشنری درخواست را بازمی‌گرداند:

{"model": ..., "max_tokens": ..., "system": ..., "messages": [...]}
  • کپی model و max_tokens مستقیماً از آن عبور کرده و قرار دهید system در کلید خودش.
  • برای هر چرخش در messages، اعتبارسنجی کنید که نقش دقیقاً "user" یا "assistant". هر چیز دیگری (یک "system" نوبت، یک اشتباه تایپی مانند "User"، یک نقش گم‌شده) باید یک ValueError -> قبل از اینکه اصلاً به API درخواست بدهید، با صدای بلند خطا بدهید و یک رفت‌و‌برگشت را هدر ندهید.
  • نوبت‌ها را در messages بدون تغییر (با همان ترتیب، همان محتوا).

در اینجا فراخوانی واقعی است که با دیکتی که همین حالا ساخته‌اید انجام می‌دهید؛ ** واژهٔ dict را به آرگومان‌های کلیدواژه‌ای باز می‌کند:

resp = client.messages.create(**build_request("Be brief.", history))

آن را طوری بسازید که دو جفت متفاوت (system, messages) دو دیکت درخواست متفاوت تولید کنند و یک turn با نقشی غیر از user یا assistant خطا ایجاد کند.

نوبت شما

نوشتن build_request(system, messages, model="claude-opus-5-5", max_tokens=1024) که دیکشنری درخواست شکل آنتروپیک را بازمی‌گرداند {"model", "max_tokens", "system", "messages"}. messages یک لیست از {"role", "content"} turns. Validate every role is exactly "user" یا "assistant" و یک را ایجاد کنید ValueError روی هر چیز دیگری (از جمله یک قاچاقی "system" turn). دورها را بدون تغییر بازگردانید.

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

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

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