แชร์ผ่าน

กำหนดค่าตัวแปรบริบทสำหรับเอเจนต์

  • บทความ

สำคัญ

ความสามารถและคุณลักษณะต่างๆ ของ Power Virtual Agents เป็น ส่วนหนึ่งของ Microsoft Copilot Studio แล้ว ภายหลังการลงทุนที่สำคัญใน Generative AI และการรวมที่ได้รับการปรับปรุงใน Microsoft Copilot

บทความและภาพหน้าจอบางรายการอาจอ้างถึง Power Virtual Agents ในขณะที่เราอัปเดตคู่มือและเนื้อหาการฝึกอบรม

หมายเหตุ

เอเจนต์ Copilot Studio กำลังถูกเปลี่ยนชื่อเป็นเอเจนต์ Copilot (เอเจนต์) ตัวแทนที่เป็นมนุษย์เปลี่ยนชื่อเป็นเจ้าหน้าที่บริการลูกค้า (เจ้าหน้าที่บริการหรือเจ้าหน้าที่) คุณจะพบการอ้างอิงถึงข้อกำหนดเก่าและใหม่ในขณะที่เราอัปเดต UI ของผลิตภัณฑ์ เอกสารประกอบ และเนื้อหาการฝึกอบรม

นำไปใช้กับ: Dynamics 365 Contact Center—แบบสแตนด์อโลนและ Dynamics 365 Customer Service เท่านั้น

บทความนี้แสดงรายการตัวแปรบริบทสำหรับเอเจนต์ Azure และ Copilot Studio และวิธีที่คุณสามารถกำหนดค่าบอทในช่องทาง Omni สำหรับ Customer Service ในการทำความเข้าใจวิธีสร้างตัวแปรบริบท โปรดดู จัดการตัวแปรบริบท

ตัวแปรบริบทสำหรับเอเจนต์ Azure

ตารางต่อไปนี้มีรายการของตัวแปรบริบทในช่องทาง Omni สำหรับ Customer Service ที่คุณสามารถใช้สำหรับ การกำหนดค่าเอเจนต์ Azure

ชนิดตัวแปรบริบท ชื่อตัวแปรบริบท Description วิธีการแม็ปใน Azure
แบบสำรวจก่อนการสนทนา ใช้ชื่อคำถามแบบสำรวจก่อนการสนทนาที่คุณสร้างในช่องทาง Omni สำหรับ Customer Service ระบบจัดเก็บคำตอบจากแบบสำรวจก่อนการสนทนาเป็นตัวแปรบริบท ใช้ข้อมูลต่อไปนี้เพื่อแมปชื่อคำถามในช่องทาง Omni สำหรับ Customer Service กับชนิดตัวแปรใน Azure:
  • บรรทัดเดียว: สตริง
  • หลายบรรทัด: สตริง
  • ชุดตัวเลือก: สตริง
  • ความยินยอมของผู้ใช้: แบบบูลีน
บริบทแบบกำหนดเอง ใช้ชื่อตัวแปรที่คุณสร้างในช่องทาง Omni สำหรับ Customer Service หรือส่งผ่านโดยใช้ setContextProvider API ตัวแปรบริบทแบบกำหนดเองที่คุณสร้างและส่งผ่าน SDK การสนทนาสด แมปคำตอบของผู้ใช้เป็น JSON เพื่อใช้ตัวแปรบริบทที่กำหนดเองในช่องทาง Omni สำหรับ Customer Service
กรสนทนา msdyn_ConversationId ใช้ตัวแปรบริบทที่มี ID การสนทนาสำหรับการสนทนาที่กำลังดำเนินอยู่ และสามารถดึงข้อมูลและทำการดำเนินการในเรกคอร์ดใน Microsoft Dataverse สตริง: สตริง
ผู้ติดต่อ msdyn_contact_msdyn_ocliveworkitem_Customer ใช้ตัวแปรบริบทนี้ที่มี ID เรกคอร์ดสำหรับเรกคอร์ดลูกค้า (ผู้ติดต่อ) ที่เชื่อมโยงกับการสนทนา แยกวิเคราะห์ JSON เพื่อแยก ID เรกคอร์ด
บัญชี msdyn_account_msdyn_ocliveworkitem_Customer ใช้ตัวแปรบริบทนี้ที่มี ID เรกคอร์ดสำหรับเรกคอร์ดลูกค้าองค์กรที่เชื่อมโยงกับการสนทนา แยกวิเคราะห์ JSON เพื่อแยก ID เรกคอร์ด
กรณี msdyn_incident_msdyn_ocliveworkitem ใช้ตัวแปรบริบทนี้ที่มี ID เรกคอร์ดสำหรับเรกคอร์ดกรณีที่เชื่อมโยงกับการสนทนา แยกวิเคราะห์ JSON เพื่อแยก ID เรกคอร์ด

หมายเหตุ

ใช้ชื่อตัวแปรบริบทตามที่กำหนดไว้และไม่เปลี่ยนแปลงเมื่อคุณสร้างโฟลว์ในเอเจนต์ Azure หรือ Copilot Studio และตรวจสอบว่าใช้การตรงกันทุกประการเพื่อส่งผ่านค่าไปยังตัวแปรบริบทเนื่องจากต้องคำนึงถึงรูปแบบตัวพิมพ์ใหญ่เล็ก หากมีข้อมูลที่ไม่ตรงกัน ระบบจะไม่ระบุเรกคอร์ดโดยอัตโนมัติ ข้อมูลเพิ่มเติม: ระบุเรกคอร์ดโดยอัตโนมัติ

ตัวแปรบริบทสำหรับเอเจนต์ Copilot Studio

ตารางต่อไปนี้มีรายการของตัวแปรบริบทที่พร้อมใช้งานในช่องทาง Omni สำหรับ Customer Service ที่คุณสามารถใช้สำหรับ การกำหนดค่าเอเจนต์ Copilot Studio

สำคัญ

หากต้องการใช้ตัวแปรการส่งข้อความและเสียงได้ ต้องแน่ใจว่าคุณ ติดตั้งโซลูชันส่วนขยาย ก่อน

ชนิดตัวแปรบริบท ชื่อตัวแปรบริบท Description วิธีการแม็ปใน Copilot Studio
แบบสำรวจก่อนการสนทนา ใช้ชื่อคำถามแบบสำรวจก่อนการสนทนาที่คุณสร้างในช่องทาง Omni สำหรับ Customer Service ระบบจัดเก็บคำตอบจากแบบสำรวจก่อนการสนทนาเป็นตัวแปรบริบท ใช้ข้อมูลต่อไปนี้เพื่อแมปชื่อคำถามในช่องทาง Omni สำหรับ Customer Service กับชนิดตัวแปรใน Copilot Studio:
  • บรรทัดเดียว: คำตอบทั้งหมดของผู้ใช้
  • หลายบรรทัด: คำตอบทั้งหมดของผู้ใช้
  • ชุดตัวเลือก: คำตอบทั้งหมดของผู้ใช้
  • ความยินยอมของผู้ใช้: แบบบูลีน
บริบทแบบกำหนดเอง ใช้ชื่อตัวแปรที่คุณสร้างในช่องทาง Omni สำหรับ Customer Service หรือส่งผ่านโดยใช้ setContextProvider API ตัวแปรบริบทแบบกำหนดเองที่คุณสร้างและส่งผ่าน SDK การสนทนาสด ใช้ข้อมูลต่อไปนี้เพื่อแม็ปตัวแปรบริบทที่กำหนดเองในช่องทาง Omni สำหรับ Customer Service กับชนิดตัวแปรใน Copilot Studio:
  • สตริง: คำตอบทั้งหมดของผู้ใช้
    • บูลีน: บูลีน
  • หมายเลขเลขลอยตัว: หมายเลข
กรสนทนา msdyn_ConversationId ใช้ตัวแปรบริบทที่มี ID การสนทนาสำหรับการสนทนาที่กำลังดำเนินอยู่ และสามารถดึงข้อมูลและทำการดำเนินการในเรกคอร์ดใน Microsoft Dataverse สตริง: คำตอบทั้งหมดของผู้ใช้
ตัวแปรการส่งข้อความเท่านั้น msdyn_CustomerType ใช้ตัวแปรบริบทนี้ที่มีชนิดลูกค้าสำหรับเรกคอร์ด ลูกค้าองค์กร หรือ ผู้ติดต่อ ที่เชื่อมโยงกับการสนทนา เลือกตัวแปรโซลูชันส่วนขยายของช่องทาง Omni สำหรับ Customer Service
msdyn_CustomerName ใช้ตัวแปรบริบทนี้ที่มีชื่อลูกค้าสำหรับเรกคอร์ด ลูกค้าองค์กร หรือ ผู้ติดต่อ ที่เชื่อมโยงกับการสนทนา เลือกตัวแปรโซลูชันส่วนขยายของช่องทาง Omni สำหรับ Customer Service
msdyn_CustomerId ใช้ตัวแปรบริบทนี้ที่มีรหัสลูกค้าสำหรับเรกคอร์ด ลูกค้าองค์กร หรือ ผู้ติดต่อ ที่เชื่อมโยงกับการสนทนา เลือกตัวแปรโซลูชันส่วนขยายของช่องทาง Omni สำหรับ Customer Service
msdyn_CaseId ใช้ตัวแปรบริบทนี้ที่มีรหัสของเรกคอร์ดกรณีที่เชื่อมโยงกับการสนทนา เลือกตัวแปรโซลูชันส่วนขยายของช่องทาง Omni สำหรับ Customer Service
msdyn_CaseTitle ใช้ตัวแปรบริบทนี้ที่มีชื่อของเรกคอร์ดกรณีที่เชื่อมโยงกับการสนทนา เลือกตัวแปรโซลูชันส่วนขยายของช่องทาง Omni สำหรับ Customer Service
ตัวแปรเสียงเท่านั้น 1 CustomerPhoneNumber ใช้ตัวแปรบริบทนี้สำหรับหมายเลขโทรศัพท์ของลูกค้าในกิจกรรมโทรศัพท์ เลือกตัวแปรโซลูชันส่วนขยายของช่องทาง Omni สำหรับ Customer Service
OrganizationPhoneNumber ใช้ตัวแปรบริบทนี้สำหรับหมายเลขโทรศัพท์ขององค์กรในกิจกรรมโทรศัพท์ เลือกตัวแปรโซลูชันส่วนขยายของช่องทาง Omni สำหรับ Customer Service
ชื่อเมธอดส่วนขยาย va_SurveyConsent ใช้กล่องโต้ตอบนี้เพื่อพิจารณาว่าลูกค้าตกลงที่จะเข้าร่วมในแบบสำรวจระหว่างการสนทนาหรือไม่ ใช้วิธีนี้เพื่อส่งต่อรายละเอียดการสนทนาไปยังช่องทาง Omni สำหรับ Customer Service
va_CustomerLocale ใช้กล่องโต้ตอบนี้เพื่อโอนผู้ใช้ที่พูดคุยกับเอเจนต์ในขณะนั้นนั้นไปยังเอเจนต์อื่นที่สามารถพูดภาษาอื่น ตั้งค่ารหัสโดยเลือกตัวแปรอินพุตและใช้รหัสสถานที่ที่ถูกต้อง

1 หากต้องการใช้ตัวแปรบริบทอื่นๆ สำหรับเสียง คุณจะต้องรับค่าจาก Dataverse ได้โดยตรง เรียนรู้เพิ่มเติมใน กำหนดค่าเทมเพลตตัวอย่างเอเจนต์เสียง

กำหนดค่าตัวแปรบริบทสำหรับเอเจนต์ Copilot Studio

หากต้องการให้เอเจนต์ Copilot Studio ของคุณอ่านตัวแปรบริบทจากช่องทาง Omni ให้ทำตามขั้นตอนต่อไปนี้:

  1. บนหน้า หัวข้อ ให้เลือก เพิ่มหัวข้อ และ จากว่างเปล่า

  2. ป้อนชื่อหัวข้อของคุณ (เช่น "ตั้งค่าตัวแปรบริบท") แล้วบันทึก

  3. เพิ่มโหนดใหม่ให้กับหัวข้อ และเลือก การจัดการตัวแปร > ตั้งค่าตัวแปร

  4. ในโหนดใหม่ของคุณ ใต้ ตั้งค่าตัวแปร เลือก สร้างตัวแปรใหม่

  5. เปิดบานหน้าต่าง คุณสมบัติตัวแปร โดยคลิกชื่อตัวแปรใหม่ ในบานหน้าต่าง ให้ตั้งค่า ชื่อตัวแปร ให้ตรงกับชื่อของตัวแปรบริบทช่องทาง Omni ทุกประการ (คำนึงถึงตัวพิมพ์เล็กและตัวพิมพ์ใหญ่)

  6. ในส่วน การอ้างอิง ให้เลือกจุดไข่ปลา (...) และเลือก รับค่าจากโหนดนี้หากว่างเปล่า เอเจนต์ Copilot Studio ดึงค่าตัวแปรจากโหนดนี้ขณะรันไทม์

  7. ในส่วน การใช้ เลือก ทั้งหมด (หัวข้อใดๆ สามารถเข้าถึงได้)และ แหล่งภายนอกสามารถกำหนดค่าได้ Copilot Studio ยอมรับข้อมูลจากช่องทาง Omni ปิดบานหน้าต่าง คุณสมบัติตัวแปร

  8. ในโหนดของคุณ ให้ป้อนค่าใน ค่าเป็น ที่ตรงกับชนิดข้อมูลที่เอเจนต์ของคุณคาดหวัง ตัวอย่างเช่น หากตัวแทนของคุณคาดว่าจะมีสตริง ให้ตั้งค่า Text("") Copilot Studio ย้อนกลับไปเป็นค่าที่คุณตั้งไว้ที่นี่ หากข้อมูลไม่เข้าสู่การสนทนา

    กำหนดค่าตัวแปรบริบทในหัวข้อ

  9. บันทึกและเผยแพร่การเปลี่ยนแปลง

ในระหว่างการสนทนา ข้อมูลจากตัวแปรบริบทช่องทาง Omni จะถูกตั้งค่าในตัวแปร Copilot Studio และสามารถใช้ในตรรกะของเอเจนต์ได้

เอเจนต์ยังสามารถตั้งค่าตัวแปรบริบทของช่องทาง Omni ระหว่างการสนทนาได้อีกด้วย หากต้องการตั้งค่าตัวแปรช่องทาง Omni จากตรรกะ Copilot Studio ของคุณ ตรวจสอบให้แน่ใจว่าเอเจนต์ของคุณใช้ชื่อตัวแปรที่ถูกต้อง และตั้งค่าในคุณสมบัติ "ค่าเป็น" ในโหนดการจัดการตัวแปรของคุณ Copilot Studio ส่งต่อตัวแปรไปยังช่องทาง Omni ระหว่างการโอนไปยังเจ้าหน้าที่บริการลูกค้า ซึ่งมักใช้เพื่อเชื่อมโยงการสนทนากับกรณีที่ตัวแทนยกระดับการสนทนาเป็น เจ้าหน้าที่บริการ ข้อมูลเพิ่มเติมเกี่ยวกับวิธีการเชื่อมโยงเรกคอร์ดในช่องทาง Omni จากข้อมูลนี้: เชื่อมโยงลูกค้าและกรณีกับการสนทนา

ตัวแปรส่วนกลางที่สร้างขึ้นใน Copilot Studio สามารถส่งผ่านไปยังช่องทาง Omni สำหรับ Customer Service เมื่อมีการส่งต่อการสนทนา สำหรับรายการทั้งหมด โปรดดู ตัวแปรตามบริบทที่พร้อมใช้งานเมื่อส่งต่อ

แยกวิเคราะห์วัตถุ JSON เพื่อแยกรหัสเรกคอร์ด

ตรวจสอบให้แน่ใจว่าคุณมีรายละเอียดดังต่อไปนี้:

  • ตัวแปรบริบทของช่องทาง Omni สำหรับ Customer Service เช่น msdyn_contact_msdyn_ocliveworkitem_Customer
  • รายละเอียด Schema

สำเนาของรายละเอียด Schema ตัวอย่างมีดังนี้:

        Schema: 
        {
            "type": "array",
            "items": {
                "type": "object",
                "properties": {
                    "RecordId": {
                        "type": "string"
                    },
                    "PrimaryDisplayValue": {
                        "type": "string"
                    }
                },
                "required": [
                    "RecordId",
                    "PrimaryDisplayValue"
                ]
            }
        }

PrimaryDisplayValue มีค่าจากแอตทริบิวต์ในเอนทิตี Dataverse การแม็ปสำหรับแอตทริบิวต์เอนทิตีมีดังนี้:

  • กรณีและปัญหา: ชื่อกรณีและปัญหา
  • ผู้ติดต่อ: ชื่อนามสกุล
  • ลูกค้าองค์กร: ชื่อ

นี่คือตัวอย่างเรกคอร์ดบริบท

{
    "msdyn_contact_msdyn_ocliveworkitem_Customer": [
        {
            "RecordId": "<GUID>",
            "PrimaryDisplayValue": "<FullName>"
        }
    ],
    "msdyn_liveworkitemid": "<GUID>"
}

รวมเอเจนต์ Copilot Studio
รวมเอเจนต์ Azure
กำหนดค่าเอเจนต์ให้ส่งต่อและจบการสนทนา
แชทสดการอ้างอิง SDK