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

สำคัญ

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

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

หมายเหตุ

ข้อมูลความพร้อมใช้งานของคุณลักษณะมีดังนี้

Dynamics 365 Contact Center—แบบฝัง	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
ตัวแปรเสียงเท่านั้น	CustomerPhoneNumber	ใช้ตัวแปรบริบทนี้สำหรับหมายเลขโทรศัพท์ของลูกค้าในกิจกรรมโทรศัพท์	เลือกตัวแปรโซลูชันส่วนขยายของช่องทาง Omni สำหรับ Customer Service
	OrganizationPhoneNumber	ใช้ตัวแปรบริบทนี้สำหรับหมายเลขโทรศัพท์ขององค์กรในกิจกรรมโทรศัพท์	เลือกตัวแปรโซลูชันส่วนขยายของช่องทาง Omni สำหรับ Customer Service
ชื่อเมธอดส่วนขยาย	va_SurveyConsent	ใช้กล่องโต้ตอบนี้เพื่อพิจารณาว่าลูกค้าตกลงที่จะเข้าร่วมในแบบสำรวจระหว่างการสนทนาหรือไม่	ใช้วิธีนี้เพื่อส่งต่อรายละเอียดการสนทนาไปยังช่องทาง Omni สำหรับ Customer Service
	va_CustomerLocale	ใช้กล่องโต้ตอบนี้เพื่อโอนผู้ใช้ที่พูดคุยกับบอทในขณะนั้นนั้นไปยังบอทอื่นที่สามารถพูดภาษาอื่น	ตั้งค่ารหัสโดยเลือกตัวแปรอินพุตและใช้รหัสสถานที่ที่ถูกต้อง

กำหนดค่าตัวแปรบริบทสำหรับบอท 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