بار پیامها را بسازید
هر فراخوانی به یک مدل چت صرفاً یک درخواست 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). دورها را بدون تغییر بازگردانید.
مشکلی در این درس دیدید؟ گزارشش کنید · دربارهٔ این درس بپرسید
این تمرین بهزودی باز میشود
درس پیش از آن را تمام کنید تا این یکی باز شود. کل دوره رایگان است، حساب کاربری لازم نیست، و میتوانید همین الان این درس را بخوانید.
این مرورگر کوکیهای learn.floati.life را مسدود میکند، پس درسهایی که اینجا تمام کردید نمیتوانند به ترتیب باز شوند. کوکیها را برای این سایت مجاز کنید و صفحه را دوباره بارگذاری کنید.