نقطة نهاية رسائل عامل

نقطة نهاية مراسلة العامل هي نقطة النهاية التي تُرسل إليها رسائل الإشعارات الخاصة بالعامل.

حذف نقطة نهاية مراسلة العامل.

استخدم a365 cleanup blueprint --endpoint-only الأمرلمسح تسجيل نقطة نهاية مراسلة العامل. لا يؤثر هذا الأمر على رمز العامل الخاص بك أو نقطة النهاية المنشورة. فهو يزيل فقط إدخال التسجيل عبر Teams Graph (MCP Platform).

a365 cleanup blueprint --endpoint-only

تكوين نقطة نهاية المراسلة فِي a365.config.json.

قبل تعيين نقطة نهاية الرسائل، حددها فِي ملف الإعدادات الخاص بك a365.config.json . يحتوي هذا الملف على التكوين الأساسي لنشر العامل.

أضف خصائص تكوين نقطة نهاية المراسلة التالية أو حدّثها:

{
  "messagingEndpoint": "https://your-endpoint-url.com/api/messages",
  "deploymentProjectPath": "."
}

• messagingEndpoint: حدّد عنوان URL الدقيق لنقطة النهاية التي يمكنك إرسال الرسائل إلى العامل مِنْ خلالها.

• deploymentProjectPath: المسار إلى دليل مشروع العامل. هذه الخاصية غير ذات صلة إذا كان عاملِك قد تم نشره بالفعل ولا تحتاج إلى تحديث إعدادات البيئة. عين deploymentProjectPathالى . فقط إذا لم يكن رمز العامل موجودًا على جهازك.

خصائص التكوين.

الخاصية	الوصف	مطلوبة	افتراضي	مثال
messagingEndpoint	عنوان URL الذي يستقبل العامل الرسائل مِنْ خلاله.	نعم	‏‫بلا	https://your-app.azurewebsites.net/api/messages
deploymentProjectPath	المسار إلى دليل مشروع وكيل التأمين الخاص بك لتحديثات الإعدادات	لا	.	./my-agent أو .

خيارات تكوين نقطة النهاية.

تعتمد قيمة messagingEndpoint على سيناريو النشر الخاص بك:

بالنسبة لعمليات النشر على Azure:

• تطبيق ويب Azure: https://your-app-name.azurewebsites.net/api/messages

لعمليات النشر غير المستندة إلى Azure:

• AWS: https://your-api-gateway-url.amazonaws.com/api/messages
• GCP: https://your-cloud-run-url.run.app/api/messages
• موفرو الخدمات السحابية الآخرون: عنوان URL المخصص لنقطة النهاية الخاصة بك

للاختبار المحلي باستخدام الأنفاق التطويرية (Dev Tunnels):

• رابط نفق المطورين: https://abc123xyz.devtunnels.ms:3978/api/messages

مهم

يحدد deploymentProjectPath المكان الذي تبحث فيه واجهة سطر الأوامر (CLI) عن ملفات المشروع والمكان الذي تُحدّث فيه تكوينات البيئة، مثل ملفات .env.

إشعار

عند استخدام الأنفاق التطويرية (Dev Tunnels) للاختبار المحلي، حدّث messagingEndpoint فِي a365.config.json باستخدام عنوان URL الخاص بالنفق التطويري قبل تشغيل أمر الإعداد. لمزيد مِنْ المعلومات، راجع الاختبار باستخدام أنفاق التطوير.‬.

تعيين نقطة نهاية مراسلة عامل

بعد تحديث ملف a365.config.json الخاص بك، استخدم هذا الأمر لتسجيل نقطة نهاية مراسلة عامل حتى تتمكن خدمة Agent 365 مِنْ إرسال الإشعارات إلى عامل. تقوم العملية --endpoint-only بتسجيل نقطة النهاية عبر Teams Graph (منصة MCP).

a365 setup blueprint --endpoint-only

يمكنك أيضًا تمرير عنوان URL مباشرة باستخدام --messaging-endpoint بدلاً مِنْ تعديل a365.config.json:

a365 setup blueprint --endpoint-only `
  --messaging-endpoint https://your-app.azurewebsites.net/api/messages

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

لتحديث عنوان URL لنقطة النهاية الحالية:

a365 setup blueprint --update-endpoint https://your-new-host.example.com/api/messages

نشر نقطة النهاية

إذا لم يكن لديك عاملك قد نشر بالفعل على السحابة، تعلم كيفية نشر العامل على Azure.

إذا كان عاملُك قد تم نشره بالفعل على السحابة، يمكنك ضبط نقطة نهاية الرسائل كما هو موضح سابقًا.

اطلع على كيفية ضبط نقطة نهاية الرسائل على بعض الخدمات السحابية الشائعة الأخرى:

• خدمات الويب مِنْ أمازون
• منصة Google السحابية