إشعار
يتطلب الوصول إلى هذه الصفحة تخويلاً. يمكنك محاولة تسجيل الدخول أو تغيير الدلائل.
يتطلب الوصول إلى هذه الصفحة تخويلاً. يمكنك محاولة تغيير الدلائل.
يأتي وكيلك مع وصول مدمج إلى خدمات Azure. يمكنه الاستعلام عن Azure Monitor وApplication Insights وLog Analytics وAzure Resource Graph مباشرة من العلبة. تمتد الموصلات إلى الأنظمة الخارجية: مجموعات Kusto الخاصة بك، مستودعات الشيفرة المصدرية، أدوات التعاون، وواجهات برمجة التطبيقات المخصصة.
ملحوظة
الموصلات مقابل منصات الحوادث
تمنح الموصلات وكيلك الوصول إلى البيانات والإجراءات، مثل الاستعلام في السجلات، إرسال الإشعارات، وقراءة الكود. منصات الحوادث مفهوم منفصل: تتحكم في مصدر التنبيهات وكيف يستجيب وكيلك تلقائيا.
تتناول هذه المقالة الموصلات. لمنصات الحوادث، انظر منصات الحوادث.
ما يمكن لوكيلك فعله بدون موصلات
حتى بدون إعدادات موصلات، يمتلك وكيل التأمين قدرات مدمجة من خلال هويته المدارة وأذونات Azure RBAC.
| القدرة المدمجة | ما الذي تقدمه |
|---|---|
| Application Insights | استعلام بيانات التطبيقات عن بعد، والتتبعات، والاستثناءات |
| Log Analytics | Query Log Analytics workspaces |
| Azure Monitor مقاييس | قم بإدراج واستعلام المقاييس، وتحليل الاتجاهات، والشذوذات |
| Azure Resource Graph | اكتشف واستعلام أي مورد Azure عبر الاشتراكات |
| Azure Resource Manager / Azure CLI | اقرأ وعدل أي نوع من موارد Azure |
| تشخيصات AKS | تشغيل أوامر kubectl، وتشخيص مشاكل Kubernetes |
تعمل عمليات Azure Resource Graph وAzure Resource Manager مع أي نوع من موارد Azure، بما في ذلك خدمات التطبيقات، تطبيقات الحاويات، الأجهزة الافتراضية، الشبكات، التخزين، والمزيد. إذا كانت سجلاتك ومقاييسك موجودة في Azure Monitor وApplication Insights، يمكن لوكيلك البدء في التحقيق في المشاكل فورا دون الحاجة إلى إعداد موصل. تصبح الموصلات ذات قيمة عندما تحتاج إلى الوكيل للوصول إلى الأنظمة outside Azure.
ما الذي توفره الموصلات
تنقسم الموصلات إلى أربع فئات بناء على ما تقدمه لوكيلك.
مصادر البيانات
استعلام سجلات البيانات والمقاييس والتليمترية من مخازن بياناتك.
| الموصل | ما الذي تقدمه |
|---|---|
| Log Analytics | ربط مساحات عمل محددة حتى يكون لدى وكيلك سياق دائم حول بيانات السجل ويمكنه الاستعلام عنها بشكل استباقي |
| Application Insights | قم بربط موارد تطبيقات معينة حتى يكون لدى وكيلك سياق مستمر حول بيانات التطبيق |
| استعلام قاعدة البيانات (Azure Data Explorer) | شغل استعلامات KQL المحددة مسبقا على مجموعات Kusto الخاصة بك |
| فهرسة قواعد البيانات (Azure Data Explorer) | تعلم تلقائيا مخطط Kusto الخاص بك حتى يتمكن الوكيل من توليد الاستعلامات ديناميكيا |
نصيحة
الوصول المدمج مقابل الموصلات ل Log Analytics وApplication Insights
يمكن لوكيلك بالفعل الاستعلام عن مساحة العمل any Log Analytics أو مصدر Application Insights من خلال الأدوات المدمجة — دون الحاجة إلى موصل. إضافة Log Analytics أو Application Insights connector تذهب أبعد من ذلك: فهي تمنح وكيلك وعيا مستمرا بمساحات العمل المحددة، وتشمل بياناتها في السياق المحيط للوكيل، وتمكن من تشخيصات أكثر ثراء تعتمد على MCP عبر مواردك المتصلة.
الشيفرة المصدرية والمعرفة
أعط وكيلك سياقا عن أنظمتك، بما في ذلك الكود، والويكي، والتوثيق.
| الموصل | ما الذي تقدمه |
|---|---|
| GitHub خادم MCP | الوصول إلى المستودعات، والمشاكل، وطلبات السحب، وصفحات الويكي |
| GitHub OAuth | الوصول إلى GitHub عبر تدفق المصادقة الافتراضية |
| Azure DevOps OAuth | Azure DevOps access via OAuth authentication |
| Documentation (Azure DevOps) | فهرسة وابحث في ويكي Azure DevOps الخاص بك |
باستخدام هذه الموصلات، يمكن لوكيلك البحث عن أنماط الأخطاء في الكود، وقراءة وثائق الويكي، والرجوع إلى وثائق واجهة برمجة التطبيقات أثناء استكشاف الأخطاء، وربط الحوادث بطلبات السحب ذات الصلة.
أدوات التعاون
دع وكيلك ينقل النتائج عبر القنوات التي يستخدمها فريقك بالفعل.
| الموصل | ما الذي تقدمه |
|---|---|
| إرسال إشعار (Teams) | نشر النتائج والتحديثات على قنوات Teams |
| أرسل بريدا إلكترونيا (Outlook) | ملخصات وتقارير التحقيقات عبر البريد الإلكتروني |
الموصلات المخصصة (خوادم MCP)
باستخدام بروتوكول سياق النموذج (MCP)، يمكنك ربط وكيلك بأي نظام: قواعد بيانات محلية، تطبيقات عبر السحابة، واجهات برمجة التطبيقات المملوكة، أو منصات طرف ثالث مثل Datadog أو Splunk أو Grafana أو Jira.
تصفح الخوادم المتاحة في Azure MCP Center. عند إضافة أدوات MCP إلى الوكلاء المخصصين، استخدم نمط البطاقة البرية لإضافة جميع الأدوات من الخادم دفعة واحدة.
مراقبة صحة موصل MCP
ينطبق على: الإصدار 26.1.25.0 وما بعده
وكيلك يراقب باستمرار صحة كل اتصال في خادم MCP. كل موصل في البوابة يعرض مؤشر حالة في الوقت الحقيقي حتى تتمكن من رؤية ما إذا كانت أدواتك الخارجية متاحة بنظرة واحدة.
| Status | ما يعنيه | Indicator |
|---|---|---|
| متصل |
الخادم سليم والأدوات جاهزة للاستخدام | علامة صح خضراء |
| غير متصل | فقدان مؤقت للاتصال؛ وكيلك يحاول الاسترداد التلقائي | الدائرة الحمراء |
| فاشل | لا يمكن الوصول إلى الخادم، أو حدث خطأ لا يمكن استرجاعه؛ تحقق من إعدادك | أيقونة خطأ أحمر |
| تتم الآن تهيئة | يتم حاليا إنشاء العلاقة | مؤشر أصفر |
| غير متوفر | لا تتوفر نسخة وكيل تشغيل؛ لا يمكن تحديد الحالة | علامة استفهام رمادية |
اذهب إلى Builder>Connectors لترى جميع الموصلات بحالتها الحالية.
بالنسبة للموصلات في حالة فشل أو خطأ أو غير متاح ، يظهر رابط رؤية التفاصيل في عمود الحالة. اختر الاختبار لعرض معلومات التشخيص بما في ذلك رسالة الخطأ، وعدد الأدوات المحملة، وختم نبضة القلب الأخيرة.
الاسترداد التلقائي
وكيلك لا يكتفي بالإبلاغ عن الاتصالات المقطوعة. يتعافى منها عندما يكون ذلك ممكنا.
- مراقبة نبض القلب: يقوم وكيلك بإرسال إشارة لكل خادم MCP كل 60 ثانية للتحقق من أنه لا يزال متاحا.
- استعادة الفشل المؤقت: إذا انقطع الاتصال بسبب نقطة اتصال في الشبكة، فإن نبضة القلب الناجحة التالية تعيدها تلقائيا إلى الاتصال.
- فحص الصحة قبل التنفيذ: قبل أن يستخدم وكيلك أي أداة MCP، يقوم بالتحقق من الاتصال ويحاول إعادة الاتصال إذا كان الخادم غير قابل للوصول مؤقتا.
نصيحة
تستمر الاتصالات حتى مع الأعطال
إذا انقطع خادم MCP، يبقى الموصل مرئيا في بوابتك مع حالة الخطأ. لا يختفي بصمت. يمكنك رؤية بالضبط ما الذي حدث خطأ وإصلاح التكوين دون إعادة إنشاء الموصل.
عندما لا يساعد الاسترداد التلقائي
الجدول التالي يصف السيناريوهات التي لا يمكن فيها للاسترداد التلقائي حل المشكلة.
| الموقف | ماذا يحدث | ما يجب فعله |
|---|---|---|
| نقطة الشبكة | وكيلك يعيد الاتصال تلقائيا في النبضة التالية | لا شيء؛ الاسترداد تلقائي |
| الخادم معطل مؤقتا | الحالة تظهر أنه غير متصل، ويستعيد عند عودة الخادم | انتظر حتى يعود الخادم للعمل |
| عنوان URL أو بيانات الاعتماد الخاطئة | تظهر الحالة فشل | قم بتحديث تكوين الموصل بالقيم الصحيحة |
| تمت إزالة الخادم بشكل دائم | تظهر الحالة فشل | حذف وإعادة إنشاء الموصل |
| العميل لا يعمل | عروض الحالة غير متوفرة | ابدأ الوكيل لاستعادة مراقبة الحالة |
عندما يحاول وكيلك استخدام أداة من خادم MCP مفصول، يظهر خطأ واضح يشرح ما حدث خطأ (على سبيل المثال: "الاتصال مفصول وفشلت إعادة الاتصال."). وكيلك لا يفشل بصمت أو ينتج نتائج خاطئة.
من يمكنه تكوين الموصلات
تتطلب إدارة الموصل إذن كتابة على الوكيل. يوضح الجدول التالي الأدوار التي يمكنها تكوين الموصلات.
| الدور | هل يمكنني تكوين الموصلات؟ |
|---|---|
| مسؤول وكيل SRE | نعم |
| المستخدم القياسي لعامل SRE | لا (عرض فقط) |
| قارئ وكيل SRE | لا (عرض فقط) |
أثناء الإعداد، تتطلب بعض الموصلات <موافقة > من مستخدم لديه الأذونات المناسبة في النظام الخارجي (على سبيل المثال، عضو في GitHub org لموصلات GitHub، أو مسؤول Microsoft Entra ل Outlook/Teams). هذه الموافقة تتعلق بالأذونات في الخدمة الخارجية ، وليس بأدوار وكيل SRE.
بالنسبة للموصلات التي تستخدم Managed Identity (مثل Azure Data Explorer)، يجب على مسؤول النظام الخارجي السماح بإدراج الهوية.
بمجرد التكوين، يستفيد جميع مستخدمي الوكلاء من الموصلات تلقائيا. هم فقط يسألون الوكيل أسئلة ويستخدمون الموصلات المتاحة خلف الكواليس.
الموصلات والوكلاء المخصصين
يمكنك تعيين أدوات MCP محددة لوكلاء مخصصين متخصصين. قد يحصل وكيل مخصص لحل مشاكل قاعدة البيانات على أدوات Kusto، بينما يحصل وكيل النشر المخصص على وصول إلى GitHub. هذا النهج يحافظ على تركيز كل وكيل مخصص ويمنع إرهاقه بالكثير من الأدوات.
إضافة أدوات MCP بشكل فردي
في البوابة، اذهب إلى Builder>Custom Agent Builder، أنشئ أو عدل وكيل مخصص، واختر اختيار الأدوات تحت الإعدادات المتقدمة. يعرض أداة اختيار الأدوات الأدوات مجمعة حسب اتصال MCP. اختر الوكيلة التي يحتاجها وكيلك المخصص.
في YAML، قم بإدراج كل أداة باسمها الكامل:
mcp_tools:
- azure-data-explorer_kusto_query
- azure-data-explorer_kusto_table_list
- azure-data-explorer_kusto_table_schema
إضافة جميع الأدوات من خادم MCP (بطاقة وايلدكارد)
ينطبق على: الإصدار 26.2.9.0 وما بعده
عندما يعرض خادم MCP العديد من الأدوات ويحتاج وكيل التخصيص كلها، استخدم نمط البطاقة البرية بدلا من سرد كل أداة على حدة:
mcp_tools:
- azure-data-explorer/*
{connection-id}/* النمط يضيف كل الأدوات من اتصال MCP. وكيلك يوسع نطاق الوايلد كارد في الشركات الناشئة. على سبيل المثال، azure-data-explorer/* يحل لجميع الأدوات المسجلة تحت اتصال يسمى azure-data-explorer (الإعداد الافتراضي المملوء مسبقا لجهاز MCP Azure مع موصل Kusto اعتبارا من الإصدار 26.4.16.0). استبدل الاسم الذي أعطيته للموصل.
يمكنك دمج البطاقات البرية مع أسماء الأدوات الفردية:
mcp_tools:
- azure-data-explorer/* # All tools from the Kusto connection
- grafana-mcp_dashboard # One specific tool from Grafana
ملحوظة
صياغة الرموز البرية
يجب أن يستخدم {connection-id}/* النمط مع الميل الأمامي. الأنماط مثل azure-data-explorer* (بدون الشرطة) تعامل كأسماء أدوات دقيقة، وليست كبطاقات غير مشروعة.
يقارن الجدول التالي بين اختيار الأدوات الفردية ونهج البطاقة البرية.
| Approach | متى تستخدم |
|---|---|
| الأدوات الفردية | تريد تحكما دقيقا في الأدوات التي يمكن للوكيل المخصص الوصول إليها |
وايلد كارد (connection-id/*) |
أنت تثق في خادم MCP وتريد جميع أدواته، بما في ذلك أي أدواته لاحقا |
| مختلط | تريد كل الأدوات من خادم واحد، بالإضافة إلى أدوات محددة من خادم آخر |
لماذا نستخدم البطاقة البرية؟ عندما يضيف خادم MCP أدوات جديدة، يقوم البطاقة البرية بأخذها تلقائيا دون إعادة تكوين وكيل التخصيص الخاص بك. اختيار الأدوات الفردية يمنحك تحكما دقيقا. البطاقة البرية تمنحك تغطية تلقائية.
عندما لا تكون أدوات MCP جاهزة بعد
إذا لم يكن خادم MCP جاهزا عند بدء الوكيل، فلن يتمكن وكيلك من الوصول إلى الأدوات من ذلك الخادم. وكيلك يتعامل مع هذه الحالة برقي. يقوم بتأجيل الوكلاء المخصصين الذين لديهم بطاقات غير محلولة أو أدوات مفقودة ويقوم بتحميلهم تلقائيا بمجرد أن يؤسس وكيلك الاتصال ب MCP. لا تحتاج إلى اتخاذ أي إجراء يدوي.
لمزيد من المعلومات، راجع الوكلاء المخصصين.
الخطوة التالية
المحتوى ذو الصلة
- منصات الحوادث: تعرف على كيفية استلام وكيلك للحوادث والاستجابة لها تلقائيا.
- Connect مصدر الكود المصدري: قم بإعداد موصلات GitHub أو Azure DevOps.
- الوكلاء المخصصون: أنشئ وكلاء متخصصين لديهم وصول مركز للموصل.
- Permissions: قم بتكوين الوصول Azure الموارد لوكيلك.