แชร์ผ่าน


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

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

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

ชนิดตัวแปร

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

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

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

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

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

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

เอนทิตี

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

หมายเหตุ

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

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