ربط Salesforce Agentforce ب Microsoft Agent 365

استخدم هذا الدليل لتوصيل Salesforce Agentforce بـ Microsoft Agent 365 ولجمع نشاط جلسات Agentforce لأغراض إمكانية ملاحظة العاملين الخارجيين.

قَبلَ البدء

• تأكد من أن مسؤول الذكاء الاصطناعي في Agent 365 يمكنه إنشاء الاتصالات في مركز مسؤولي Microsoft 365.
• اطلب من مسؤول Salesforce إكمال خطوات Salesforce في هذا المقال.
• تأكد من أن الذكاء الاصطناعي التوليدي لآينشتاين وAgentforce مفعلان في مؤسسة Salesforce.
• لجمع النشاط، تأكد من توفر Data 360 (المعروف سابقا بData Cloud) في المنظمة.

إنشاء تطبيق عميل خارجي في Salesforce

1. في Salesforce، اختر الإعداد، ثم ابحث عن مدير التطبيقات.
2. افتح مدير تطبيقات العميل الخارجي، ثم اختر تطبيق العميل الخارجي الجديد.
3. أدخل اسم التطبيق وبريد إلكتروني للتواصل.
4. اختر تفعيل OAuth، وأدخل عنوان URL للاستدعاء، مثل https://login.salesforce.com/services/oauth2/success.
5. تحت نطاقات OAuth، أضف هذه النطاقات:
   • الوصول إلى خدمات روبوت الدردشة (chatbot_api)
   • الوصول إلى النظام الأساسي لواجهة برمجة تطبيقات Salesforce (sfap_api)
   • إدارة بيانات المستخدم عبر واجهات برمجة التطبيقات (api)
   • تنفيذ الطلبات في أي وقت (refresh_token، offline_access)
6. تحت تمكين التدفق، اختر تمكين تدفق بيانات اعتماد العميل، ثم اختر الإنشاء.
7. في تبويب السياسات في التطبيق، اختر تعديل. تحت سياسات OAuth، فعّل Enable Client Credentials Flow.
8. قم بتعيين تشغيل باسم لمستخدم نشط لديه وصول إلى واجهة برمجة التطبيقات (API)، ثم اختر حفظ. لجمع النشاط، يجب أن يكون هذا المستخدم قادرا أيضا على الاستعلام عن مساحة بيانات Data 360.
9. في تبويب إعدادات التطبيق، قم بتوسيع إعدادات OAuth، واختر مفتاح المستهلك والسر، وسجل مفتاح المستهلك وسر المستهلك. ثم انسخ رابط النطاق الحالي من Setup>My domain.

تفعيل تتبع جلسات Agentforce

يجمع Agent 365 نشاط Agentforce من بيانات تتبع جلسات Agentforce في Data 360. شغّل التتبع قبل تشغيل الوكلاء. الجلسات التي تجري أثناء إيقاف التتبع لا تسجل ولا يمكن جمعها لاحقا.

1. إذا لم يتم إعداد Data 360، فانتقل إلى Setup>Data 360 Setup (Data Cloud Setup في بعض المؤسسات)، واختر بدء الاستخدام. قد تستغرق تهيئة الخدمة حتى ساعة.
2. في الإعداد، ابحث عن الحزم المثبتة، وتأكد من أن نموذج البيانات القياسي لـ Salesforce هو الإصدار 1.130 أو أحدث. لترقيته، راجع إعداد تتبع جلسات Agentforce.
3. في Setup، ابحث عن Einstein Generative AI، ثم اختر Einstein Audit, Analytics, and Monitoring Setup.
4. قم بتفعيل تتبع جلسات Agentforce إذا لم يكن مفعلا بالفعل. إذا طلب منك مساحة بيانات، اختر الافتراضي.
5. شغل تتبع منصة الوكلاء والتدقيق والتغذية الراجعة.

إنشاء الاتصال

1. افتح مركز إدارة Microsoft 365.
2. حدد الوكلاء>جميع الوكلاء.
3. في المنصات المتصلة، اختر الإدارة.
4. اختر + ربط منصة واختر Salesforce Agentforce.
5. أدخل عنوان URL الخاص بـ My Domain بدون مسار، ومفتاح المستهلك، وسر المستهلك.
6. تحقق من بيانات الاعتماد.
7. حفظ اتصال.
8. اختر وكلاء التزامن.

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

تحقق من الاتصال والنشاط

1. افتح الاتصال، وتأكد من نجاح المزامنة وظهور الوكلاء المتوقعين.
2. أجرِ محادثة مع وكيل نشط. على سبيل المثال، في Agentforce Builder، استخدم لوحة المعاينة في وضع الاختبار الحي ، وسجل معرف الجلسة.
3. (اختياري) في تطبيق Data 360، افتح Data Explorer، واختر مساحة البيانات المفعلة، وكائنات نماذج البيانات، وجلسة وكيل الذكاء الاصطناعي. تأكد من وجود صف لمعرف الجلسة.
4. في مركز إدارة Microsoft 365، افتح الاتصال واختر Sync agents. يجمع Agent 365 جلسات جديدة في كل مرة يتزامن فيها الاتصال.
5. في Agents>All Agents، افتح الوكيل، اختر النشاط، وتأكد أن الجلسات على الأقل 1.

الجلسات الأولى بعد تفعيل التتبع قد تستغرق حتى ساعتين للوصول إلى Data 360. إذا كانت الجلسات لا تزال صفر، انتظر بضع دقائق ثم قم بالمزامنة مرة أخرى. يعرض المستخدمون النشطاء الخيار غير قابل للتطبيق لأن جلسات Agentforce لا تتضمن هويات Microsoft Entra.

Note

في بعض الحالات، لا يقوم Data 360 بتحديث تدفقات البيانات وفقا لجدول زمني محدد. في تطبيق Data 360، افتح تدفقات البيانات، وافتح كل تدفق لتتبع جلسات Agentforce، واختر تحديث الآن.

Troubleshoot

عَرَض	السبب المحتمل	القرار
فشل التحقق من صحة الاعتمادات	تدفق بيانات اعتماد العميل ليس قيد التشغيل في كلٍّ من إعدادات التطبيق وسياسات OAuth، أو لم يتم تعيين تشغيل كـ، أو أن عنوان URL ليس عنوان URL للمجال الخاص بي‬	صحح التطبيق والرابط. قد يحتاج التطبيق الجديد إلى دقائق قليلة لقبول التدفق.
لا يظهر العامل بعد المزامنة	الوكيل غير نشط، أو أن مستخدم Run As لا يستطيع الوصول إليه	قم بتفعيل الوكيل في Agentforce Builder، وتحقق من صلاحيات المستخدم Run As ، ثم قم بالمزامنة مرة أخرى.
تتبع الجلسات في Agentforce غير متوفر	لم تتم تهيئة Data 360، أو Agentforce مغلق، أو نموذج بيانات Salesforce القياسي أقدم من 1.130	أكمِل تشغيل تتبّع جلسة Agentforce.
لا تظهر الجلسة في Data 360	كان التتبع غير فعال أثناء المحادثة، أو أن تدفق البيانات لم يتم تحديثه	شغّل محادثة جديدة بعد تشغيل التتبع. في مؤسسات إصدار المطورين، اختر تحديث الآن على تدفقات البيانات.
تظهر جلسة في Data 360، لكن النشاط فارغ	التجميع متوقف، والاتصال لم يتزامن منذ المحادثة، والتتبع يستخدم مساحة بيانات أخرى، أو أن المستخدم Run As لا يستطيع الاستعلام عن Data 360	حدد جمع بيانات إمكانية مراقبة العميل، ونفّذ المزامنة مرة أخرى، وامنح مستخدم تشغيل كـ حق الوصول إليها، على سبيل المثال باستخدام مجموعة أذونات مهندس بيانات السحابة (في السابق، مجموعة أذونات مسؤول بيانات السحابة).

إلغاء الوصول

إلغاء الوصول عن طريق تعطيل أو حذف تطبيق العميل الخارجي لـ Salesforce، أو تدوير سر المستهلك، أو إزالة وصول واجهة برمجة التطبيقات للمستخدم Run As.

لمشاكل الاتصال التي ليست خاصة ب Salesforce Agentforce، راجع استكشاف أخطاء المنصات المتصلة.