المهارات Azure.ResourceManager.BotService (.NET)
📦

Azure.ResourceManager.BotService (.NET)

آمن

إدارة موارد Azure Bot Service باستخدام .NET SDK

يحتاج المطورون إلى توفير وتكوين موارد Azure Bot Service بكفاءة. توفر هذه المهارة إرشادات شاملة لإدارة موارد البوت وقنوات الاتصال وإعدادات الاتصال باستخدام Azure Resource Manager .NET SDK.

يدعم: Claude Codex Code(CC)
🥉 72 برونزي
1

تنزيل ZIP المهارة

2

رفع في Claude

اذهب إلى Settings → Capabilities → Skills → Upload skill

3

فعّل وابدأ الاستخدام

اختبرها

استخدام "Azure.ResourceManager.BotService (.NET)". إنشاء بوت باسم 'CustomerSupportBot' في West US 2 مع تمكين قناة Teams

النتيجة المتوقعة:

تم إنشاء البوت 'CustomerSupportBot' بنجاح في West US 2. تم تكوين قناة Teams مع تعطيل المكالمات. نقطة نهاية البوت: https://customer-support-bot.azurewebsites.net/api/messages

استخدام "Azure.ResourceManager.BotService (.NET)". سرد جميع القنوات للبوت 'MyAssistant'

النتيجة المتوقعة:

قنوات MyAssistant:
- DirectLineChannel (Enabled: True, Secure Site: True)
- MsTeamsChannel (Enabled: True, Calling: False)
- WebChatChannel (Enabled: True)

استخدام "Azure.ResourceManager.BotService (.NET)". تجديد مفاتيح DirectLine لموقع Default Site

النتيجة المتوقعة:

تم تجديد مفاتيح DirectLine بنجاح لـ 'Default Site'. المفتاح الأساسي الجديد متاح. ستظل المفاتيح السابقة صالحة لمدة 10 دقائق أثناء الانتقال.

التدقيق الأمني

آمن
v1 • 2/25/2026

This skill contains documentation and code examples for the Azure Resource Manager BotService SDK. Static analysis scanned 0 files with 0 lines, detecting no security patterns. The skill is prompt-only content with no executable code, making it safe for publication. All code examples demonstrate proper Azure SDK patterns including DefaultAzureCredential for authentication.

0
الملفات التي تم فحصها
0
الأسطر التي تم تحليلها
0
النتائج
1
إجمالي عمليات التدقيق
لا توجد مشكلات أمنية
تم تدقيقه بواسطة: claude

درجة الجودة

38
الهندسة المعمارية
100
قابلية الصيانة
87
المحتوى
50
المجتمع
100
الأمان
74
الامتثال للمواصفات

ماذا يمكنك بناءه

مهندس DevOps لأتمتة نشر البوت

أتمتة توفير موارد البوت عبر بيئات متعددة باستخدام خطوط أنابيب CI/CD مع إدارة مناسبة لبيانات الاعتماد.

مطور يبني بوتات متعددة القنوات

تكوين قنوات اتصال متعددة لمورد بوت واحد للوصول إلى المستخدمين عبر تكاملات Teams وWeb Chat وDirectLine.

مسؤول الأمان يدير بيانات اعتماد البوت

تنفيذ سياسات تدوير المفاتيح وإدارة إعدادات اتصال OAuth لنشر البوتات المؤسسية ذات متطلبات الأمان الصارمة.

جرّب هذه الموجهات

للمبتدئين: إنشاء مورد بوت أساسي
ساعدني في إنشاء مورد Azure Bot جديد في اشتراكي. أحتاج إلى المصادقة باستخدام DefaultAzureCredential، وإنشاء مجموعة موارد إذا لزم الأمر، ونشر بوت مع SKU من tier المجاني (F0). اعرض لي كود C# الكامل مع معالجة مناسبة للأخطاء.
متوسط: تكوين قنوات متعددة
لدي مورد بوت موجود وأحتاج إلى تمكين كل من قناتي Microsoft Teams وDirectLine. اعرض لي كيفية تكوين قناة Teams مع تعطيل المكالمات، وإعداد DirectLine مع موقع آمن. ضمّن كودًا للتحقق من إنشاء القنوات بنجاح.
متقدم: تنفيذ تدوير المفاتيح
تتطلب سياسة الأمان الخاصة بنا تدويرًا ربع سنويًا لمفاتيح قناة DirectLine. اعرض لي كيفية تجديد المفاتيح برمجيًا لموقع Default، واسترداد المفاتيح الجديدة، وتحديث Azure Key Vault ببيانات الاعتماد المدوّرة باستخدام Azure SDK.
خبير: إدارة البوتات متعددة البيئات
أحتاج إلى نشر نفس تكوين البوت عبر بيئات dev وstaging وproduction مع إعدادات خاصة بكل بيئة. أنشئ حلاً يستخدم ARM SDK لإنشاء بوتات مع SKU مختلفة (F0 لـ dev وS1 لـ production)، وتكوين القنوات بشكل مناسب، وتنفيذ معالجة مناسبة للأخطاء لكل بيئة.

أفضل الممارسات

  • استخدم DefaultAzureCredential للحصول على مصادقة مرنة تدعم بيئات التطوير والإنتاج
  • خزّن بيانات الاعتماد الحساسة مثل MSA App IDs والأسرار في Azure Key Vault بدلاً من متغيرات البيئة
  • فعّل المواقع الآمنة لقنوات DirectLine في الإنتاج لتتطلب مصادقة قائمة على الرموز

تجنب

  • تضمين أسرار العميل أو سلاسل الاتصال مباشرة في كود المصدر
  • استخدام BotServiceKind.Bot القديم بدلاً من نوع Azurebot الموصى به للنشر الجديد
  • تخطي WaitUntil.Completed للعمليات التي يجب اكتمالها قبل المتابعة

الأسئلة المتكررة

ما طرق المصادقة التي يدعمها هذا SDK؟
يستخدم SDK طريقة DefaultAzureCredential من Azure.Identity والتي تدعم طرقًا متعددة: بيانات اعتماد Visual Studio وبيانات اعتماد Azure CLI والهوية المُدارة ومتغيرات البيئة وservice principals القائمة على الشهادات. يحاول كل طريقة بالترتيب حتى تنجح المصادقة.
هل يمكنني استخدام هذا SDK لإرسال رسائل من البوت الخاص بي؟
لا، يتعامل هذا SDK فقط مع عمليات مستوى الإدارة (إنشاء وتحديث وحذف موارد البوت). لإرسال الرسائل واستلامها، استخدم حزمة Microsoft.Bot.Builder SDK بدلاً من ذلك.
كيف أتعامل مع تحديد المعدل من Azure Resource Manager API؟
يعيد SDK المحاولة تلقائيًا عند استجابات حد المعدل. للتعامل المخصص، التقط RequestFailedException وتحقق مما إذا كان ErrorCode يشير إلى الاختناق. فكّر في تنفيذ تراجع أسي للعمليات عالية الحجم.
ما الأذونات التي أحتاجها لإنشاء موارد بوت؟
تحتاج إلى دور Contributor أو Owner على مجموعة الموارد، أو دور مخصص مع أذونات Microsoft.BotService/bots/write وMicrosoft.BotService/bots/channels/write. للقراءة، استخدم Microsoft.BotService/bots/read.
كيف أكوّن اتصالات OAuth للبوت الخاص بي؟
استخدم BotConnectionSettingResource لإنشاء إعدادات اتصال OAuth. يتطلب ذلك تكوين تسجيل تطبيق Azure AD مع URIs إعادة التوجيه والأذونات المناسبة لمزود الهوية المستهدف.
هل يمكنني إدارة البوتات عبر اشتراكات متعددة؟
نعم، أنشئ مثيلات ArmClient منفصلة لكل اشتراك أو استخدم ArmClient للحصول على اشتراكات محددة حسب ID. يمكنك التكرار عبر جميع الاشتراكات التي يمكن الوصول إليها لبيانات الاعتماد الخاصة بك للإدارة عبر الاشتراكات.

تفاصيل المطور

بنية الملفات

📄 SKILL.md