تسجيل أول تعليمة
أضيفوا مُزخرفًا إلى دالة لنشر تعليمة.
تسجيل أول تعليمة درس مجاني في MCP Academy على CoddyKit. هذا هو الدرس 1 من أصل 4. يمكنك قراءة الدرس كاملاً أدناه مجاناً — ثم تمرن عليه مباشرة في المتصفح باستخدام محرر أكواد مدمج ومدرس ذكاء اصطناعي متاح 24/7. هذا الدرس جزء من مسار التعلم في MCP Academy، وتقدمك يتزامن عبر الويب وتطبيق CoddyKit. تتضمن دورة MCP Academy 4 دروس في المجموع.
المطالبة الأولى
حان وقت نشر مطالبة: قالب قابل لإعادة الاستخدام يشغّله المستخدم ويبدأ مهمة بصياغة متقنة في كل مرة. 💬
المزخرف
تحوّل دالة Python عادية إلى مطالبة باستخدام مزخرف @mcp.prompt()، تمامًا كما وضعت علامة على الأدوات باستخدام @mcp.tool().
@mcp.prompt()
def greet() -> str:
return "Say hello warmly."يأتي الاسم من الدالة
يكون اسم المطالبة افتراضيًا هو اسم الدالة. ويعرض العملاء هذا الاسم في قائمة الأوامر المسبوقة بشرطة مائلة، لذا اجعله قصيرًا وواضحًا.
القيمة المعادة
تعيد أبسط مطالبة سلسلة. ويصبح هذا النص رسالة المستخدم الافتتاحية التي تُسلَّم إلى النموذج عند اختيار المطالبة.
إضافة وصف
يصبح docstring الخاص بالدالة وصف المطالبة. وهو يخبر المستخدم بالغرض من المطالبة قبل تشغيلها.
@mcp.prompt()
def greet() -> str:
"""Start a friendly greeting."""
return "Say hello warmly."يشغّلها المستخدم لا تلقائيًا
على خلاف الأدوات، لا تعمل المطالبة إلا عندما يختارها المستخدم صراحةً. ولا يستدعي النموذج المطالبة من تلقاء نفسه.
تعيش على الخادم
تُسجَّل مطالبتك على مثيل خادم FastMCP نفسه الذي يحتوي على أدواتك ومواردك. خادم واحد وثلاثة أنواع من العناصر الأساسية.
mcp = FastMCP("my-server")
@mcp.prompt()
def greet() -> str:
return "Say hello warmly."يمكن للعملاء عرضها
بعد تسجيلها، يستدعي العملاء prompts/list لاكتشافها. وهكذا يملأ المضيف قائمة أوامر الشرطة المائلة أو قائمة القوالب.
اخترها واحصل على الرسالة
عندما يختار المستخدم مطالبتك، يجلبها المضيف ويبدأ المحادثة بالنص الذي أعدته. وهكذا يبدأ المستخدم من افتتاحية متقنة.
حافظ على تركيز النص
يقدّم نص المطالبة الجيد تعليمات واضحة للنموذج، لا جدارًا من الخيارات. حدّد الهدف والنبرة، ثم توقف.
لماذا نهتم بها
توفّر المطالبة المسجّلة على الجميع إعادة كتابة الطلب نفسه، وتحافظ على اتساق الصياغة عبر الفريق بأكمله. ✨
تحقق سريع
لنتحقق من كيفية تسجيل المطالبات.
مراجعة: المطالبة الأولى
عمل رائع! ينشر مزخرف @mcp.prompt() دالةً بوصفها قالبًا يشغّله المستخدم، مع عرض اسمها وdocstring الخاص بها للمستخدمين. ✅
الأسئلة الشائعة
هل درس «تسجيل أول تعليمة» مجاني؟
نعم — نص درس «تسجيل أول تعليمة» كامل متاح مجاناً هنا على الويب. لتمرينه بشكل تفاعلي (محرر أكواد مدمج ومدرس ذكاء اصطناعي متاح 24/7) وفتح باقي دورة MCP Academy، انتقل إلى CoddyKit PRO. تتضمن دورة MCP Academy 4 دروس في المجموع.
ماذا ستتعلم في «تسجيل أول تعليمة»؟
أضيفوا مُزخرفًا إلى دالة لنشر تعليمة. تتمرن على MCP Academy مع أكواد عملية تشغلها مباشرة في المتصفح، ومدرس ذكاء اصطناعي متاح 24/7 يجيب على أسئلتك أثناء عملك.
هل أحتاج إلى خبرة سابقة لأبدأ MCP Academy؟
لا تُشترط خبرة سابقة. MCP Academy على CoddyKit منظم للمبتدئين حتى المتقدمين، لذا يمكنك البدء من هنا أو من البداية والتقدم بسرعتك الخاصة. هذا هو الدرس 1 من أصل 4.
كم من الوقت يستغرق درس «تسجيل أول تعليمة»؟
معظم دروس CoddyKit تستغرق حوالي 5–10 دقائق. كل منها موجز وتفاعلي، لذا تحرز تقدماً مستمراً وتستأنف من حيث توقفت عبر الويب والتطبيق.
هل يمكنني كتابة وتشغيل أكواد في درس MCP Academy هذا؟
نعم. كل درس في MCP Academy يتضمن محرر أكواد مدمج، لذا تكتب وتشغل أكواداً حقيقية مباشرة في متصفحك وتحصل على تعليقات فورية من الذكاء الاصطناعي — بدون إعداد محلي.