ภาพรวมตัวแปร

ตัวแปรมีอยู่สี่ระดับหรือขอบเขต:

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

ชนิดตัวแปร

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

ชนิด	รายละเอียด
สตริง	ลำดับของอักขระที่ใช้แทนข้อความ
แบบบูลีน	ค่าตรรกะที่สามารถเป็นได้คือ true หรือ false เท่านั้น
ตัวเลข	จำนวนจริงใดๆ
ตาราง	รายการค่า แต่ค่าทั้งหมดต้องเป็นชนิดเดียวกัน
บันทึก	คอลเลกชันของคู่ค่าชื่อ ที่ค่าสามารถเป็นชนิดใดก็ได้
วันและเวลา	วันที่ เวลา วันในสัปดาห์ หรือเดือนที่สัมพันธ์กับจุดในเวลา
ทางเลือก	รายการค่าสตริงพร้อมคำพ้องความหมายที่เกี่ยวข้อง
ว่าง	ตัวยึดสำหรับ "ไม่มีค่า" หรือ "ค่าที่ไม่รู้จัก" สำหรับข้อมูลเพิ่มเติม โปรดดู ว่างเปล่า ในเอกสาร Power Fx

คุณตั้งค่าชนิดของตัวแปรในครั้งแรกที่คุณกำหนดค่าให้กับตัวแปรนั้น หลังจากนั้นชนิดจะคงที่และคุณไม่สามารถกำหนดค่าชนิดอื่นได้ ตัวอย่างเช่น ถ้าคุณกำหนดค่าเริ่มต้น1ให้กับตัวแปร คุณตั้งค่าชนิดเป็น ตัวเลข ถ้าคุณพยายามกำหนดค่า สตริง เช่น "apples" คุณจะได้รับข้อผิดพลาด

เมื่อคุณทดสอบเอเจนต์ ตัวแปรอาจปรากฏขึ้นชั่วคราวโดยมีชนิด ไม่รู้จัก ตัวแปรที่ไม่รู้จักยังไม่มีค่า

ลำดับของตัวแปรจะถูกกำหนดจากบนลงล่างของการเขียนพื้นที่ทำงาน โหนดที่อยู่ด้านบนของผืนผ้าใบการสร้างจะได้รับการพิจารณาก่อนโหนดที่อยู่ด้านล่าง

เมื่อคุณสร้างสาขาด้วยโหนด เงื่อนไข สาขาจะเรียงลำดับจากซ้ายไปขวา โหนดในสาขาซ้ายสุดจะได้รับการพิจารณาก่อนโหนดในสาขาขวาสุด

เอนทิตี

เว็บแอป

Copilot Studio ใช้เอนทิตี เพื่อระบุชนิดข้อมูลเฉพาะจากการตอบกลับของผู้ใช้ ข้อมูลที่ระบุจะถูกบันทึกไว้ในตัวแปรชนิดที่เหมาะสมกับข้อมูลนั้น ตารางต่อไปนี้แสดงรายการชนิดฐานของตัวแปรที่เกี่ยวข้องกับเอนทิตีที่สร้างไว้ล่วงหน้า

เเอนทิตี	ชนิดฐานตัวแปร
ตัวเลือกแบบหลายตัวเลือก	ทางเลือก
คำตอบทั้งหมดของผู้ใช้	สตริง
อายุ	ตัวเลข
แบบบูลีน	แบบบูลีน
เมือง	สตริง
สี	สตริง
ทวีป	สตริง
ประเทศหรือภูมิภาค	สตริง
วันที่และเวลา	วันและเวลา
อีเมล	สตริง
กิจกรรม	สตริง
จำนวนเต็ม	จำนวนเต็ม
ภาษา	สตริง
เงิน	ตัวเลข
ตัวเลข	ตัวเลข
ลำดับ	ตัวเลข
องค์กร	สตริง
เปอร์เซ็นต์	ตัวเลข
ชื่อบุคคล	สตริง
หมายเลขโทรศัพท์	สตริง
จุดสนใจ	สตริง
ความเร็ว	ตัวเลข
สถานะ	สตริง
ที่อยู่	สตริง
อุณหภูมิ	ตัวเลข
URL	สตริง
น้ำหนัก	ตัวเลข
รหัสไปรษณีย์	สตริง
เอนทิตีแบบกำหนดเอง	ทางเลือก

คลาสสิก

Copilot Studio ใช้เอนทิตี เพื่อระบุชนิดข้อมูลเฉพาะจากการตอบกลับของผู้ใช้ ข้อมูลที่ระบุจะถูกบันทึกไว้ในตัวแปรชนิดที่เหมาะสมกับข้อมูลนั้น

ตารางต่อไปนี้แสดงรายการชนิดฐานของตัวแปรที่เกี่ยวข้องกับเอนทิตีที่สร้างไว้ล่วงหน้าแต่ละรายการ ชนิดฐานจะกำหนดตัวดำเนินการที่คุณสามารถใช้ได้เมื่อคุณสร้างนิพจน์เชิงตรรกะด้วยตัวแปรที่เกี่ยวข้อง นอกจากนี้ยังกำหนดว่าคุณสามารถ ป้อนตัวแปรให้โฟลว์ หรือ ทักษะ Bot Framework เป็นพารามิเตอร์อินพุตได้หรือไม่

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

เเอนทิตี	ชนิดฐานตัวแปร
ตัวเลือกหลายแบบ	สตริง
คำตอบทั้งหมดของผู้ใช้	สตริง
อายุ	ตัวเลข
แบบบูลีน	แบบบูลีน
เมือง	สตริง
สี	สตริง
ทวีป	สตริง
ประเทศหรือภูมิภาค	สตริง
วันที่และเวลา	สตริง
ระยะเวลา	สตริง
อีเมล	สตริง
กิจกรรม	สตริง
ภาษา	สตริง
เงิน	สตริง
ตัวเลข	สตริง
ลำดับ	สตริง
องค์กร	สตริง
เปอร์เซ็นต์	ตัวเลข
ชื่อบุคคล	สตริง
หมายเลขโทรศัพท์	สตริง
จุดสนใจ	สตริง
ความเร็ว	ตัวเลข
สถานะ	สตริง
ที่อยู่	สตริง
อุณหภูมิ	ตัวเลข
URL	สตริง
น้ำหนัก	ตัวเลข
รหัสไปรษณีย์	สตริง
เอนทิตีแบบกำหนดเอง	สตริง

ตัวแปรสภาพแวดล้อม

ตัวแปรสภาพแวดล้อม เป็นแนวคิดของ Power Platform ตัวแปรสภาพแวดล้อมจะสร้างสถานการณ์สมมติของการจัดการวงจรชีวิตของแอปพลิเคชัน (ALM) ขั้นพื้นฐานในการย้ายแอปพลิเคชันระหว่างสภาพแวดล้อม Power Platform ในสถานการณ์นี้ แอปพลิเคชันจะยังคงเหมือนเดิมทุกประการ ยกเว้นการอ้างอิงภายนอกที่สำคัญบางรายการที่แตกต่างกันระหว่างสภาพแวดล้อมต้นทางและสภาพแวดล้อมปลายทาง

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

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

ชนิดตัวแปรสภาพแวดล้อมใน Copilot Studio แมปกับชนิดข้อมูล Power Apps ดังนี้:

พิมพ์ใน Copilot Studio	พิมพ์ใน Power Apps
เลขทศนิยม	ตัวเลข
JSON	ตรวจจับชนิดจากค่า หากไม่ใช่ JSON => ไม่ได้ระบุ (ข้อผิดพลาดในการตรวจสอบ)
ข้อความ	สตริง
ใช่/ไม่	แบบบูลีน
แหล่งข้อมูล	สตริง
ข้อมูลลับ	สตริง

หมายเหตุ

ข้อผิดพลาดของตัวแปรสภาพแวดล้อมสามารถมองเห็นได้ในแชททดสอบและเมื่อเผยแพร่ อย่างไรก็ตาม ข้อผิดพลาดเหล่านี้จะไม่แสดงในรายการหัวข้อ เนื่องจากไม่ใช่ตัวแปรหัวข้อ

ตัวแปรของระบบ

เอเจนต์ทุกตัวมาพร้อมกับตัวแปรระบบในตัวที่ให้ข้อมูลเพิ่มเติมเกี่ยวกับการสนทนา

หมายเหตุ

สำหรับข้อมูลเพิ่มเติมเกี่ยวกับตัวแปร เอเจนต์ ที่เปิดใช้งานเสียง โปรดดู ใช้ตัวแปรเสียง

Copilot Studio ไม่แสดงตัวแปรของระบบทั้งหมด หากต้องการเข้าถึงตัวแปรระบบที่ซ่อนอยู่ ให้ใช้สูตร Power Fx

หากต้องการใช้ตัวแปรระบบในสูตร Power Fx ให้เพิ่ม System. ก่อนชื่อตัวแปร ตัวอย่างเช่น หากต้องการรวมตัวแปรระบบ User.DisplayName ไว้ในสูตร ให้อ้างถึงตัวแปรดังกล่าวเป็น System.User.DisplayName

ชื่อ	ชนิด	ข้อกำหนด
กิจกรรม.ไฟล์แนบ	ตาราง	ไฟล์แนบที่ผู้ใช้ให้ไว้
กิจกรรม.ช่องทาง	ทางเลือก	รหัสช่องทางของการสนทนาปัจจุบัน
กิจกรรม.ChannelData	ใดๆ	ออบเจ็กต์ที่มีเนื้อหาเฉพาะช่องทาง
Activity.ChannelId	สตริง	รหัสช่องทางของการสนทนาปัจจุบัน เป็นแบบสตริง
Activity.From.Id	สตริง	รหัสเฉพาะช่องทางเฉพาะของผู้ส่ง
Activity.From.Name	สตริง	ชื่อผู้ใช้ที่จำง่ายเฉพาะช่องทางของผู้ส่ง
ชื่อกิจกรรม	สตริง	ชื่อของเหตุการณ์
Activity.Recipient.Id	สตริง	คุณสมบัติ Type ของกิจกรรมที่เข้ามา
Activity.Recipient.Name	สตริง	แสดงชื่อที่แสดงสำหรับเอเจนต์ภายในช่องทาง ในบริบทของช่องทางโทรศัพท์ ค่าของตัวแปรนี้จะเป็นหมายเลขโทรศัพท์ที่แนบกับเอเจนต์
กิจกรรม.ข้อความ	สตริง	ข้อความล่าสุดที่ส่งโดยผู้ใช้
Activity.Type	ทางเลือก	ชนิดของ กิจกรรม
Activity.TypeId	สตริง	ชนิดของ กิจกรรม เป็นแบบสตริง
Activity.Value	ใดๆ	ค่าแบบไม่จำกัด
Bot.EnvironmentId	สตริง	รหัสสภาพแวดล้อมของเอเจนต์
Bot.Id	สตริง	รหัสของเอเจนต์
Bot.Name	สตริง	ชื่อของเอเจนต์ของคุณ
Bot.SchemaName	สตริง	ชื่อสคีมาของเอเจนต์
Bot.TenantId	สตริง	รหัสผู้เช่าของเอเจนต์
ClientPluginActions	ทางเลือก	คอลเลกชันการดำเนินการปลั๊กอินไคลเอ็นต์แบบไดนามิกที่ต้องพิจารณาสำหรับการประสานรวมที่สร้างอัตโนมัติ
Conversation.Id	สตริง	รหัสเฉพาะของการสนทนาปัจจุบัน
บทสนทนาในโหมดทดสอบ	แบบบูลีน	ค่าสถานะแบบแบบบูลีนที่แสดงว่าการสนทนากำลังเกิดขึ้นในพื้นที่ทำงานทดสอบหรือไม่
Conversation.LocalTimeZone	สตริง	ชื่อของโซนเวลาที่ผู้ใช้จะใช้ในรูปแบบฐานข้อมูลโซนเวลา IANA
Conversation.LocalTimeZoneOffset	วันที่เวลา	การชดเชยเวลาจากเวลามาตรฐานโลก (UTC) สำหรับเวลาในโซนปัจจุบันในท้องถิ่น
รหัสข้อผิดพลาด	สตริง	รหัสข้อผิดพลาดสำหรับข้อผิดพลาดปัจจุบัน ข้อความแสดงข้อผิดพลาดสำหรับข้อผิดพลาดปัจจุบัน
ข้อความแสดงข้อผิดพลาด	สตริง	ข้อความแสดงข้อผิดพลาดสำหรับข้อผิดพลาดปัจจุบัน หมายเหตุ: ตัวแปรนี้ได้รับการรองรับเฉพาะเมื่อการทริกเกอร์เป็น On Error เท่านั้น
FallbackCount	ตัวเลข	ตัวแปรนี้จะนับจำนวนครั้งที่ไม่สามารถจับคู่หัวข้อกับอินพุตของผู้ใช้ได้ หมายเหตุ: ตัวแปรนี้ได้รับการรองรับเฉพาะเมื่อการทริกเกอร์เป็น On Unknown Intent เท่านั้น
InactivityTimer.Continue	แบบบูลีน	ค่าสถานะแบบบูลีนที่แสดงว่าตัวจับเวลาจำเป็นต้องดำเนินการต่อหรือไม่ หมายเหตุ: ตัวแปรนี้ได้รับการรองรับเฉพาะเมื่อการทริกเกอร์เป็น Inactivity เท่านั้น
InactivityTimer.Count	ตัวเลข	จำนวนครั้งที่ตัวจับเวลา OnInactivity เริ่มทำงานเนื่องจากผู้ใช้ไม่มีการใช้งานหลังจากเวลาที่กำหนดไว้ หมายเหตุ: ตัวแปรนี้ได้รับการรองรับเฉพาะเมื่อการทริกเกอร์เป็น Inactivity เท่านั้น
LastMessage.Id	สตริง	รหัสของข้อความก่อนหน้าที่ส่งโดยผู้ใช้
ข้อความล่าสุด.Text	สตริง	ข้อความก่อนหน้าที่ส่งโดยผู้ใช้
Recognizer.ExtractedEntities	ทางเลือก	แสดงถึงเอนทิตีที่ดึงออกมาจากข้อความที่ทริกเกอร์ หมายเหตุ: ตัวแปรนี้ได้รับการรองรับเฉพาะเมื่อการทริกเกอร์เป็น On Select Intent เท่านั้น
Recognizer.IntentOptions	ทางเลือก	แสดงถึงตัวเลือกจุดประสงค์เมื่อตัวรับรู้ส่งคืนผลลัพธ์ที่ไม่ชัดเจน หมายเหตุ: ตัวแปรนี้ได้รับการรองรับเฉพาะเมื่อการทริกเกอร์เป็น On Select Intent เท่านั้น
Recognizer.เจตนาที่เลือก	ทางเลือก	แสดงถึงเจตจำนงที่เลือกจากโปรแกรมตรวจจับ หมายเหตุ: ตัวแปรนี้ได้รับการรองรับเฉพาะเมื่อการทริกเกอร์เป็น On Select Intent เท่านั้น
Recognizer.TriggeringMessage.Id	สตริง	รหัสของข้อความผู้ใช้ที่ทริกเกอร์หัวข้อปัจจุบัน
Recognizer.TriggeringMessage.Text	สตริง	ข้อความผู้ใช้ที่ทริกเกอร์หัวข้อปัจจุบัน
Recognizer.เหตุผลการจับคู่หลายหัวข้อ	สตริง	ใช้เพื่อกำหนดสาเหตุที่จับคู่หลายหัวข้อ หมายเหตุ: ตัวแปรนี้ได้รับการรองรับเฉพาะเมื่อการทริกเกอร์เป็น On Select Intent เท่านั้น
เหตุผลในการลงชื่อเข้าใช้	ทางเลือก	ใช้เพื่อกำหนดว่าจำเป็นต้องใช้ตัวเลือกลงชื่อเข้าใช้แบบใดเมื่อทริกเกอร์หัวข้อ หมายเหตุ: ตัวแปรนี้ได้รับการรองรับเฉพาะเมื่อการทริกเกอร์เป็น On Sign In เท่านั้น
ผู้ใช้.ภาษา	ทางเลือก	ตัวแปรนี้ใช้เพื่อตั้งค่าตำแหน่งภาษาของผู้ใช้ในแต่ละการสนทนา

ตัวแปรสำหรับการรับรองความถูกต้องแบบรวม (ค่าเริ่มต้น)

ตัวแปรต่อไปนี้สามารถใช้งานสำหรับเอเจนต์ที่กำหนดค่าให้รับรองความถูกต้องกับ Microsoft การกำหนดค่านี้ใช้การรับรองความถูกต้อง Microsoft Entra ID และเป็นค่าเริ่มต้นสำหรับเอเจนต์ใหม่

สำหรับข้อมูลเพิ่มเติม โปรดดู ตัวแปรการรับรองความถูกต้อง

ชื่อ	ชนิด	ข้อกำหนด
ชื่อที่แสดงของผู้ใช้	สตริง	ชื่อที่แสดงของผู้ใช้ที่กำลังพูดคุยกับ เอเจนต์
User.Email	สตริง	ที่อยู่อีเมลของผู้ใช้ที่กำลังพูดคุยกับ เอเจนต์
ชื่อผู้ใช้.ชื่อแรก	สตริง	ชื่อของผู้ใช้ที่กำลังคุยกับ เอเจนต์
User.Id	สตริง	ID เฉพาะของผู้ใช้ที่กำลังพูดคุยกับ เอเจนต์
User.IsLoggedIn	แบบบูลีน	ค่าสถานะบูลีนที่แสดงว่าผู้ใช้ที่กำลังพูดคุยกับ เอเจนต์ ได้รับการรับรองความถูกต้องหรือไม่
นามสกุลผู้ใช้	สตริง	ชื่อสกุลของผู้ใช้ที่กำลังพูดคุยกับเอเจนต์
User.PrincipalName	สตริง	ชื่อผู้ใช้หลักของผู้ใช้ที่กำลังคุยกับเอเจนต์ในขณะนี้

ตัวแปรสำหรับการรับรองความถูกต้องด้วยตนเองด้วย OAuth 2 ทั่วไป

ตัวแปรต่อไปนี้จะพร้อมใช้งานสำหรับเอเจนต์ที่กำหนดค่าให้ใช้ผู้ให้บริการทั่วไป OAuth 2

ชื่อ	ชนิด	ข้อกำหนด
โทเค็นการเข้าถึงของผู้ใช้ (User.AccessToken)	สตริง	โทเค็นการเข้าถึงสำหรับผู้ใช้ที่รับรองความถูกต้องด้วยเอเจนต์
ชื่อที่แสดงของผู้ใช้	สตริง	ชื่อที่แสดงของผู้ใช้ที่กำลังพูดคุยกับ เอเจนต์
User.Id	สตริง	ID เฉพาะของผู้ใช้ที่กำลังพูดคุยกับ เอเจนต์
User.IsLoggedIn	แบบบูลีน	ค่าสถานะบูลีนที่แสดงว่าผู้ใช้ที่กำลังพูดคุยกับ เอเจนต์ ได้รับการรับรองความถูกต้องหรือไม่

ตัวแปรสำหรับการรับรองความถูกต้องด้วยตนเองด้วย Microsoft Entra ID

ตัวแปรต่อไปนี้จะพร้อมใช้งานสำหรับเอเจนต์ที่กำหนดค่าให้ใช้ผู้ให้บริการ Microsoft Entra ID (ชื่อเดิมคือ Azure Active Directory)

ชื่อ	ชนิด	ข้อกำหนด
โทเค็นการเข้าถึงของผู้ใช้ (User.AccessToken)	สตริง	โทเค็นการเข้าถึงสำหรับผู้ใช้ที่รับรองความถูกต้องด้วยเอเจนต์
ชื่อที่แสดงของผู้ใช้	สตริง	ชื่อที่แสดงของผู้ใช้ที่กำลังพูดคุยกับ เอเจนต์
User.Email	สตริง	ที่อยู่อีเมลของผู้ใช้ที่กำลังพูดคุยกับ เอเจนต์
ชื่อผู้ใช้.ชื่อแรก	สตริง	ชื่อของผู้ใช้ที่กำลังคุยกับ เอเจนต์
User.Id	สตริง	ID เฉพาะของผู้ใช้ที่กำลังพูดคุยกับ เอเจนต์
User.IsLoggedIn	แบบบูลีน	ค่าสถานะบูลีนที่แสดงว่าผู้ใช้ที่กำลังพูดคุยกับ เอเจนต์ ได้รับการรับรองความถูกต้องหรือไม่
นามสกุลผู้ใช้	สตริง	ชื่อสกุลของผู้ใช้ที่กำลังพูดคุยกับเอเจนต์
User.PrincipalName	สตริง	ชื่อหลักของผู้ใช้ที่กำลังพูดคุยกับเอเจนต์

ตัวแปรสำหรับเอเจนต์ที่เปิดใช้งานเสียง

ตัวแปรต่อไปนี้ใช้ได้เฉพาะกับเอเจนต์ที่เปิดใช้งานเสียงเท่านั้น

หมายเหตุ

สำหรับข้อมูลเพิ่มเติมเกี่ยวกับตัวแปร เอเจนต์ ที่เปิดใช้งานเสียง โปรดดู ใช้ตัวแปรเสียง

ชื่อ	ชนิด	ข้อกำหนด
กิจกรรม.ป้อนคีย์DTMF	สตริง	ค่าคีย์ DTMF ดิบจากระบบโทรศัพท์
กิจกรรม.การจดจำเสียง.ความเชื่อมั่น	ตัวเลข	คะแนนความเชื่อมั่นสำหรับผลลัพธ์ทั้งหมดของสมมติฐานการกู้คืนไซต์ Azure เป็น 0 ถึง 1
Activity.SpeechRecognition.MinimallyFormattedText	สตริง	ข้อความที่จัดรูปแบบเล็กน้อยของผลลัพธ์สมมติฐานการกู้คืนไซต์ Azure ตัวอย่างเช่น "Five hundred dollars." มีการสะกดคำ แต่รวมการใช้อักษรตัวพิมพ์ใหญ่และเครื่องหมายวรรคตอนพื้นฐานไว้ด้วย
Activity.UserInputType	ทางเลือก	ชนิดของอินพุตล่าสุดจากผู้ใช้เอเจนต์ ค่าสามารถเป็นได้ทั้งทดสอบ คำพูด หรือ DTMF
การสนทนา.อนุญาตเฉพาะ DTMF	แบบบูลีน	ค่าสถานะแบบบูลีนที่แสดงว่าควรตั้งค่า IVR ให้เป็นโหมด DTMF เท่านั้นในระหว่างรันไทม์หรือไม่
การสนทนา.SipUuiHeaderValue	สตริง	สตริงส่วนหัว UUI ที่ใช้เพื่อส่งบริบทไปยัง IVR เมื่อเริ่มต้นการโทร