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

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

مع بعض التطوير المخصص، يمكنك تكوين وكيلك لتسليم المحادثات إلى أي مركز مشاركة.

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

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

هام

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

نظرة عامة

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

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

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

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

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

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

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

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

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

يدعم التحويل حالياً 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>
    }
}