نشر عاملك إلى Azure يدويًا

يتطلب تشغيل عامل Microsoft 365 Agents SDK على Azure الخطوات التالية:

• إنشاء عامل وتكوينه
• نشر عاملك إلى Azure
• نشر عاملك اختياريًا إلى Teams أو M365

يغطي هذا المستند نشر عامل قمت بإنشائه إلى Azure وTeams أو Microsoft 365 Copilot.

إذا لم تكن قد أنشأت عاملاً بعد، فابدأ بـ التشغيل السريع: إنشاء عامل أساسي واختباره باستخدام C#‎.

انشر عاملك على تطبيق ويب

عامل SDK هو تطبيق ويب. لنشر عاملك، يمكنك استخدام الطرق التي تستخدمها عادة لنشر تطبيق ويب إلى Azure:

• النشر كحزمة ZIP إلى تطبيق Azure App Service
• نشر Visual Studio إلى تطبيق أو حاوية Azure App Service
• عمليات نشر الحاويات الأخرى التي يدعمها Azure
• نشر Microsoft 365 Agents Toolkit

مهم

إذا كنت تستخدم تطبيق Azure App Service وإما بيانات اعتماد موحدة أو هوية مدارة من قبل المستخدم، فستحتاج إلى إضافة هذه الهوية ضمن الإعدادات، ثم الهوية.

بمجرد نشر التعليمات البرمجية للعامل الخاص بك، فإنه يحتوي على عنوان URL أساسي، مثل example.azurewebsites.net.

في Azure، انتقل إلى مورد الروبوت في Azure. ضمن التكوين، قم بتغيير نقطة نهاية المراسلة إلى https://{yourwebsite}/api/messages. استبدل {yourwebsite} بعنوان URL الأساسي لتطبيق الويب الخاص بك.

اختبار في Web Chat

لمشاهدة رسالتك في دردشة الويب، حدد اختبار في دردشة الويب في مورد الروبوت في Azure وأرسل رسائل إلى عاملك.

إعداد بيان Teams وMicrosoft 365 Copilot

بالنسبة إلى Microsoft Teams وMicrosoft 365 Copilot، تحتاج إلى إنشاءبيان وتحميله. لا يمكن تقديم مثال بيان يغطي جميع احتياجات Teams أو Microsoft 365 Copilot. تتطلب ميزات Teams محتوى بيان محددًا.

توفر هذه الخطوات نظرة عامة على عامل Teams الأساسي لنمط "الدردشة".

1. إنشاء مجلد فارغ في مشروعك.
2. انسخ محتويات ملفات بيان Teams إلى المجلد.
3. في المجلد، افتح manifest.json وقم بعمليات التحرير التالية:
   • في كل مكان ترى فيه سلسلة <<AAD_APP_CLIENT_ID>>العنصر النائب، استبدلها بمورد الروبوت في ClientId Azure الخاص بك.
   • استبدل <<BOT_DOMAIN>> بعنوان URL الأساسي لعاملك.
   • اضغط محتويات المجلد لإنشاء manifest.zip مع المحتويات:
     • manifest.json
     • outline.png
     • color.png

نشر إلى Microsoft 365

1. يجب أن يحتوي مورد الروبوت في Azure الخاص بك على قناة Microsoft Teams مضافة ضمن القنوات.

2. انتقل إلى مدخل مسؤولي Microsoft ‏(MAC). ضمن الإعدادات والتطبيقات المتكاملة، حدد تحميل تطبيق مخصص.

3. حدد manifest.zip الذي تم إنشاؤه في القسم السابق، ثم قم بتحميل الملف.

بعد فترة زمنية قصيرة، يظهر العامل في Microsoft Teams وMicrosoft 365 Copilot.