مخططات المخرجات للعملاء
انشروا البنية لكي يتمكن المستهلكون من الاعتماد عليها.
مخططات المخرجات للعملاء درس مجاني في MCP Academy على CoddyKit. هذا هو الدرس 3 من أصل 4. يمكنك قراءة الدرس كاملاً أدناه مجاناً — ثم تمرن عليه مباشرة في المتصفح باستخدام محرر أكواد مدمج ومدرس ذكاء اصطناعي متاح 24/7. هذا الدرس جزء من مسار التعلم في MCP Academy، وتقدمك يتزامن عبر الويب وتطبيق CoddyKit. تتضمن دورة MCP Academy 4 دروس في المجموع.
نشر البنية
يمكن للأداة المنظمة أيضًا الإعلان عن مخطط مخرَج: وهو JSON Schema يخبر العملاء بدقة بالحقول والأنواع المتوقعة.
ما هو مخطط المخرَج
هو وصف قابل للقراءة آليًا لنتيجتك، يسرد اسم كل حقل ونوعه. ويقرأه العملاء قبل استدعاء الأداة أصلًا.
يُنشأ من نموذجك
عندما تعيد نموذج Pydantic، يستنبط SDK مخطط المخرَج نيابةً عنك. وتصبح تلميحات الأنواع عقدًا منشورًا تلقائيًا.
أين يراه العملاء
يأتي المخطط مع قائمة الأدوات ضمن outputSchema. ويتعرّف العميل الذي يفحص الأدوات على البنية من دون التخمين والتجربة.
{"type": "object", "properties": {"temp_c": {"type": "number"}}}لماذا يريده العملاء
بوجود مخطط معروف، يستطيع العميل التحقق من النتائج وإنشاء واجهة المستخدم مسبقًا. فلا حاجة إلى التخمين بشأن الحقول التي ستظهر.
الأنواع تحمل المعنى
يحدد المخطط أن temp_c رقم وأن condition سلسلة نصية. ويستطيع المستهلكون الوثوق بهذه الأنواع بدل استنتاجها من عينة واحدة.
المطلوب مقابل الاختياري
تصبح الحقول ذات القيم الافتراضية اختياريةً في المخطط، بينما تكون الحقول الأخرى مطلوبة. ويتعرّف العملاء على المفاتيح المضمون وجودها.
class Weather(BaseModel):
temp_c: float
note: str = ""عقد مستقر
تعامل مع مخطط المخرَج بوصفه وعدًا. فعندما يعتمد عليه العملاء، قد يؤدي تغيير أسماء الحقول أو أنواعها إلى تعطيل ما لديهم لاحقًا.
المخططات تساعد على التحقق
يتحقق العملاء الصارمون من كل نتيجة مقابل المخطط ويرفضون حالات عدم التطابق. وهذا يكتشف أخطاء الخادم بسرعة عند الحد الفاصل مباشرةً.
أدوات توثّق نفسها
يعمل مخطط المخرَج أيضًا بوصفه توثيقًا. إذ يقرأ المطورون الجدد المخطط لفهم الأداة من دون التنقيب في شيفرتك.
حافظ على صدق المخططات
احرص على أن تعيد أداتك دائمًا ما يعلنه المخطط. فالنتيجة التي تنحرف عن مخططها تضعف ثقة العملاء بها.
تحقق سريع
أين تنشر الأداة بنية نتيجتها؟
مراجعة: مخططات المخرَجات
رأيتَ كيف تنشر الأداة مخطط مخرَج انطلاقًا من نموذجك. فهو يوثّق الحقول، ويتيح التحقق، ويشكّل عقدًا مستقرًا. ✅
تعلم Python مع معلم ذكاء اصطناعي — مجانًا
اكتب وقم بتشغيل أكوادك الفعلية في المتصفح، واحصل على مساعدة فورية من معلم ذكاء اصطناعي متاح 24/7، واستمر من حيث توقفت على الويب أو في التطبيق.
- الدورات
- 30
- الدروس
- 120
الأسئلة الشائعة
هل درس «مخططات المخرجات للعملاء» مجاني؟
نعم — نص درس «مخططات المخرجات للعملاء» كامل متاح مجاناً هنا على الويب. لتمرينه بشكل تفاعلي (محرر أكواد مدمج ومدرس ذكاء اصطناعي متاح 24/7) وفتح باقي دورة MCP Academy، انتقل إلى CoddyKit PRO. تتضمن دورة MCP Academy 4 دروس في المجموع.
ماذا ستتعلم في «مخططات المخرجات للعملاء»؟
انشروا البنية لكي يتمكن المستهلكون من الاعتماد عليها. تتمرن على MCP Academy مع أكواد عملية تشغلها مباشرة في المتصفح، ومدرس ذكاء اصطناعي متاح 24/7 يجيب على أسئلتك أثناء عملك.
هل أحتاج إلى خبرة سابقة لأبدأ MCP Academy؟
لا تُشترط خبرة سابقة. MCP Academy على CoddyKit منظم للمبتدئين حتى المتقدمين، لذا يمكنك البدء من هنا أو من البداية والتقدم بسرعتك الخاصة. هذا هو الدرس 3 من أصل 4.
كم من الوقت يستغرق درس «مخططات المخرجات للعملاء»؟
معظم دروس CoddyKit تستغرق حوالي 5–10 دقائق. كل منها موجز وتفاعلي، لذا تحرز تقدماً مستمراً وتستأنف من حيث توقفت عبر الويب والتطبيق.
هل يمكنني كتابة وتشغيل أكواد في درس MCP Academy هذا؟
نعم. كل درس في MCP Academy يتضمن محرر أكواد مدمج، لذا تكتب وتشغل أكواداً حقيقية مباشرة في متصفحك وتحصل على تعليقات فورية من الذكاء الاصطناعي — بدون إعداد محلي.
جميع الدروس في هذه الدورة
- المحتوى النصي في مقابل المنظم
- إرجاع كائن نتيجة مكتوب الأنواع
- مخططات المخرجات للعملاء
- إرجاع الصور والبيانات الثنائية