أدوات بايثون في Azure SRE Agent

أدوات بايثون توسع Azure SRE Agent الخاص بك لما هو أبعد من القدرات المدمجة في Azure. أنشئ أدوات مخصصة تتصل بواجهات برمجة التطبيقات الداخلية، وقواعد البيانات المحلية، ومنصات السحابة المتعددة، والأنظمة المملوكة باستخدام كود بايثون. صف ما تحتاجه باللغة البسيطة، والصق السكريبتات الموجودة أو لف نقاط نهاية HTTP، ثم اختبر ونشر بدون إعادة تشغيل.

نصيحة

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

المشكلة

وكيلك يحتوي على أدوات مدمجة قوية لآزور، بما في ذلك استعلامات Kusto، وAzure Monitor، وعمليات Azure Resource Manager. لكن منظمتك لا تعيش بالكامل في Azure:

• الأنظمة الداخلية: قواعد بيانات CMDB، أنظمة التذاكر المخصصة، وواجهات برمجة التطبيقات الداخلية التي تستخدمها مؤسستك فقط.
• Multicloud: لوحات تحكم Datadog، سجلات Splunk، ومقاييس AWS CloudWatch جنبا إلى جنب مع Azure.
• البنية التحتية القديمة: قواعد بيانات محلية، بروتوكولات خاصة، وأنظمة بدون واجهات برمجة تطبيقات حديثة.
• منطق الأعمال المخصص: حسابات اتفاقية مستوى الخدمة الخاصة بعقودك، صيغ توزيع التكاليف، ونماذج تخطيط السعة.

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

كيف تعمل أدوات بايثون

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

يتبع الكود المولد نمطا متسقا:

• دالة main() تقبل المعلمات النوعية.
• قيم إرجاع قابلة للتسلسل ب JSON.
• نص وصفي يشرح المنطق.

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

بعد اختبار الأداة، اختر إنشاء الأداة. يمكن لوكيلك استخدامه فورا دون إعادة تشغيل أو خط نشر.

أدوات بايثون مقابل موصلات MCP

بالنسبة للمنصات غير التابعة لمايكروسوفت، لديك خياران.

Approach	مناسب لـ	أمثلة
موصلات MCP	المنصات الشائعة التي تحتوي على واجهات برمجة تطبيقات قياسية	Datadog, Splunk, ServiceNow, GitHub
أدوات بايثون	الأنظمة الداخلية، المنطق المخصص، المنصات بدون MCP	قاعدة بيانات CMDB الخاصة بك، واجهات برمجة التطبيقات الخاصة بك، حسابات مخصصة

استخدم موصلات MCP عندما يكون هناك موصل لمنصتك. يوفر MCP مخططات منظمة، وإدارة مصادقة، وسلوكا متسقا.

استخدم أدوات بايثون عندما تحتاج للوصول إلى أنظمة داخلية، أو ترميز منطق أعمال مخصص، أو الاتصال بمنصات لا تدعم MCP.

ما الذي يجعل هذا مختلفا

يقارن الجدول التالي قدرات الوكلاء مع وبدون أدوات بايثون.

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

أدوات بايثون تحول وكيلك من مساعد أصلي لجهاز Azure إلى منصة قابلة للتوسعة تعمل مع البنية التحتية بالكامل لديك.

قبل وبعد

قبل	بعد
"قاعدة بيانات القاعدة النقدية لدينا في الموقع، العميل لا يستطيع رؤيته"	أداة بايثون مع وصول الشبكة تستعلامات الأنظمة الداخلية
"لدينا صيغ SLA مخصصة لم يقم أحد بأتمتتها"	ترميز صيغك كأداة؛ يقوم الوكيل بتطبيقها تلقائيا
"تقارير الامتثال تحتاج إلى تنسيق PDF محدد"	إنشاء تقارير باستخدام ReportLab، يتم تسليمها عبر الوكيل

المتطلبات المسبقه

• وصول بناء إلى وكيل Azure SRE.
• بالنسبة لنقاط نهاية HTTP: بيانات URL وبيانات المصادقة لأنظمتك المستهدفة.

إنشاء أداة بايثون

يمكنك إنشاء أدوات بايثون باستخدام ثلاث طرق.

Approach	أنت تقدم	الوكيل يفعل ذلك	مناسب لـ
وصف باللغة الإنجليزية البسيطة	"حساب مستوى الخدمة من وقت التشغيل ووقت التوقف"	تولد كود بايثون الكامل	منطق مخصص سريع، لا حاجة للبرمجة
لصق الكود الموجود	وظيفتك في بايثون	يلفها كأداة	ترحيل السكريبتات الموجودة، منطق معقد
نقاط نهاية استدعاء HTTP	رابط نقطة النهاية والمصادقة	يستدعي واجهة برمجة التطبيقات الخاصة بك عبر HTTP	Azure Functions، Lambda، واجهات برمجة التطبيقات الداخلية، webhooks

الخيار الأول: دع الذكاء الاصطناعي يكتب الكود

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

أنت تصف: "احسب التزام اتفاقية مستوى الخدمة من وقت التشغيل ودقائق التوقف، وأعد ما إذا كان يحقق عتبة 99.9%"

يقوم الوكيل بتوليد: وظيفة كاملة main() جاهزة للاختبار والنشر.

الخيار الثاني: أحضر كودك الخاص

الصق بايثون الحالية في تبويب الكود . يجب أن تتبع الدالة هذا النمط:

def main(param1: str, param2: int) -> dict:
    # Your logic here
    return {"result": "value"}

الخيار 3: استدعاء نقاط نهاية HTTP

تغليف أي نقطة نهاية HTTP (Azure Functions، AWS Lambda، واجهات برمجة التطبيقات الداخلية، أو webhooks) كأداة بايثون:

def main(input_data: str) -> dict:
    import requests

    # Azure Function with function key
    response = requests.post(
        "https://<FUNCTION_APP_NAME>.azurewebsites.net/api/<ENDPOINT>?code=<FUNCTION_KEY>",
        json={"data": input_data}
    )

    # Or internal API with bearer token
    # response = requests.get(
    #     "https://internal-api.corp/resource",
    #     headers={"Authorization": "Bearer <API_TOKEN>"}
    # )

    return response.json()

ملحوظة

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

سيناريوهات الأمثلة

توضح الأمثلة التالية حالات الاستخدام الشائعة لأدوات بايثون.

استعلام CMDB الداخلي:

def main(server_name: str) -> dict:
    """Query internal CMDB for server configuration."""
    import requests
    response = requests.get(f"https://cmdb.internal.corp/api/servers/{server_name}")
    return response.json()

حساب SLA مخصص:

def main(uptime_minutes: int, downtime_minutes: int) -> dict:
    """Calculate SLA using your organization's formula."""
    total = uptime_minutes + downtime_minutes
    sla = (uptime_minutes / total) * 100 if total > 0 else 100.0
    return {"sla_percent": round(sla, 4), "meets_target": sla >= 99.9}

إعداد تقرير الامتثال:

def main(incidents: list, month: str) -> dict:
    """Generate PDF compliance report."""
    from reportlab.platypus import SimpleDocTemplate
    doc = SimpleDocTemplate(f"/mnt/data/compliance-{month}.pdf")
    # Build report...
    return {"report_path": f"/api/files/compliance-{month}.pdf"}

تحقق من أن أداتك تعمل

بعد إنشاء الأداة، جربها في دردشة جديدة:

Calculate SLA for 43185 minutes uptime and 15 minutes downtime

يجب على وكيلك أن يدرك أن المهمة تتوافق مع أداتك وأن يستدعيها تلقائيا.

بيئة التنفيذ

الجدول التالي يصف بيئة التنفيذ لأدوات بايثون.

الخاصية	قيمة
المهلة	من 5 إلى 900 ثانية (الافتراضي: 120)
عزل	الحاوية الجديدة لكل تنفيذ
نظام الملفات	/mnt/data للملفات المؤقتة
شبكة	تمكين الاتصال الصادر
الرزم	700+ مثبت مسبقا (Pandas، Requests، Azure Identity، ReportLab، والمزيد)
State	لا يوجد إصرار بين المكالمات

Authentication for Azure resources

يمكن لأدوات بايثون التحقق من صحة موارد Azure باستخدام هوية مدارة مع نطاقات محددة مسبقا.

النطاق	Access
ذراع	Azure Resource Manager (management.azure.com)
خزنة المفاتيح	الأسرار، المفاتيح، الشهادات (vault.azure.net)
التخزين	كتلة، طابور، تخزين الجدول (storage.azure.com)

فعل المصادقة في تبويب الهوية عند إنشاء أداة.

القيود

• لا توجد حالة مستمرة: كل تنفيذ يبدأ من جديد. قم بتخزين النتائج خارجيا إذا لزم الأمر.
• الحد الأقصى للاستراحة: 900 ثانية (15 دقيقة) للعمليات الطويلة.
• بدون معالج رسوميات: بيئة تنفيذ تعتمد فقط على المعالج المركزي.
• مطلوب إخراج JSON: يجب أن تكون قيم الإرجاع قابلة للتسلسل.

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

القدرة	ما الذي يضيفه
نظرة عامة على الأدوات	جميع أنواع الأدوات التي يمكن لوكيلك استخدامها
الموصلات	تكاملات مدمجة للمنصات المشتركة