إشعار
يتطلب الوصول إلى هذه الصفحة تخويلاً. يمكنك محاولة تسجيل الدخول أو تغيير الدلائل.
يتطلب الوصول إلى هذه الصفحة تخويلاً. يمكنك محاولة تغيير الدلائل.
في هذا الدرس، تنشئ مهارة مخصصة تضيف معرفة المجال وكتيبات المهام إلى وكيلك. المهارات هي قدرات معيارية يقوم وكيلك بتحميلها تلقائيا عند الضرورة، مثل استكشاف خدمة معينة أو إجراء تشخيصي.
في هذا البرنامج التعليمي، تتعلم كيفية:
- إنشاء مهارة في منشئ الوكيل الفرعي
- اكتب تعليمات المهارات في SKILL.md
- إضافة ملفات وأدوات داعمة
- اختبر المهارة في الدردشة أو في ساحة اللعب
- تعديل مهارة موجودة
الوقت المقدر: 10 دقائق
نصيحة
تعمل وثائق المهارات والمعرفة معا. المهارة تعلم وكيلك كيفية القيام بشيء ما (الإجراءات، دفاتر اللعب، التعليمات خطوة بخطوة). وثيقة المعرفة تعلم وكيلك ما يحتاج معرفته (بيانات مرجعية، وثائق العمارة، دفاتر تشغيل). يمكنك أيضا إرفاق مستندات المراجع مباشرة إلى مهارة كملفات داعمة. لتدفق رفع المعرفة، انظر رفع مستندات المعرفة.
المتطلبات المسبقه
قبل أن تبدأ، تأكد من أن لديك المتطلبات التالية:
- وكيل تم إنشاؤه في بوابة Azure SRE Agent.
- فهم واضح للإجراء أو المعرفة بالمجال الذي تريد ترميزه.
التنقل إلى منشئ الوكيل الفرعي
افتح منشئ الوكلاء الفرعيين حيث تنشئ وتدير المهارات.
- افتح بوابة وكيل SRE.
- اختر وكيلك.
- اختر Builder في التنقل الأيسر.
- اختر منشئ الوكيل الفرعي.
ابدأ في إنشاء المهارات
ابدأ عملية إنشاء المهارات من شريط الأدوات.
- اختر قائمة الإنشاء المنسدلة في شريط الأدوات.
- اختر المهارة.
يبدأ حوار إنشاء المهارات بتخطيط من عمودين. حقول النماذج على جانب ومحرر كود على الجانب الآخر يعرض SKILL.md.
أدخل الاسم والوصف
قدم اسما ووصفا لمساعدة الوكيل في تحديد متى يستخدم هذه المهارة.
| الحقل | قيمة المثال |
|---|---|
| الاسم | high-cpu-troubleshooting |
| الوصف | "إجراء استكشاف أخطاء تنبيهات عالية في تطبيقات الحاويات. يتحقق من التبعيات في المراحل الأولى، ومجموعة الاتصالات، والنشرات الأخيرة." |
يجب أن يكون الاسم فريدا حسب مهاراتك. يظهر الوصف في قائمة المهارات ويساعد العميل في تحديد متى يستخدم هذه المهارة.
نصيحة
اختر تعديل بجانب نص الوصف للانتقال إلى وضع التحرير. حدد حفظ عند الانتهاء.
تعليمات كتابة المهارات
يعرض SKILL.mdمحرر المركز ، الذي يحتوي على تعليمات المهارة. يبدأ الملف بقالب افتراضي.
---
name:
description:
---
<!-- Add your skill instructions here -->
المادة الأمامية في YAML (name, description, tools) تبقى متزامنة مع حقول النماذج على اليسار. اكتب تعليماتك في ماركداون أسفل الموضوع الأمامي:
---
name: high-cpu-troubleshooting
description: Troubleshooting procedure for high CPU alerts on container apps
tools:
- kusto_query
---
## When to use this skill
Use this skill when you receive a high CPU alert on any container app.
## Steps
1. Check upstream dependencies for cascading failures
2. Query connection pool metrics for the last hour
3. Review deployments in the last 24 hours
4. If a recent deployment correlates with CPU spike, identify the commit
5. Recommend rollback or fix based on findings
## Expected output
Structured report with: affected resource, root cause, recommended action, and evidence.
إضافة ملفات داعمة
قسم الملفات على جانب واحد يعرض متصفح ملفات. بعيدا عن الوضع الافتراضي SKILL.md، يمكنك إضافة بيانات مرجعية، قوالب، واستعلامات أمثلة.
- اختر أيقونة الملف الجديد لإضافة الملفات.
- اختر أيقونة المجلد الجديد لتنظيم الملفات في مجلدات.
- اسحب وأفلت مجلد في منطقة الإسقاط، أو اختر رابط مجلد الرفع لرفع هيكل المجلد بالكامل.
اختر أي ملف في المتصفح لتحريره في محرر الكود. يدعم المحرر تمييز الصياغة لبرمجيات ماركداون، JSON، YAML، KQL، بايثون، وسكريبتات الشيل.
اختيار الأدوات
اختياريا، يمكنك إرفاق الأدوات التي تستخدمها المهارة أثناء التنفيذ.
- اختر الأدوات في قسم الأدوات .
- تصفح أو ابحث عن الأدوات. تصفية حسب النوع (أداة مخصصة، أداة MCP) أو ابحث بالاسم.
- تحقق من الأدوات التي تحتاجها هذه المهارة (على سبيل المثال،
kusto_queryأوazure_resource_health). - أغلق اللوحة.
تظهر الأدوات المختارة كحبوب قابلة للإزالة. تكون هذه الأدوات متاحة ديناميكيا عند تفعيل المهارة.
ملحوظة
الأدوات المضافة إلى المهارة تكون متاحة ديناميكيا عند تفعيل المهارة. للحصول على سلوك أكثر اتساقا، قم بتكوين الأدوات مباشرة على الوكيل الفرعي بدلا من ذلك.
لإنشاء أدوات مخصصة، راجع إنشاء أداة Kusto أو إنشاء أداة بايثون. لمزيد من المعلومات حول الأدوات، راجع الأدوات.
اصنع المهارة
اختر إنشاء لحفظ مهارتك.
تظهر مهارتك في تبويب المهارات على منشئ الوكلاء الفرعيين. يمكن للوكيل الآن استخدام المهارة تلقائيا عند مواجهة موقف مهم.
اختبر المهارة
يمكن للوكيل الرئيسي استخدام المهارات بشكل افتراضي، لذا يمكنك اختبارها مباشرة في الدردشة دون إنشاء وكيل فرعي أولا.
اختبر في دردشة جديدة
استخدم موضوع دردشة جديد للتحقق من أن الوكيل يفعل مهارتك.
- اختر موضوع محادثة جديد في الشريط الجانبي.
- اكتب رسالة يجب أن تفعل مهارتك. على سبيل المثال: "نرى ارتفاع في وحدة المعالجة المركزية في تطبيق الحاويات لدينا، هل يمكنكم التحقيق في ذلك؟"
- تحقق من أن الوكيل يفعل المهارة ويتبع الإجراءات التي حددتها.
اختبار في ساحة اللعب
استخدم الملعب لاختبار المهارة من خلال وكيل فرعي.
- أنشئ وكيلا فرعيا وخصص له هذه المهارة أيضا.
- في شريط أدوات بناء الوكلاء الفرعيين، اختر مفتاح عرض ملعب الاختبار .
- اختر الوكيل الفرعي، واكتب طلب اختبار، وتحقق من استخدامه للمهارة بشكل صحيح.
لمزيد من المعلومات، راجع ملعب الوكلاء.
تعديل مهارة
يمكنك تعديل مهارة موجودة لتحديث تعليماتها أو أدواتها أو ملفاتها الداعمة.
في تبويب المهارات ، اختر اسم المهارة أو حدده واختر تعديل.
يفتح حوار التحرير مع تعبئة جميع القيم الحالية مسبقا. غير الحقول التي تحتاجها:
ما الذي يجب تغييره أين يمكن التحديث عندما يستخدمه الوكيل الوصف وتعليمات SKILL.md ما هي الإجراءات التي يجب اتباعها SKILL.md المحتوى في المحرر ما هي الأدوات المتاحة الأدوات> اختر الأدوات البيانات المرجعية الملفات> إضافة أو تحرير أو إزالة الملفات حَدِّد حِفظ.
نصائح لمهارات الكتابة الفعالة
استخدم الإرشادات التالية لتطوير مهارات يمكن لوكيلك استخدامها بفعالية.
- كن محددا في متى تستخدمه. يقرأ الوكيل الوصف والتعليمات ليقرر مدى أهميتها.
- أدرج إجراءات خطوة بخطوة. الخطوات المرقمة تعطي العميل كتاب لعب واضح.
- حدد الإخراج المتوقع. أخبر الوكيل بأي شكل يجب أن تأخذ النتائج.
- أضف بيانات مرجعية. رفع قوالب الاستعلام، أو خطوط التكوين الأساسية، أو القيم المعروفة بجودة كملفات داعمة.
- خصص الأدوات ذات الصلة. إذا كانت المهارة تحتاج إلى أدوات محددة مثل استعلامات Kusto أو إجراءات Azure، أضفها.