إضافة المهارات

أظهرت الصفحة السابقة كيف تسمح الأدوات للوكلاء بالتصرف — استدعاء الوظائف، والاستعلام عن واجهات برمجة التطبيقات، والبحث في الويب. ولكن أثناء بناء المزيد من العوامل، يظهر نمط: نفس مجموعة الأدوات والتعليمات والمواد المرجعية تظهر معا. إن إمكانية "تقديم تقرير مصروفات" ليست مجرد أداة واحدة ، بل هي برنامج نصي للتحقق من الصحة، ومجموعة من مستندات النهج، وإرشادات خطوة بخطوة حول كيفية ملء النموذج، والمعرفة حول حدود الإنفاق. ينتهي بك الأمر إلى نسخ هذه الحزمة من عامل إلى وكيل، وتبتعد عن المزامنة.

المهارات تحل هذه المشكلة. المهارة هي حزمة محمولة تجمع التعليمات والمواد المرجعية والبرامج النصية الاختيارية في وحدة واحدة يمكن لأي عامل اكتشافها وتحميلها عند الطلب. تتبع المهارات مواصفات مفتوحة حتى تكون قابلة لإعادة الاستخدام عبر الوكلاء والفرق وحتى المنتجات.

متى يتم استخدام هذا

أضف المهارات إلى وكيلك عندما:

• لديك مجموعة من المعرفة ذات الصلة — الإرشادات والمستندات المرجعية والبرامج النصية — التي تنتمي منطقيا معا (على سبيل المثال، "تقارير المصروفات" أو "إرشادات مراجعة التعليمات البرمجية").
• يحتاج العديد من الوكلاء إلى نفس الخبرة في المجال وتريد مصدرا واحدا للحقيقة بدلا من التعليمات المكررة.
• تريد مشاركة قدرات الوكيل وتوزيعها عبر الفرق أو المشاريع أو المؤسسات كحزم قائمة بذاتها.
• تحتاج إلى إدارة السياق بكفاءة - تستخدم المهارات الكشف التدريجي حتى يقوم الوكلاء بتحميل التفاصيل التي يحتاجونها فقط، عندما يحتاجون إليها.

الاعتبارات

الاعتبار	التفاصيل
إمكانية إعادة الاستخدام	المهارة هي حزمة قائمة بذاتها. بمجرد الإنشاء، يمكن لأي عامل التقاطه — لا يوجد لصق نسخ، ولا انحراف بين النسخ.
كفاءة السياق	استخدام المهارات الكشف التدريجي: يرى العامل وصفا موجزا (~100 رمز مميز) مقدما ويحمل التعليمات الكاملة فقط عند الاقتضاء. هذا يحافظ على نافذة السياق تميل عندما لا تكون هناك حاجة إلى المهارة.
تكلفة التجريد	تضيف المهارات طبقة تجريد فوق الأدوات. بالنسبة إلى أداة دالة واحدة مستقلة، تعد إضافة برنامج تضمين مهارة حملا غير ضروري.
جهد التصميم	تحتاج إلى التفكير في حدود المهارة مقدما: ما ينتمي داخل المهارة وما يبقى خارجها. تؤدي الحدود الضعيفة إلى مهارات واسعة جدا (سياق هزال) أو ضيقة جدا (فقدان فائدة التجميع).

كيف تختلف المهارات عن الأدوات

الأدوات والمهارات متكاملة وليست منافسة. يساعدك فهم التمييز على تحديد وقت الوصول لكل منها.

الأداة هي إجراء واحد قابل للاستدعاء - دالة واحدة باسم ووصف ومخطط معلمة. عندما يقرر النموذج أن هناك حاجة إلى أداة، فإنه ينشئ استدعاء منظما، وتنفيذ إطار عمل العامل لها، والنتيجة تعود إلى النموذج. الأدوات هي ذرات سلوك العامل.

المهارة هي حزمة من الخبرة في المجال. بإمكانها أن تتضمن:

• الإرشادات — إرشادات خطوة بخطوة وقواعد القرار والأمثلة التي تخبر العامل بكيفية التعامل مع مجال.
• المواد المرجعية - مستندات النهج والأسئلة المتداولة والقوالب والمعرفة الأخرى التي يمكن للعامل استشارتها عند الطلب.
• البرامج النصية — التعليمات البرمجية القابلة للتنفيذ التي يمكن للعامل تشغيلها لتنفيذ عمليات معينة (على سبيل المثال، برنامج نصي للتحقق من الصحة يتحقق من بيانات المصروفات مقابل قواعد النهج).

الفرق الرئيسي هو واحد من النطاق: أداة تعطي العامل القدرة على تنفيذ إجراء واحد؛ تمنح المهارة العامل المعرفة والموارد للتعامل مع مجال بأكمله.

	الأداة	المهارة
ما الذي تقدمه	إجراء واحد قابل للاستدعاء	إرشادات + مادة مرجعية + برامج نصية اختيارية
كيفية استخدام العامل له	يستدعيه عندما يحتاج إلى التصرف	تحميله عندما يواجه مهمة ذات صلة، ويقرأ التعليمات، وقد يستدعي البرامج النصية أو يستشير الموارد
تكلفة السياق	مخطط الأداة دائما في المطالبة	يوجد فقط اسم المهارة ووصفها (~100 رمز مميز) في المطالبة؛ يتم تحميل المحتوى الكامل عند الطلب
قابلية النقل	مرتبط بالعامل الذي يسجله	الحزمة المكتفية ذاتيا التي يمكن لأي عامل متوافق اكتشافها
الأفضل ل	الإجراءات الفردية (الاستعلام عن قاعدة بيانات، إرسال بريد إلكتروني)	خبرة المجال (نهج المصروفات، وإرشادات مراجعة التعليمات البرمجية، وإجراءات الإعداد)

Tip

فكر في الأدوات كأفعال (البحث والكتاب والتحقق من الصحة) والمهارات كخبرة (معرفة بحجز السفر، ومعرفة سياسة المصروفات). يستخدم العامل أدوات للتصرف والمهارات لمعرفة كيفية التصرف.

كيفية عمل المهارات: الكشف التدريجي

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

┌──────────────────────────────────────────────────────────────────┐
│  Stage 1: Advertise                                              │
│  Agent sees skill names and descriptions (~100 tokens each)      │
│  in its system prompt at the start of every run.                 │
└──────────────┬───────────────────────────────────────────────────┘
               ▼ (task matches a skill's domain)
┌──────────────────────────────────────────────────────────────────┐
│  Stage 2: Load                                                   │
│  Agent calls load_skill to get the full instructions             │
│  (< 5000 tokens recommended).                                   │
└──────────────┬───────────────────────────────────────────────────┘
               ▼ (agent needs more detail)
┌──────────────────────────────────────────────────────────────────┐
│  Stage 3: Read resources                                         │
│  Agent calls read_skill_resource to fetch supplementary files    │
│  (FAQs, templates, reference docs) only when needed.            │
└──────────────────────────────────────────────────────────────────┘

يعني هذا النمط أن الوكيل الذي يمتلك 10 مهارات مسجلة يدفع ما يقرب من 1000 رمز مميز للنفقات العامة للسياق - وليس 50000. يعمق العامل معرفته فقط عندما تتطلب المهمة الحالية ذلك.

بالإضافة إلى ذلك، يتم بناء المهارات على رأس البنية الأساسية للأداة. يعلن إطار عمل العامل عن المهارات المتوفرة في مطالبة نظام العامل، ثم يعرض load_skill و read_skill_resource كأداة يستدعيها العامل لتحميل المحتوى تدريجيا.

Tip

للحصول على التفاصيل الكاملة حول بنية المهارة والإعداد وأمثلة التعليمات البرمجية، راجع مرجع مهارات العامل .

متى تستخدم المهارات مقابل أنماط أخرى

مع نمو وكيلك بقدرة أكبر، لديك عدة طرق لتنظيم سلوكه. فيما يلي كيفية مقارنة المهارات بالأدوات:

النمط	الأفضل ل	Example
الأدوات الفردية	إجراءات لمرة واحدة لا تحتاج إلى سياق مشترك	get_weather أداة دالة
المهارات	خبرة المجال مع الإرشادات والمراجع والبرامج النصية الاختيارية	مهارة "تقرير المصروفات" مع مستندات النهج والبرامج النصية للتحقق من الصحة وتعليمات الإيداع خطوة بخطوة

المزالق الشائعة

شرك	Guidance
مهارات واسعة للغاية	مهارة تسمى "كل شيء حول التمويل" التي تحاول تغطية المحاسبة والضرائب وتقارير المصروفات وكشوف المرتبات سيكون لها تعليمات طويلة جدا وغير مركزة. الحفاظ على تركيز المهارات على مجال واحد.
تخطي مراجعة الأمان	يتم إدخال إرشادات المهارة في سياق العامل وتنفذ البرامج النصية التعليمات البرمجية. تعامل مع المهارات مثل تبعيات الجهات الخارجية — راجعها قبل النشر. راجع أفضل ممارسات الأمان في مرجع المهارات.
تجاهل الكشف التدريجي	إذا كان طولك SKILL.md 2000 سطر، يدفع العامل تكلفة سياق ثقيلة عندما يقوم بتحميل المهارة. احتفظ بالإرشادات موجزة وانقل المواد المرجعية التفصيلية لفصل ملفات الموارد للاستفادة الكاملة من الكشف التدريجي.

الخطوات التالية

بمجرد أن يكون لدى وكيلك أدوات ومهارات، فإن الخطوة التالية هي إضافة برامج وسيطة — سلوكيات شاملة مثل حواجز الحماية والتسجيل وتصفية المحتوى التي تنطبق على كل تفاعل دون تعديل المنطق الأساسي لوكيلك.

إضافة برنامج وسيط

انتقل إلى أبعد من ذلك:

• مهارات العامل - مرجع كامل مع الإعداد وأمثلة التعليمات البرمجية والبرامج النصية وإرشادات الأمان
• مواصفات مهارات العامل - المعيار المفتوح وراء المهارات
• نظرة عامة على الأدوات - جميع أنواع الأدوات ومصفوفة دعم الموفر