أوصاف الحقول التي ترشد النموذج
وثّقوا كل حقل لكي يملأه الذكاء الاصطناعي بصورة صحيحة.
أوصاف الحقول التي ترشد النموذج درس مجاني في MCP Academy على CoddyKit. هذا هو الدرس 4 من أصل 4. يمكنك قراءة الدرس كاملاً أدناه مجاناً — ثم تمرن عليه مباشرة في المتصفح باستخدام محرر أكواد مدمج ومدرس ذكاء اصطناعي متاح 24/7. هذا الدرس جزء من مسار التعلم في MCP Academy، وتقدمك يتزامن عبر الويب وتطبيق CoddyKit. تتضمن دورة MCP Academy 4 دروس في المجموع.
يقرأ النموذج حقولك
يُعرض اسم كل حقل ووصفه على الذكاء الاصطناعي. ويمنحك الوصف الجيد فرصة لإخبار النموذج بما يجب وضعه هناك بدقة.
أضف وصفًا
مرّر description إلى Field لإرفاق جملة مفهومة للبشر ترافق المخطط حتى تصل إلى العميل.
city: str = Field(description="City name, e.g. Paris")اعرض المثال، ولا تكتفِ بالوصف
توجّه الأمثلة الملموسة داخل الوصف، مثل تاريخ نموذجي أو تنسيق معيّن، النموذج أفضل بكثير من العبارات المجردة.
date: str = Field(description="ISO date, e.g. 2026-01-31")اذكر الوحدات
إذا كان للعدد وحدات، فاذكرها. إخبار النموذج بأن درجة الحرارة بالسيلسيوس يمنع قيم فهرنهايت الخاطئة دون تنبيه.
وضّح الأسماء الملتبسة
الحقل المسمّى id غامض. أما الوصف مثل «المعرّف الفريد للطلب» فيزيل التخمين بشأن المعرّف المقصود.
حدّد التنسيق بوضوح
عندما تتبع سلسلة بنية معينة، فصِفها. إن قولك إن الهاتف بتنسيق E.164، مثل علامة الجمع والأرقام، يحافظ على اتساق التنسيق.
اذكر ما هو اختياري
بالنسبة إلى الحقول الاختيارية، اذكر متى ينبغي تخطيها. إخبار النموذج بتركها فارغة لاستخدام القيمة الافتراضية يقلل القيم غير الضرورية.
اجعله موجزًا
تتفوق جملة واضحة واحدة على فقرة كاملة. ويكون الوصف المركّز أسهل على النموذج في اتباعه وأقل تكلفة من حيث الرموز.
صِف النموذج أيضًا
يصف docstring قصير على صنف النموذج الإدخال بالكامل، ويمنح الذكاء الاصطناعي سياقًا مفيدًا قبل الحقول الفردية.
class Weather(BaseModel):
"""Inputs for a weather lookup."""
city: strالأوصاف تدعم المخطط
يصل كل وصف إلى مخطط JSON الذي يرسله العميل إلى النموذج، ولذلك يؤثر تحسين كتابتها مباشرةً في استدعاءات الأدوات.
حسّن الصياغة تكراريًا
إذا استمر النموذج في ملء حقل بطريقة خاطئة، فعادةً ما يكون الحل في الوصف: حسّن صياغته حتى تصبح الاستدعاءات صحيحة.
فحص سريع
إلى أين يصل وصف Field، ولماذا يهم ذلك؟
مراجعة
اكتب أوصافًا موجزة للحقول، تتضمن أمثلة ووحدات وتنسيقات. تصل هذه الأوصاف إلى النموذج داخل المخطط وتوجّهه نحو الاستدعاءات الصحيحة. ✅
تعلم Python مع معلم ذكاء اصطناعي — مجانًا
اكتب وقم بتشغيل أكوادك الفعلية في المتصفح، واحصل على مساعدة فورية من معلم ذكاء اصطناعي متاح 24/7، واستمر من حيث توقفت على الويب أو في التطبيق.
- الدورات
- 30
- الدروس
- 120
الأسئلة الشائعة
هل درس «أوصاف الحقول التي ترشد النموذج» مجاني؟
نعم — نص درس «أوصاف الحقول التي ترشد النموذج» كامل متاح مجاناً هنا على الويب. لتمرينه بشكل تفاعلي (محرر أكواد مدمج ومدرس ذكاء اصطناعي متاح 24/7) وفتح باقي دورة MCP Academy، انتقل إلى CoddyKit PRO. تتضمن دورة MCP Academy 4 دروس في المجموع.
ماذا ستتعلم في «أوصاف الحقول التي ترشد النموذج»؟
وثّقوا كل حقل لكي يملأه الذكاء الاصطناعي بصورة صحيحة. تتمرن على MCP Academy مع أكواد عملية تشغلها مباشرة في المتصفح، ومدرس ذكاء اصطناعي متاح 24/7 يجيب على أسئلتك أثناء عملك.
هل أحتاج إلى خبرة سابقة لأبدأ MCP Academy؟
لا تُشترط خبرة سابقة. MCP Academy على CoddyKit منظم للمبتدئين حتى المتقدمين، لذا يمكنك البدء من هنا أو من البداية والتقدم بسرعتك الخاصة. هذا هو الدرس 4 من أصل 4.
كم من الوقت يستغرق درس «أوصاف الحقول التي ترشد النموذج»؟
معظم دروس CoddyKit تستغرق حوالي 5–10 دقائق. كل منها موجز وتفاعلي، لذا تحرز تقدماً مستمراً وتستأنف من حيث توقفت عبر الويب والتطبيق.
هل يمكنني كتابة وتشغيل أكواد في درس MCP Academy هذا؟
نعم. كل درس في MCP Academy يتضمن محرر أكواد مدمج، لذا تكتب وتشغل أكواداً حقيقية مباشرة في متصفحك وتحصل على تعليقات فورية من الذكاء الاصطناعي — بدون إعداد محلي.
جميع الدروس في هذه الدورة
- لماذا تتفوق المخططات على المعلمات غير المنظمة
- مدخلات النموذج باستخدام Pydantic
- القيود والقيم الافتراضية والتعدادات
- أوصاف الحقول التي ترشد النموذج