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

หมายเหตุ

ฟีเจอร์ในบทความนี้ขับเคลื่อนด้วยฮาร์เนสมาตรฐาน ซึ่งใช้ตัวเลือกการเรียกเก็บเงินที่อธิบายไว้ใน การอนุญาตใช้งาน สําหรับตัวแทนที่ขับเคลื่อนด้วยฮาร์เนสมาตรฐาน เรียนรู้วิธีเข้าถึงฟีเจอร์มาตรฐานใน Access standard agent และ agent flows

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

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

ชนิดตัวแปร

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

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

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

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

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

เมื่อคุณสร้างกิ่งโดยใช้โหนด Condition Copilot Studio จะจัดลําดับกิ่งจากซ้ายไปขวา เอเจนต์จะพิจารณาโหนดในกิ่งซ้ายสุดก่อนโหนดในกิ่งขวาสุด

เอนทิตี

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

เอนทิตี้ ชนิดฐานตัวแปร
ตัวเลือกแบบหลายตัวเลือก ทางเลือก
คำตอบทั้งหมดของผู้ใช้ สตริง
อายุ ตัวเลข
แบบบูลีน แบบบูลีน
City สตริง
Color สตริง
ทวีป สตริง
ประเทศหรือภูมิภาค สตริง
วันที่และเวลา วันและเวลา
อีเมล สตริง
เหตุการณ์ สตริง
เลขจำนวนเต็ม เลขจำนวนเต็ม
ภาษา สตริง
เงิน ตัวเลข
ตัวเลข ตัวเลข
ลำดับ ตัวเลข
องค์กร สตริง
เปอร์เซ็นต์ ตัวเลข
ชื่อบุคคล สตริง
หมายเลขโทรศัพท์ สตริง
จุดสนใจ สตริง
ความเร็ว ตัวเลข
รัฐ/จังหวัด สตริง
ที่อยู่ สตริง
อุณหภูมิ ตัวเลข
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

ชื่อ Type คำจำกัดความ
กิจกรรม.ไฟล์แนบ ตาราง ไฟล์แนบที่ผู้ใช้ให้ไว้
กิจกรรม.ช่องทาง ทางเลือก รหัสช่องทางของการสนทนาปัจจุบัน
กิจกรรม.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 เท่านั้น
ผู้ใช้.ภาษา ทางเลือก ตัวแปรนี้ใช้เพื่อตั้งค่าตำแหน่งภาษาของผู้ใช้ในแต่ละการสนทนา

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

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

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

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

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

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

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

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

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

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

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

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