تسمية الأداة ووصفها جيدًا
اكتبوا أوصافًا يستطيع النموذج التصرف بناءً عليها فعليًا.
تسمية الأداة ووصفها جيدًا درس مجاني في MCP Academy على CoddyKit. هذا هو الدرس 1 من أصل 4. يمكنك قراءة الدرس كاملاً أدناه مجاناً — ثم تمرن عليه مباشرة في المتصفح باستخدام محرر أكواد مدمج ومدرس ذكاء اصطناعي متاح 24/7. هذا الدرس جزء من مسار التعلم في MCP Academy، وتقدمك يتزامن عبر الويب وتطبيق CoddyKit. تتضمن دورة MCP Academy 4 دروس في المجموع.
يقرأ النموذج أولًا
قبل أن يشغّل الذكاء الاصطناعي أداتك، يقرأ اسمها ووصفها ليقرر ما إذا كانت هذه الأداة مناسبة للمهمة. 🧭
سمّها بصيغة فعل
يوضح اسم أداة MCP الجيدة ما تفعله للوهلة الأولى، مثل get_weather أو send_email. اجعله قصيرًا، وابدأ بفعل، وتجنب المفاجآت.
مصدر الاسم
في FastMCP، يكون اسم الأداة افتراضيًا هو اسم دالة Python، لذا سمِّ الدالة بعناية واستخدم snake_case.
@mcp.tool()
def get_weather(city: str) -> str:
...تجاوز الاسم
إذا لم يكن اسم الدالة مثاليًا، فمرّر اسمًا صريحًا إلى المصمم حتى يرى النموذج الاسم الذي تريده تمامًا.
@mcp.tool(name="get_weather")
def weather_lookup(city: str) -> str:
...الوصف مطالبة
يقرأ النموذج وصف الأداة على أنه إرشاد. تعامل معه كمطالبة صغيرة تخبر الذكاء الاصطناعي بموعد استدعاء هذه الأداة وسبب ذلك.
تصبح السلاسل التوثيقية أوصافًا
تحوّل FastMCP السلسلة التوثيقية لدالتك تلقائيًا إلى وصف الأداة، لذا اكتبها للنموذج، لا للبشر فقط.
@mcp.tool()
def get_weather(city: str) -> str:
"""Get the current weather for a city."""اذكر ما تعيده
يسمي الوصف الجيد المدخلات والناتج، حتى يعرف النموذج ما سيحصل عليه قبل أن يستدعي الأداة.
كن محددًا بشأن الحدود
اذكر الحدود في الوصف: أي المدن، وأي التنسيقات، وما الذي لا تستطيع الأداة تنفيذه. تمنع الحدود الواضحة النموذج من إساءة استخدام أداتك.
تجنب الأفعال المبهمة
لا تخبر كلمات مثل «يعالج» أو «يتعامل مع» النموذج بأي شيء. استخدم فعلًا دقيقًا حتى يميز الذكاء الاصطناعي أدواتك عند الاستدعاء.
أداة واحدة، ومهمة واحدة
اجعل كل أداة مركزة على مهمة واحدة. فالأداة المحددة ذات الاسم الواضح أسهل بكثير للنموذج في اختيارها بشكل صحيح من أداة تنفذ كل شيء.
اختبر الاسم بصوت عالٍ
اقرأ الاسم والسطر الأول من الوصف معًا. إذا عجز شخص غريب عن تخمين ما تفعله، فغالبًا سيعجز النموذج أيضًا.
تحقق سريع
من أين يحصل FastMCP افتراضيًا على وصف الأداة؟
مراجعة
يقرأ النموذج الاسم والوصف أولًا. استخدم أسماء تدل على الإجراء، وأوصافًا في السلاسل التوثيقية، وحدودًا واضحة كي يستدعي الذكاء الاصطناعي أداتك بشكل صحيح. ✅
تعلم Python مع معلم ذكاء اصطناعي — مجانًا
اكتب وقم بتشغيل أكوادك الفعلية في المتصفح، واحصل على مساعدة فورية من معلم ذكاء اصطناعي متاح 24/7، واستمر من حيث توقفت على الويب أو في التطبيق.
- الدورات
- 30
- الدروس
- 120
الأسئلة الشائعة
هل درس «تسمية الأداة ووصفها جيدًا» مجاني؟
نعم — نص درس «تسمية الأداة ووصفها جيدًا» كامل متاح مجاناً هنا على الويب. لتمرينه بشكل تفاعلي (محرر أكواد مدمج ومدرس ذكاء اصطناعي متاح 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 يتضمن محرر أكواد مدمج، لذا تكتب وتشغل أكواداً حقيقية مباشرة في متصفحك وتحصل على تعليقات فورية من الذكاء الاصطناعي — بدون إعداد محلي.
جميع الدروس في هذه الدورة
- تسمية الأداة ووصفها جيدًا
- تعريف المعلمات باستخدام تلميحات الأنواع
- إرجاع نتائج مفيدة
- أداة آلة حاسبة من البداية إلى النهاية