تكوين الْتسليم إلى أي مركز مشاركة عام

ملحوظة

تصف هذه المقالة الميزات المستخدمة في الوكلاء أو تدفقات الوكلاء التي تعمل بواسطة الحزام القياسي.

تمكنك Copilot Studio من تسليم محادثات الوكيل بسلاسة وسياقيا إلى عامل بشري من خلال مركز مشاركة.

باستخدام التطوير المخصص، يمكنك تكوين وكيلك لتسليم المحادثات لأي مركز تفاعل.

المتطلبات المسبقه

• لقد بنيت وكيل عملك باستخدام Copilot Studio.
• تحتاج إلى مركز تفاعل يمكنه التفاعل برمجيا باستخدام واجهات برمجة التطبيقات أو SDKs.

مهم

تتطلب هذه المقالة بعض مهارات تطوير البرامج. الخطوات الواردة في هذه المقالة مخصصة لمتخصصي تكنولوجيا المعلومات ذوي الخبرة مع فهم قوي لأدوات المطور والأدوات المساعدة وبيئات التطوير المتكاملة (IDEs).

نظرة عامة

يتبع التسليم الكامل لمركز التفاوض هذا النمط:

1. يتفاعل العميل مع لوحة دردشة مركز التفاوض.
2. يوجه مركز التفاوض الدردشة الواردة من خلال قدرات توجيه الدردشة المضمنة إلى وكيل.
3. يقوم المحول المخصص بترحيل رسائل الدردشة الواردة من مركز التفاوض إلى عامل Copilot Studio.
4. بمجرد أن يبدأ العميل عملية التسليم، يبدأ Copilot Studio التسليم مع سياق المحادثة الكامل.
5. يعترض المحول المخصص رسالة التسليم، ويحلل سياق المحادثة الكامل، ويوجه المحادثة التي تم تصعيدها بسلاسة إلى عامل بشري ماهر بناءً على التوفر.
6. يتم تسليم دردشة العميل بسلاسة وسياق إلى وكيل بشري يمكنه استئناف المحادثة.

لتسليم المحادثة إلى عامل بشري، تحتاج إلى إنشاء محول تسليم مخصص.

إنشاء محول تسليم مخصص

يقوم المحول بوصل المحادثات من وإلى مركز مشاركة الوكيل الخاص بك عن طريق ترحيل الرسائل وتحويلها بين العملاء والوكلاء والوكلاء البشريين.

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

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

تتيح لك هذه الأكواد البرمجية والعينات استخراج السياق من المحادثة لنقل محادثات الوكيل بشكل سلس ومتناغم مع السياق إلى أي مركز مشاركة شامل.

عينة حمولة رسالْة الْتسليم

يدعم Handoff حاليا فقط Direct Line. لمزيد من المعلومات، راجع التفاعل مع وكيل عبر خط مباشر. عند بدء التسليم، يقوم المحول برفع ويرسل نشاطا يسمى handoff.initiate.

يمكنك الاطلاع على نشاط رسالة تسليم نموذج كامل على موقعنا GitHub.

استخراج السياق من رسالة التسليم

لاستخدام سياق المحادثة، قم بتحليل handoff.initiate نشاط الحدث. يقوم مقتطف الكود التالي بتحليل handoff.initiate نشاط الحدث واستخراج السياق المحادثي. راجع نموذج التعليمات البرمجية full على GitHub.

public void InitiateHandoff(string botresponseJson)
{
    BotResponse response = JsonConvert.DeserializeObject<BotResponse>(botresponseJson);

    // Look for Handoff Initiate Activity. This indicates that conversation needs to be handed off to agent
    Activity handoffInitiateActivity = response.Activities.ToList().FirstOrDefault(
        item => string.Equals(item.Type, ActivityTypes.Event, System.StringComparison.Ordinal)
        && string.Equals(item.Name, HandoffInitiateActivityName, System.StringComparison.Ordinal));

    if (handoffInitiateActivity != null)
    {
        // Read transcript from attachment
        if (handoffInitiateActivity.Attachments?.Any() == true)
        {
            Attachment transcriptAttachment = handoffInitiateActivity.Attachments.FirstOrDefault(a => string.Equals(a.Name.ToLowerInvariant(), TranscriptAttachmentName, System.StringComparison.Ordinal));
            if (transcriptAttachment != null)
            {
                Transcript transcript = JsonConvert.DeserializeObject<Transcript>(transcriptAttachment.Content.ToString());
            }
        }

        // Read handoff context
        HandoffContext context = JsonConvert.DeserializeObject<HandoffContext>(handoffInitiateActivity.Value.ToString());

        // Connect to Agent Hub
        // <YOUR CUSTOM ADAPTER CODE GOES HERE>
    }
}