Custom agents in Azure SRE Agent

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

على عكس المهارات (التي تكون متاحة دائما)، يتطلب الوكلاء المخصصون استدعاء صريحا. يحدد هذا الشرط خبرتهم لمهام محددة.

كيف يعمل وكلاء التخصيص

استدعي وكيل مخصص باستخدام /agent أمر slash في الدردشة. يتلقى وكيل التخصيص السياق الكامل للمحادثة ويعمل بخبرة مركزة.

المثال التالي يوضح تعريفا أساسيا للوكيل المخصص:

name: database_expert
system_prompt: |
  You are a database specialist. Analyze query performance,
  diagnose connection issues, and recommend optimizations.
handoff_description: Handles SQL and database troubleshooting
tools:
  - execute_kusto_query
  - azure_cli
connectors:
  - azure_sql
enable_skills: true  # Can use skills for additional expertise

تشمل الخصائص الرئيسية:

• system_prompt: الشخصية الخبيرة والتعليمات.
• handoff_description: ما يراه المنسق عند اتخاذ قرار التفويض.
• tools: القدرات المتاحة.
• enable_skillsعند استخدام هذه الخاصية، يمكن للوكيل المخصص الوصول إلى المهارات بشكل ديناميكي.

نصيحة

المهارات تلقائية. وكيلك يستخدمها كلما كان ذلك مناسبا. الوكلاء المخصصون صريحون — تستدعيهم عندما /agent تحتاج إلى خبرة مركزة.

لماذا تستخدم وكلاء مخصصين

يتيح لك الوكلاء المخصصون تغليف خبرات المجال والأدوات والمعرفة لإعادة الاستخدام. بدلا من أن يحاول وكيلك الرئيسي التعامل مع كل شيء، يتم تفويض الأمر إلى المتخصصين.

فكر في مشكلة في قاعدة البيانات: بدون وكلاء مخصصين، يحاول وكيلك الرئيسي استكشاف أخطاء عامة. مع وكيل مخصص "خبير قواعد البيانات"، تحصل على خبرة SQL مركزة، ودفاتر تشغيل خاصة بقواعد البيانات، وأدوات مضبوطة لتحليل الاستعلامات.

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

إنشاء عامل مخصص

أنشئ وكلاء مخصصين في Builder > Agent Canvas.

1. اذهب إلى Azure SRE Agent الخاص بك في بوابة Azure.

2. اختر تبويب Agent Canvas .

3. حدد إنشاء.

4. اختر وكيل مخصص.

5. قدم القيم للإعدادات التالية:

   الخاصية	قيمة
   الاسم	أدخل اسما وصفيا لوكيلك المخصص.
   تعليمات	قدم تعليمات واضحة ومخصصة تحدد كيف يجب أن يتصرف الوكيل المخصص.
   وصف التسليم	اشرح السيناريوهات التي يجب فيها على الوكلاء المخصصين الآخرين نقل المعالجة إلى هذا الوكيل المخصص، ولماذا.
   الأدوات المخصصة (اختياري)	اختر أداة أو أكثر مخصصة ليستخدمها الوكيل المخصص أثناء عملياته.
   الأدوات المدمجة (اختيارية)	اختر أي أدوات نظام مدمجة تريد من الوكيل المخصص الوصول إليها.
   وكلاء التسليم (اختياري)	حدد أي وكيل مخصص يجب أن يتولى المعالجة بعد أن يكمل هذا الوكيل مهامه.

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

إدارة قاعدة المعرفة

عزز معرفة وكلائك المخصصين من خلال رفع الوثائق، ودفاتر التشغيل، والأدلة الإجرائية.

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

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

أنواع الملفات المعتمدة

الإجراءات التشغيلية بصيغة ماركداون (.md) أو نصية (.txt).

سير عمل إدارة الملفات

1. يمكنك الوصول إلى قاعدة المعرفة من خلال الذهاب إلى تبويب ملفات قاعدة > المعرفة الخاصة بالإعدادات>.
2. رفع الملفات عن طريق سحب وإفلات ملفاتك أو التصفح لاختيار الملفات (الحد الأقصى 50 ميجابايت لكل ملف).
3. نظم المحتوى بإضافة الوسوم والوصف لتحسين قابلية البحث.
4. تمكين الوصول إلى الوكيل المخصص عن طريق تحديد أي الوكلاء المخصصين يمكنهم الوصول إلى مصادر معرفة محددة.
5. راقب الاستخدام من خلال تتبع كيفية استخدام الوكلاء المخصصين للمعرفة المرفوعة في ردودهم.

ملحوظة

وكلاء التخصيص لديك يفهرسون تلقائيا ويجعلون الملفات التي ترفعها قابلة للبحث. يدعم النظام ما يصل إلى 1,000 ملف لكل نسخة من الوكيل المخصص.

مشاهد Agent Canvas

ابن وكلاء مخصصين في Builder>Agent Canvas. تتوفر طرق العرض التالية:

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

متى تستخدم الوكلاء المخصصين

يساعدك الجدول التالي في تحديد متى يكون الوكلاء المخصصون الخيار الصحيح:

السيناريو	هل تستخدم وكيل مخصص؟	لماذا
الخبرة العميقة في المجال المطلوب	‏‏نعم‬	اجمع خبرات SQL، ومعرفة الشبكات، وأفضل ممارسات الأمان
سير العمل متعدد الخطوات	‏‏نعم‬	فرز الحوادث، التحقق من النشر، التحقق من النسخ الاحتياطي
مجموعات الأدوات المتخصصة	‏‏نعم‬	أدوات خاصة بقواعد البيانات، أدوات تحسين التكلفة
العمليات الفردية البسيطة	لا.	استخدم المهارات بدلا من ذلك لإجراءات بسيطة وقابلة للتكرار
استعلامات القراءة فقط	لا.	يمكن للوكيل الرئيسي التعامل مع الأمر دون تفويض

لإعداد وكيل مخصص بالكامل، راجع استجابة الحوادث لأتمتة الاستجابة.

تسليم وكيل المخصصات

عندما يسلم وكيلك الرئيسي المهمة لوكيل مخصص، يشارك سياق محادثة واحد. يرى وكيل التخصيص المستقبل:

• سجل المحادثة الكامل: جميع الرسائل السابقة، مكالمات الأدوات، والنتائج.
• التفكير في المهام الفرعية: ما الذي يطلبه التسليم من هذا الوكيل المخصص أن يحققه.
• سؤال المستخدم الأصلي: تم الحفاظ عليه طوال سلسلة التسليم.

ملحوظة

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

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

أنماط الوكيل المخصص

الجدول التالي يصف أنماط الوكلاء المخصصين الشائعة:

النمط	أمثلة	حالة الاستخدام
خبير المجال	خبير VM، خبير AKS، خبير شبكات	خبرة عميقة في تقنية واحدة (جميع مشاكل الأجهزة الافتراضية، استكشاف أخطاء Kubernetes، VNet/NSG/موازن الأحمول)
أخصائي المهام	محلل سجلات، محسن التكلفة، ماسح الأمان	يركز على مهام محددة (تحليل السجلات، إيجاد المدخرات، تحديد الثغرات)
منفذ سير العمل	فرز الحوادث، مدقق النشر، التحقق الاحتياطي	إجراءات متعددة الخطوات (تصنيف الحوادث، فحوصات ما بعد النشر، اختبار سلامة النسخ الاحتياطي)

قارن المهارات، والوكلاء المخصصين، وملفات المعرفة

يقارن الجدول التالي كل مفهوم قابلية التوسعة:

الميزة	المهارات	وكلاء مخصصين	ملفات المعرفة
وصول	تلقائي	/agent أمر	عبر أداة الاستعلام عبر كيبورد
ادوات	يمكن الربط	لديه أدوات	لا أدوات
سياق	يستخدم سياق الخيوط	مشاركة سياق الموضوع	المراجع فقط
الأفضل ل	الإجراءات	متخصصو المجال	كتب الرن، الوثائق

استخدم الإرشادات التالية لاختيار النهج الصحيح:

• المهارة: إجراء على مستوى الفريق مع تنفيذ اختياري (دليل استكشاف أخطاء AKS + Azure CLI)
• وكيل مخصص: متخصص نطاق يتم استدعاؤه عند الطلب (PostgreSQL Expert)
• ملف المعرفة: محتوى مرجعي للسياق (وثائق العمارة)

ربط الوكلاء المخصصين بالمشغلات

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

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

أوضاع الوكيل المخصص

كل وكيل مخصص يعمل في وضع يتحكم في مقدار الاستقلالية التي يمتلكها. حدد الوضع لكل خطة استجابة أو مهمة مجدولة.

وضع	الوصف
استعراض	يقترح إجراءات، وينتظر الموافقة
الاستقلالية	الأفعال دون موافقة بشرية

اختر الوضع بناء على المخاطر:

• توصيات لتحسين التكاليف؟ استخدم المراجعة (يتطلب موافقة بشرية).
• أتمتة مختبرة جيدا؟ استخدم Autonomous (للعمليات الموثوقة).

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

اختبار وتطوير الوكلاء المخصصين

اختبر الوكلاء المخصصين في ساحة الاختبار قبل النشر. اذهب إلى Builder>Agent Canvas واختر اختبار الملعب من زر العرض. يتيح لك تخطيط الشاشة المنقسمة تعديل التعليمات على اليسار والاختبار في دردشة مباشرة على اليمين، مع تقييم مدعوم بالذكاء الاصطناعي لتقييم إعدادك.

بالنسبة لمستخدمي VS Code، تتيح إضافة خادم SRE Agent MCP تعديل YAML المخصص للوكيل في محررك مع مزامنة التغييرات مع وكيلك.

للتفاصيل الكاملة، انظر ملعب العميل.

المحتوى ذو الصلة

مورد	الوصف
المهارات	إجراءات وأدوات قابلة لإعادة الاستخدام لوكيلك
إرسال الإشعارات	أرسل نتائج التحقيق إلى Teams وOutlook والمزيد
دردشة من أدواتك	تفاعل مع وكيلك من خلال Teams، webhooks، والمزيد