دليل الدخل بالوكلاءموارد عامة مجانية
中文 EN العربية

متى تستخدم Skill أو MCP

توفر Skill تعليمات قابلة لإعادة الاستخدام؛ ويعرض MCP موارد الخادم أو أدواته. اختر حسب حاجة المهمة إلى إرشاد أو معلومات للقراءة فقط أو إجراء.

تاريخ المراجعة · 2026-10-15 · تحديث المحتوى · 2026-10-15

الإجابة المباشرة

توفر Skill تعليمات قابلة لإعادة الاستخدام؛ ويعرض MCP موارد الخادم أو أدواته. اختر حسب حاجة المهمة إلى إرشاد أو معلومات للقراءة فقط أو إجراء. العقد: تعيد inventory_lookup(sku) كمية صحيحة وas_of بتوقيت UTC. يعيد A-17 العدد 8 وB-04 العدد 0. لا يبرر الاستعلام صلاحية كتابة.

اتخاذ القرار

توفر Skill تعليمات قابلة لإعادة الاستخدام؛ ويعرض MCP موارد الخادم أو أدواته. اختر حسب حاجة المهمة إلى إرشاد أو معلومات للقراءة فقط أو إجراء.

مثال تطبيقي

العقد: تعيد inventory_lookup(sku) كمية صحيحة وas_of بتوقيت UTC. يعيد A-17 العدد 8 وB-04 العدد 0. لا يبرر الاستعلام صلاحية كتابة.

فحوص الإخفاق

افحص الهوية والتفويض والمخطط والأخطاء. ارفض المعاملات المجهولة والنتائج القديمة ولا تحول الخطأ إلى مخزون صفر.

مثال محلي وسير قبول ناتج الوكيل

قارن إدخال المثال بالناتج وقواعد التحقق.

نص الإدخال

راجع مثالي المخزون للقراءة فقط وفق العقد الخيالي أدناه. احتفظ بالكمية صفر وبوقت العينة في كل نتيجة.

tool: inventory_lookup(sku: string)
returns: {sku: string, quantity: integer, as_of: UTC timestamp}
required_params: ["sku:string"]

sample_results:
  - {sku: "A-17", quantity: 8, as_of: "2026-10-15T09:00:00Z"}
  - {sku: "B-04", quantity: 0, as_of: "2026-10-15T09:00:00Z"}

rejection_rule: reject unknown fields

توجيه لواجهة وكيل تستخدمها بالفعل

راجع عقد القراءة فقط وأعد حقول JSON: tool_name وread_only وrequired_params وsample_results وrejection_rule؛ واحتفظ بطابع as_of في كل عنصر من sample_results. لا تستدعِ خادماً ولا تدّع أن المخزون مباشر.

الناتج المتوقع

{
  "tool_name": "inventory_lookup",
  "read_only": true,
  "required_params": [
    "sku:string"
  ],
  "sample_results": [
    {
      "sku": "A-17",
      "quantity": 8,
      "as_of": "2026-10-15T09:00:00Z"
    },
    {
      "sku": "B-04",
      "quantity": 0,
      "as_of": "2026-10-15T09:00:00Z"
    }
  ],
  "rejection_rule": "reject unknown fields"
}

قواعد التحقق المحلية

الموارد المختارة

بناء MCP: إنشاء خدمات MCP

سبب الاختيار: يرشد المطور إلى إتاحة API خارجية كأدوات MCP واضحة وقابلة للاكتشاف والتحقق.

متى لا يناسب: لا تعِد بناء الخادم عندما تستدعي المهمة استعلاماً موجوداً للقراءة فقط.

anthropics/skills · skills/mcp-builder/SKILL.md · 2026-10-13

مراجعة أدوات MCP وآثارها الجانبية قبل استخدامها من الوكيل

سبب الاختيار: افحص الأسماء والأوصاف والمخططات والصلاحيات والآثار الجانبية قبل إتاحة أدوات MCP بعيدة للوكيل.

متى لا يناسب: استخدم دليلاً لبناء الخادم إذا لم يكن لدى العميل خادم لفحصه.

modelcontextprotocol/python-sdk · docs/servers/tools.md · 2026-10-14

تعريف عقد أخطاء ثابت لأدوات MCP

سبب الاختيار: ميّز بين الأعطال القابلة لإعادة المحاولة ورفض المدخلات والأعطال الداخلية دون كشف أسرار الخادم.

متى لا يناسب: لا تحتاج قراءة مورد ثابت إلى عقد أخطاء أداة قابلة للاستدعاء.

modelcontextprotocol/python-sdk · docs/servers/handling-errors.md · 2026-10-14

إتاحة مستندات للقراءة فقط بإصدارات عبر معرّفات موارد MCP

سبب الاختيار: إتاحة المستندات كموارد ذات معرفات ثابتة ليكتشفها العملاء ويقرؤوها دون صلاحية كتابة.

متى لا يناسب: يركز هذا الإجراء على موارد المستندات الثابتة. اخترنا أداة استعلام في المثال لأن المخزون يتغير ويحتاج إلى قيمة as_of حديثة؛ هذا اختيار للمهمة وليس حظراً بروتوكولياً للموارد الديناميكية.

modelcontextprotocol/python-sdk · docs/servers/resources.md · 2026-10-14

تعريف أداة دالة معتمدة للوكيل

سبب الاختيار: إتاحة دالة تطبيق محدودة كأداة ذات عقد معاملات واضح.

متى لا يناسب: إذا كانت المهمة تقرأ Skill أو مورداً ثابتاً فقط فلا حاجة إلى مخطط أداة.

openai/openai-agents-python · docs/tools.md · 2026-10-14

المصادر وتواريخ المراجعة