แชร์ผ่าน

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

  • บทความ

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

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

ชนิดตัวแปร

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

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

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

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

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

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

เอนทิตี

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

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

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

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

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

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

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

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

หมายเหตุ

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

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

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

ภาพหน้าจอของตัวแปรระบบในหัวข้อของเอเจนต์

หมายเหตุ

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

หมายเหตุ

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

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