مشاركة عبر


Deploy agent to Azure

هام

يجب أن تكون جزءا من برنامج معاينة الحدود للحصول على وصول مبكر إلى Microsoft Agent 365. Frontier تربطك مباشرة بأحدث ابتكارات الذكاء الاصطناعي من Microsoft. تخضع المعاينات الحدودية لشروط المعاينة الحالية لاتفاقيات العملاء. نظرًا لأن هذه الميزات لا تزال قيد التطوير، فقد يتغير توفرها وقدراتها بمرور الوقت.

لقد بنيت وكيلك واختبرته محليا - الآن حان الوقت لإعادته إلى الحياة في السحابة. هذه الخطوة اختيارية ويمكن تخطيها إذا كنت قد نشرت وكيلك بالفعل على سحابة (لا تحتاج حتى أن تكون Azure).

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

هناك أيضا موارد متاحة لتوضيح كيفية تحديث نقطة نهاية الرسائل إذا كنت قد نشرت وكيلك بالفعل على مزودي سحابة آخرين مثل AWS أو GCP، بدلا من Azure:

المتطلبات الأساسية

قبل أن تبدأ، تأكد من أن لديك الإعداد التالي:

الحسابات والأذونات المطلوبة

  • اشتراك Azure مع إمكانية الوصول إلى المساهم.
  • كود وكيل يعمل مع نقطة نهاية رسائل صالحة وقابلة للوصول. يرجى التأكد من أنك اختبرت ذلك محليا وتحقق من إمكانية بناء كود الوكيل وتشغيله.
  • أكمل خطوة مخطط وكيل الإعداد للحصول على مخطط وكيل صالح.
  • تأكد من تحديث ملفات a365.config.jsonالتكوين وملف a365.generated.config.json الإعدادات في الكود (مثل ملف .env).

الأَدَوَات المطلوبة

نشر في Azure

يقوم الأمر a365 deploy بنشر وكيلك إلى تطبيق Azure Web App الذي تم إنشاؤه أثناء الإعداد. هذا يرفع كود الوكيل إلى Azure، مما يجعله متاحا للتشغيل في السحابة والتعامل مع أي طلبات وكيل إلى تلك النقطة.

نشر وكيل

تشغيل أمر النشر:

a365 deploy

إشعار

a365 deploy -h يعرض جميع خيارات تشغيل هذا الأمر بما في ذلك الأوامر الفرعية.

أمر النشر لوكلاء .NET:

  • الكشف عن ملفات مشروع .NET (*.csprojأو *.fsprojأو *.vbproj)
  • استعادة حزم NuGet باستخدام dotnet restore
  • نشر التطبيق باستخدام dotnet publish مع تكوين الإصدار
  • إنشاء ملف التكوين Oryx باستخدام أمر DLL لنقطة البداية (على سبيل المثال، dotnet YourApp.dll)
  • تكوين وقت تشغيل Azure استنادا إلى إصدار .NET المكتشف (الافتراضي: DOTNET|8.0)
  • يتم النشر عبر zip مع تقدم في الوقت الحقيقي

Warning

إدارة البيانات السرية: عند النشر، يتم تخزين متغيرات البيئة (بما في ذلك مفاتيح API والأسرار) كإعدادات تطبيق Azure. بينما يتم استخدام متغيرات البيئة بشكل شائع للتكوين، يتم تخزينها في نص عادي. بالنسبة لبيئات الإنتاج، توصي Microsoft باستخدام Azure Key Vault للبيانات السرية الحساسة. لمزيد من المعلومات، راجع التخزين الآمن لبيانات التطبيق السرية في التطوير في ASP.NET Coreوموفر تكوين Azure Key Vault. لا تقم أبداً بإيداع .env الملفات ذات المعلومات الحساسة في نظام التحكم في المصدر.

التحقق من النشر

بعد اكتمال النشر:

  1. انتقل إلى تطبيق الويب الخاص بك في مدخل Microsoft Azure
  2. انتقل إلى تكوين الإعدادات> للتحقق من إعدادات التطبيق
  3. التحقق من سجلات التوزيع في مركز النشر

الخطوات التالية

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

وكيلك الآن موجود في السحابة وجاهز للرد على طلبات الوكلاء. بينما يتعامل وكيلك مع الطلبات الواقعية، فكر في الخطوات التالية في كودك:

  • مراقبة الأداء: استخدام ميزات المراقبة لتعقب سلوك العامل وتحسين الاستجابات
  • إضافة المزيد من الأدوات: استكشاف كتالوج الأدوات لتوسيع قدرات وكيلك
  • التكرار والتحسين: تحديث التعليمات البرمجية للعامل وإعادة النشر وإعادة النشر (تذكر زيادة رقم الإصدار!)
  • توسيع نطاق مؤسستك: مشاركة قصص نجاح وكيلك لدفع عملية الاعتماد