إشعار
يتطلب الوصول إلى هذه الصفحة تخويلاً. يمكنك محاولة تسجيل الدخول أو تغيير الدلائل.
يتطلب الوصول إلى هذه الصفحة تخويلاً. يمكنك محاولة تغيير الدلائل.
نقطة نهاية رسائل الوكيل هي النقطة التي ترسل فيها رسائل إشعار وكيل إلى وكيلك.
حذف نقطة نهاية رسائل الوكيل
استخدم الأمر a365 cleanup blueprint --endpoint-only لمسح تسجيل نقطة نهاية مراسلة الوكيل. لا يؤثر هذا الأمر على رمز العامل الخاص بك أو نقطة النهاية المنشورة. فإنه يزيل إدخال التسجيل فقط.
بالنسبة لعاملي M365 (Teams، Copilot)، مرر --m365 لمسح نقطة النهاية عبر Teams Graph:
# M365 agents — clears via Teams Graph (MCP Platform)
a365 cleanup blueprint --endpoint-only --m365
# Non-M365 agents — prints the Teams Developer Portal URL for manual configuration
a365 cleanup blueprint --endpoint-only
تكوين نقطة نهاية الرسائل في a365.config.json
قبل تعيين نقطة نهاية الرسائل، حددها في ملف الإعدادات الخاص بك a365.config.json . يحتوي هذا الملف على التكوين الأساسي لنشر وكيلك.
إضافة أو تحديث خصائص تكوين نقطة نهاية الرسائل هذه:
{
"messagingEndpoint": "https://your-endpoint-url.com/api/messages",
"deploymentProjectPath": "."
}
messagingEndpointحدد عنوان نقطة النهاية الدقيق حيث يمكنك إرسال الرسائل إلى الوكيل.deploymentProjectPath: المسار إلى دليل مشروع الوكيل الخاص بك. هذه الخاصية غير ذات صلة إذا تم نشر وكيلك بالفعل ولا تحتاج إلى تحديث تكوين البيئة. ضبطهdeploymentProjectPathعلى الوضع.فقط إذا لم يكن رمز الوكيل موجودا على جهازك.
خصائص التكوين
| الخاصية | الوصف | مطلوب | افتراضي | مثال |
|---|---|---|---|---|
messagingEndpoint |
عنوان URL الذي يستقبل فيه وكيلك الرسائل | نعم | لا يوجد | https://your-app.azurewebsites.net/api/messages |
deploymentProjectPath |
المسار إلى دليل مشروع الوكيل لتحديثات التكوين | لا | . |
./my-agent او . |
خيارات تكوين نقطة النهاية
تعتمد القيمة messagingEndpoint على سيناريو النشر الخاص بك:
بالنسبة إلى عمليات توزيع Azure:
- Azure Web App:
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 - مزودو السحابة الآخرون: رابط نقطة النهاية المخصص الخاص بك
للاختبار المحلي باستخدام أنفاق التطوير:
- رابط نفق التطوير:
https://abc123xyz.devtunnels.ms:3978/api/messages
Important
deploymentProjectPath يحدد أين تبحث واجهة سطر الأوامر عن ملفات المشروع وأين يتم تحديث تكوين البيئة، مثل ملفات .env.
ملاحظة
عند استخدام أنفاق Dev للاختبار المحلي، قم بتحديث messagingEndpoint في a365.config.json باستخدام عنوان URL الخاص ب Dev Tunnel قبل تشغيل أمر الإعداد. لمزيد من المعلومات، راجع الاختبار باستخدام قنوات المطورين.
تعيين نقطة نهاية رسائل الوكيل
بعد تحديث a365.config.json الملف، استخدم هذا الأمر لتسجيل نقطة نهاية المراسلة بحيث يمكن لخدمة Agent 365 إرسال إعلامات إلى وكيلك.
بالنسبة لوكلاء M365 (Teams وCopilot)، مرر --m365 للتسجيل عبر Teams Graph.
# M365 agents — registers via Teams Graph (MCP Platform)
a365 setup blueprint --endpoint-only --m365
# Non-M365 agents — prints the Teams Developer Portal URL for manual configuration
a365 setup blueprint --endpoint-only
أثناء الاختبار المحلي، يمكنك تعيين هذه النقطة النهائية إلى نقطة نهاية نفق التطوير قبل نشر الوكيل إلى السحابة. لمزيد من المعلومات، راجع الاختبار باستخدام قنوات المطورين.
لتحديث عنوان URL لنقطة النهاية الموجودة:
a365 setup blueprint --update-endpoint https://your-new-host.example.com/api/messages --m365
نشر نقطة الاتصال النهائية
إذا لم يكن لديك وكيل تم نشره بالفعل على السحابة، تعرف على كيفية نشر العامل إلى Azure.
إذا كان لديك وكيلك بالفعل في السحابة، يمكنك تعيين نقطة نهاية الرسائل كما هو موضح سابقا.
تعلم كيفية ضبط نقطة الاتصال النهائية للرسائل على البعض من أكثر منصات الحوسبة السحابية شيوعًا: