وكلاء الاختبار باستخدام أنفاق التطوير

هام

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

باستخدام أنفاق التطوير، يمكنك اختبار وكيل Agent 365 الخاص بك باستخدام تطبيقات Microsoft 365 (مثل Teams أو Outlook أو Word) بينما يعمل وكيل الوكيل محليا على جهاز التطوير. يربط هذا النهج التطوير المحلي والاختبار الواقعي، بحيث يمكنك التحقق من سلوك الوكلاء في بيئات Microsoft 365 الفعلية قبل نشرها على السحابة.

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

قبل استخدام أنفاق المطورين، تأكد من تثبيت أداة سطر الأوامر الخاصة ب Dev Tunnels.

• Windows: winget install Microsoft.devtunnel
• macOS/Linux: تحميل من aka.ms/devtunnels/download

إعداد نفق التطوير

قم بتكوين نفق تطوير لعرض نقطة نهاية وكيل محلي لخدمات Microsoft 365.

إنشاء وبدء نفق

1. تسجيل الدخول إلى نفق المطورين:

   devtunnel user login
   

2. أنشئ نفقا مستمرا:

   devtunnel create --allow-anonymous
   

   هذا الأمر يعيد معرف النفق. احفظ هذا المعرف للاستخدام المستقبلي.

3. تكوين منفذ النفق:

   تعيين المنفذ الذي يستخدمه خادم الوكيل الخاص بك (عادة 3978):

   devtunnel port create <tunnel-id> -p <port-number>
   

4. ابدأ النفق:

   devtunnel host <tunnel-id>
   

   يعرض الأمر عنوان URL الخاص بك (على سبيل المثال، https://abc123xyz.devtunnels.ms:3978). انسخ هذا الرابط للخطوة التالية.

تلميح

استخدمها devtunnel listdevtunnel delete <tunnel-id> لرؤية جميع أنفاق وإزالة الأنفاق التي لم تعد بحاجة إليها.

تكوين نقطة نهاية رسائل الوكيل

سجل رابط Dev Tunnel الخاص بك (على سبيل المثال، https://abc123xyz.devtunnels.ms:3978/api/messages) كنقطة نهاية للرسائل الوكيل حتى يعرف Microsoft 365 إلى أين يوجه الرسائل. لا تنس اللاحقة /api/messages إلى نقطة النهاية.

يرجى مراجعة نقطة نهاية رسائل وكيل Set

اختبار مع Microsoft 365

مع تفعيل نفق التطوير وتسجيل نقطة النهاية، اختبر وكيل التطوير في تطبيقات Microsoft 365.

الاختبار في Microsoft Teams

1. ابدأ وكيل الوكيل المحلي باستخدام التعليمات في Install dependencies وبدأ خادم تطبيق الوكيل.

2. تحقق من اتصال النفق:

   devtunnel list
   

   تحقق من أن النفق يظهر اتصالات المضيف النشطة. يجب أن يظهر عمود "اتصالات المضيف" رقما أكبر من 0.

3. تفاعل مع وكيلك في Teams:

   • Open Microsoft Teams (ويب أو سطح مكتب)
   • في شريط بحث Teams، ابحث عن وكيلك بالاسم أو البريد الإلكتروني
   • ابدأ محادثة مع الوكيل
   • أرسل رسالة وراقب الرد
   • تحقق من وحدة التحكم المحلية لديك بحثا عن الطلبات الواردة ونشاط الوكيل

إشعارات البريد الإلكتروني التجريبي

إذا كان وكيلك مهيئا لإشعارات البريد الإلكتروني:

1. أرسل بريدا إلكترونيا إلى بريد وكيلك الإلكتروني
2. قم بتسجيل وكيلك في سلسلة بريد إلكتروني
3. راقب جهاز التحكم المحلي الخاص بك لرؤية إشعارات webhook
4. تحقق من معالجة وكيلك ورد على البريد الإلكتروني

تكامل كلمة اختبار

للوكلاء الذين يردون على تعليقات وورد:

1. افتح مستند Word حيث يمكن لوكيلك الوصول إليه.
2. أضف تعليقا يذكر وكيلك.
3. تحقق من جهاز التحكم المحلي لديك للحصول على الإشعار.
4. تحقق من ظهور رد وكيلك في وورد.

مراقبة نشاط الأنفاق

يوفر Dev Tunnels فحص حركة المرور للمساعدة في تصحيح مشاكل الاتصال وفهم تدفق الطلبات:

devtunnel show <tunnel-id>

يعرض هذا الأمر:

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

يمكنك أيضا مراقبة نشاط الأنفاق في الوقت الحقيقي من خلال مراقبة مخرجات الأمر devtunnel host .

الحفاظ على وصلات الأنفاق

تتطلب أنفاق التطوير أن devtunnel host تستمر العملية في العملية. إذا كان عدم النشاط، أو مشاكل الشبكة، أو دخول جهازك في وضع السكون تسببت في انقطاع الاتصال، عليك إعادة تشغيله.

تحقق من حالة النفق

تحقق مما إذا كان نفقك نشطا:

devtunnel list

يعرض الإخراج:

• معرف النفق: معرف النفق الخاص بك
• اتصالات المضيف: عدد الاتصالات النشطة (يجب أن يكون واحدا أو أكثر عند devtunnel host التشغيل)
• المنافذ: المنافذ المكونة
• انتهاء الصلاحية: وقت انتهاء النفق

إذا أظهر Host Connections 0، فالنفق موجود لكنه غير مستضاف حاليا.

إعادة تشغيل نفق منفصل

إذا انقطع الاتصال بالنفق، أعد تشغيله باستخدام نفس معرف النفق:

devtunnel host <tunnel-id>

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

حافظ على نشاط الأنفاق أثناء التطوير

للحفاظ على اتصالات مستقرة:

• أبق نافذة الطرفية مفتوحة - لا تغلق المحطة وهي تعمل devtunnel host.
• منع سبات الكمبيوتر - قم بتكوين نظامك ليبقى مستيقظا أثناء جلسات الاختبار.
• راقب أخطاء الاتصال - راقب devtunnel host مخرج الطرفية بحثا عن رسائل الانقطاع.
• أعد التشغيل بعد تغييرات الشبكة - إذا قمت بتغيير الشبكة أو إعادة الاتصال بشبكة VPN، أعد تشغيل النفق.

تلميح

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

تنظيف

عندما تنتهي من الاختبار باستخدام أنفاق المطورين:

أوقف النفق

اضغط Ctrl+C في المحطة الجارية devtunnel host لإيقاف النفق.

يقوم هذا الأمر بإزالة رابط Dev Tunnel من نقطة نهاية رسائل وكيلك. عند النشر في الإنتاج، قم بتعيين رابط نقطة النهاية المستضافة في السحابة.

ملاحظة

يظل النفق متاحا للاستخدام المستقبلي حتى تقوم بحذفه صراحة باستخدام devtunnel delete <tunnel-id>.

القيود

ضع هذه القيود في الاعتبار عند الاختبار باستخدام أنفاق المطورين:

• التطوير فقط: استخدم أنفاق المطورين للتطوير والاختبار، وليس للإنتاج.
• الأداء: توقع زمن استجابة أعلى مقارنة بالوكلاء المستضافين في السحابة بسبب توجيه الشبكة.
• استقرار الاتصال: قد تنقطع اتصالات الأنفاق أحيانا وتتطلب إعادة تشغيل يدوية.
• اعتبارات الأمان: العلم --allow-anonymous مناسب للاختبار لكن لا تستخدمه مع البيانات الحساسة.
• إدارة الجلسة: قد تحتاج إلى إعادة المصادقة بشكل دوري حسب مدة جلستك.

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

بعد اختبار نفق المطور بنجاح:

• نشر وكيلك على السحابة: قم بنشر الإرسال إلى Azure، أو تعيين نقطة نهاية رسائل الوكيل في AWS، أو تعيين نقطة نهاية رسائل الوكيل في GCP.
• تكوين نقاط نهاية رسائل الوكيل: نقطة نهاية رسائل الوكيل.
• اتبع دورة حياة التطوير الكاملة: دورة حياة تطوير الوكيل 365.

استكشاف الأخطاء وإصلاحها

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

فشل اتصال النفق

الأعراض: نفق التطوير لا يبدأ أو ينقطع الاتصال فورا.

الحلول‏‎:

• تحقق من تسجيل الدخول: devtunnel user login
• تحقق مما إذا كانت عملية أخرى تستخدم نفس المنفذ
• تأكد من أن جدار الحماية الخاص بك يسمح باتصالات Dev Tunnel
• احذف وأعد إنشاء النفق: devtunnel delete <tunnel-id> ثم أنشئ واحدا جديدا

الرسائل لا تصل إلى الوكيل المحلي

الأعراض: يشير Microsoft 365 إلى أن الرسالة أرسلت، لكن وكيلك المحلي لا يستقبلها.

الحلول‏‎:

• تأكد من أن وكيلك يعمل محليا
• تحقق من أن النفق نشط: devtunnel list يجب أن يظهر "متصل"
• تحقق من إعدادات نقطة النهاية: a365 config display يجب أن يظهر رابط Dev Tunnel الخاص بك
• راجع سجلات نفق التطوير في الجهاز التشغيلي devtunnel host بحثا عن أخطاء الاتصال
• تأكد من أن منفذك المحلي يطابق منفذ النفق (كلاهما يجب أن يكون 3978 افتراضيا)

أخطاء المصادقة عبر نفق التطوير

الأعراض: أخطاء 401 أو 403 عند الاختبار عبر Dev Tunnel.

الحلول‏‎:

• تحقق من أن المصادقة الوكائلية مضبوطة (مصادقة الرمز الحامل لا تعمل مع أنفاق التطوير لتكامل Microsoft 365).
• تحقق من بيانات اعتماد مخططات الوكيل باستخدام a365 config display -g.
• تأكد من أن وكيلك لديه الأذونات المطلوبة للعمليات التي تختبرها.
• تأكد من أن رموز المصادقة الخاصة بك لم تنتهي صلاحيتها.

تم تغيير أو انتهاء صلاحية عنوان URL الخاص بالأنفاق

الأعراض: رابط النفق الذي كان يعمل سابقا لم يعد يوجه إلى وكيلك.

الحلول‏‎:

• تحقق من حالة النفق باستخدام devtunnel list.
• أعد تشغيل النفق باستخدام devtunnel host <tunnel-id>.
• قم بتحديث نقطة نهاية الرسائل إذا تغير الرابط باستخدام a365 setup blueprint --endpoint-only.