بناء حمولة الرسائل (Messages Payload)
كل استدعاء لنموذج دردشة هو مجرد طلب HTTP يحمل جسم JSON، والحصول على ذلك الجسم بشكل صحيح هو أول شيء يفعله الكود الحقيقي. عبر هذه الوحدة ستقوم ببناء القواميس والقوائم التي تستهلكها وتُرجعها Anthropic API يدويا، باستخدام Python بسيطة -> لذا فإن العملية بأكملها تعمل دون اتصال بالإنترنت ويمكن تقييمها. يوضح كل درس أيضا السطر الحقيقي الوحيد الذي ستشغله باستخدام API key على جهازك الخاص. الأشكال التي تبنيها هنا هي الأشكال التي تمر عبر الشبكة.
بعد تثبيت 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 هو حقل المستوى الأعلى الخاص به (وهو ليس رسالة)، وmessages هي قائمة من الأدوار، كل دور هو dict يحتوي على role وcontent. الأدوار الصالحة الوحيدة داخل messages هي "user" و"assistant"، وتتبادل مثل المحادثة. خطأ شائع هو وضع التعليمات في دور {"role": "system", ...} في بداية messages، كما تفعل بعض واجهات البرمجة الأخرى. ترفض واجهة برمجة Anthropic دور النظام كأول رسالة: فـ prompt النظام له خانة المستوى الأعلى الخاصة به. (تقبل نماذج Claude الحديثة رسالة نظام لاحقاً في المحادثة، لتعليمات تصل في المنتصف، لكن هذه ميزة متقدمة؛ هذا المسار يستخدم دائماً خانة المستوى الأعلى، لذا فإن build_request يرفض أي دور نظام.)
أنت تقوم ببناء build_request(system, messages, model="claude-opus-5-5", max_tokens=1024). إنه يعيد قاموس request:
{"model": ..., "max_tokens": ..., "system": ..., "messages": [...]}- انسخ
modelوmax_tokensكما هما مباشرة، وضعsystemفي مفتاحه الخاص. - لكل دور في
messages، تحقق من أن الدور هو بالضبط"user"أو"assistant". أي شيء آخر (دور"system"، أو خطأ مطبعي مثل"User"، أو دور مفقود) يجب أن يرفعValueError-> فشل بشكل واضح قبل أن تصل إلى API وتضيع دوراً. - أعد الأدوار في
messagesدون تغيير (نفس الترتيب، نفس المحتوى).
هذا هو الاستدعاء الحقيقي الذي ستجريه باستخدام dict الذي أنشأته للتو؛ يقوم ** بفك حزم dict إلى keyword arguments:
resp = client.messages.create(**build_request("Be brief.", history))قم ببنائه بحيث ينتج زوجان مختلفان من (system, messages) قاموسين مختلفين للطلب، وتؤدي الدورة التي تحتوي على دور غير user أو assistant إلى حدوث خطأ.
اكتب build_request(system, messages, model="claude-opus-5-5", max_tokens=1024) الذي يعيد قاموس الطلب ذو شكل Anthropic {"model", "max_tokens", "system", "messages"}. messages هي قائمة من أدوار {"role", "content"}. تحقق من أن كل دور هو بالضبط "user" أو "assistant" وارفع ValueError عند أي شيء آخر (بما في ذلك دور "system" متسلل). أعد الأدوار دون تغيير.
سيفتح هذا التمرين قريبا
أنهِ الدرس السابق ليفتح هذا الدرس. الدورة كاملة مجانية، ولا تحتاج إلى حساب، ويمكنك قراءة هذا الدرس الآن.
يقوم هذا المتصفح بحظر ملفات تعريف الارتباط لـ learn.floati.life، لذا لا يمكن فتح الدروس التي أنهيتها هنا بالترتيب. اسمح بملفات تعريف الارتباط لهذا الموقع وأعد التحميل.