หมายเหตุ
การเข้าถึงหน้านี้ต้องได้รับการอนุญาต คุณสามารถลอง ลงชื่อเข้าใช้หรือเปลี่ยนไดเรกทอรีได้
การเข้าถึงหน้านี้ต้องได้รับการอนุญาต คุณสามารถลองเปลี่ยนไดเรกทอรีได้
ใช้ตัวแปรเพื่อจัดเก็บคําตอบของลูกค้าเพื่อให้คุณสามารถนําเนื้อหากลับมาใช้ในภายหลังในการสนทนาได้
คุณยังสามารถใช้ตัวแปรเพื่อสร้างนิพจน์เชิงตรรกะที่กำหนดเส้นทางลูกค้าแบบไดนามิกไปตามเส้นทางการสนทนาต่างๆ ได้ด้วย ตัวอย่างเช่น บันทึกชื่อของลูกค้าในตัวแปรที่เรียกว่า customerNameและตัวแทนสามารถจัดการกับลูกค้าตามชื่อขณะที่การสนทนายังคงดําเนินต่อไป
คุณสามารถส่งผ่านตัวแปรไปยังและส่งกลับจาก หัวข้ออื่น ๆ และ โฟลว์ Power Automate ได้
สร้างตัวแปร
โหนดใด ๆ ที่แสดงเอาต์พุต เช่น โหนด คําถาม จะสร้างตัวแปรเอาต์พุตของประเภทที่เหมาะสมโดยอัตโนมัติ
เคล็ดลับ
เปลี่ยนชื่อโหนดเพื่อให้สามารถระบุได้ง่ายขึ้น เลือกช่องชื่อโหนดเพื่ออัปเดตชื่อโดยตรง หรือเลือกจุดสามจุด (...) ของโหนด แล้วเลือกเปลี่ยน ชื่อ จากเมนู นอกจากนี้คุณยังสามารถเปลี่ยนชื่อโหนดใน ตัวแก้ไขโค้ด
ไม่สามารถเปลี่ยนชื่อโหนด ทริกเกอร์ และโหนด ไปที่ขั้นตอน ได้
ชื่อโหนดสามารถมีความยาวได้สูงสุด 500 อักขระ
เลือกเอนทิตีที่จะใช้
โหนดคําถามใช้ตัวเลือกหลายตัวเลือกตามค่าเริ่มต้น หากต้องการใช้ เอนทิตีที่สร้างไว้ล่วงหน้าหรือแบบกําหนดเองอื่น ให้เลือกกล่อง ระบุ จากนั้นเลือกชนิดของข้อมูลที่คุณต้องการ
เปลี่ยนชื่อตัวแปร
เมื่อต้องการทําให้ตัวแทนของคุณง่ายต่อการบํารุงรักษา ให้แทนที่ชื่อเริ่มต้นของแต่ละตัวแปรด้วยชื่อที่มีความหมาย
เลือกตัวแปร แผง คุณสมบัติตัวแปร จะปรากฏขึ้น
ภายใต้ ชื่อตัวแปร ให้ใส่ชื่อที่คุณต้องการสําหรับตัวแปรของคุณ
ตั้งค่าตัวแปร
โดยทั่วไปแล้ว คุณจะใช้โหนด คําถาม เพื่อจัดเก็บข้อมูลป้อนเข้าของผู้ใช้ในตัวแปร อย่างไรก็ตาม คุณอาจต้องการตั้งค่าตัวแปรด้วยตัวคุณเอง ในกรณีดังกล่าว ให้ใช้โหนด ตั้งค่าตัวแปร
เลือกไอคอน เพิ่มโหนด
ภายใต้โหนดที่คุณต้องการเพิ่มโหนดค่าตัวแปรเลือก การจัดการ>ตัวแปรตั้งค่าตัวแปร โหนด ตั้งค่าตัวแปร จะปรากฏบนแคนวาส
เลือกกล่องภายใต้ตั้งค่าตัวแปร แผง เลือกตัวแปร จะปรากฏขึ้น
ถ้าตัวแปรที่คุณต้องการตั้งค่ามีอยู่แล้ว ให้เลือกตัวแปรนั้น
มิฉะนั้น เลือกสร้างใหม่ การดําเนินการนี้จะเป็นการสร้างตัวแปรใหม่ ชนิดของตัวแปรจะเป็น ไม่รู้จัก จนกว่าคุณจะกำหนดค่า
สําหรับ ถึง ค่า ให้กําหนดค่าโดยใช้หนึ่งในตัวเลือกต่อไปนี้:
พิมพ์ ค่าสัญพจน์
เลือกตัวแปรชนิดเดียวกันที่มีอยู่
ใช้ สูตร Power Fx สูตร Power Fx มีประโยชน์สำหรับชนิดที่ซับซ้อนขึ้น ซึ่งไม่สามารถใช้ค่าสัญพจน์ได้ เช่น ชนิดตารางและชนิดของเรกคอร์ด
ใช้ตัวแปรในโหนดการดําเนินการ
เมื่อคุณใช้ตัวแปรในโหนด การดําเนินการ หากชนิดพื้นฐานตรงกับชนิดพารามิเตอร์ที่ระบุสําหรับโฟลว์หรือสําหรับทักษะเฟรมเวิร์กของ Bot คุณสามารถป้อนให้กับพารามิเตอร์นั้นได้ ผลลัพธ์จากโหนด การดําเนินการ จะสร้างตัวแปรใหม่
สําหรับบริบทเพิ่มเติม ให้ดูสถานการณ์ตัวอย่างในเรียกใช้โฟลว์ตัวแทนจากหัวข้อและใช้ตัวแปรอินพุตและเอาท์พุตเพื่อส่งผ่านข้อมูล
ใช้ค่าสัญพจน์สำหรับอินพุตตัวแปร
ในโหนดที่คุณตั้งค่าสําหรับพารามิเตอร์การป้อนข้อมูล คุณสามารถป้อนค่าสัญพจน์แทนที่จะเลือกตัวแปรอื่นเป็นค่า
โหนดพยายามตีความค่าตัวอักษรเป็นสตริง ตัวเลข หรือบูลีน ตัวอย่างเช่น มีการตีความ 123 เป็นตัวเลข หากคุณต้องการให้ตีความเป็นค่าสตริงแทน ให้ตัดค่าในเครื่องหมายอัญประกาศดังนี้: "123"
สําหรับบางสถานการณ์ เช่น สถานการณ์ที่ใช้ชนิดที่ซับซ้อน คุณอาจจําเป็นต้องใช้ สูตร Power Fx ในการตั้งค่าชนิดที่เฉพาะเจาะจง
ใช้ตัวแปรสภาพแวดล้อมสําหรับข้อมูลลับ Azure Key Vault
ตัวแปรสภาพแวดล้อมสามารถอ้างอิงข้อมูลลับใน Key Vault ได้ ตัวแปรสภาพแวดล้อมข้อมูลลับเป็นกรณีพิเศษของตัวแปรสภาพแวดล้อมที่มีข้อควรพิจารณาเฉพาะ
หากต้องการสร้างตัวแปรสภาพแวดล้อมลับใน Power Apps คุณต้องกําหนดค่าชุดเก็บคีย์
หากต้องการอนุญาตให้ Copilot Studio อ่านชุดเก็บคีย์นี้ ให้ดําเนินการต่อไปนี้ให้เสร็จสมบูรณ์:
กําหนดบทบาทผู้ใช้ Key Vault Secrets ให้กับแอปพลิเคชันบริการ Microsoft Copilot Studio
ในการอนุญาตให้ตัวแทนทั้งหมดจากสภาพแวดล้อมเข้าถึงข้อมูลลับ ให้สร้างแท็ก
AllowedEnvironmentsในข้อมูลลับและเพิ่มรหัสสภาพแวดล้อมที่ได้รับอนุญาตซึ่งคั่นด้วยเครื่องหมายจุลภาคในการอนุญาตเฉพาะตัวแทนเฉพาะจากสภาพแวดล้อมเพื่อใช้ชุดเก็บโค้ดนี้ ให้สร้างแท็ก
AllowedAgentsและใส่ตัวระบุตัวแทนในรูปแบบ{envId}/{schemaName}สำหรับค่าหลายค่า ให้คั่นค่าด้วยเครื่องหมายจุลภาคหากคุณมีอักขระถึงจำนวนสูงสุดแต่ยังต้องเพิ่มตัวแทนเพิ่มเติม ให้เพิ่มแท็กอื่นที่มีชื่อที่สื่อความหมายแต่ไม่ซ้ำกัน (ตัวอย่างเช่น:
AllowedAgents2)
รันไทม์กล่องโต้ตอบจะแคชค่าข้อมูลลับเป็นเวลาห้านาที ซึ่งจะแคชการอ่านที่ไม่สําเร็จเป็นเวลา 30 วินาที
คำเตือน
โดยการเพิ่มข้อมูลลับในตัวแทน คุณอาจเปิดเผยค่าของข้อมูลลับนี้ ทุกคนที่สามารถแก้ไขตัวแทนในสภาพแวดล้อมสามารถเพิ่มโหนด ข้อความ และส่งกลับค่าของตัวแปรสภาพแวดล้อมลับในข้อความได้
แผงตัวแปร
ในแผง ตัวแปร คุณสามารถดูตัวแปรทั้งหมดที่พร้อมใช้งานสําหรับหัวข้อโดยไม่คํานึงถึงโหนดที่มีการกําหนดหรือใช้ในโหนดใด
ในการเปิดแผง ตัวแปร ให้เลือก ตัวแปร บนแถบเมนูของหัวข้อ
สําหรับแต่ละตัวแปรหัวข้อ คุณสามารถเลือกว่าจะรับค่าจากหัวข้ออื่น หรือไม่ ส่งกลับค่าไปยังหัวข้ออื่น ๆ หรือทั้งสองอย่าง คุณยังสามารถเลือกตัวแปรเพื่อแก้ไขคุณสมบัติในแผง คุณสมบัติของตัวแปร
แผงคุณสมบัติของตัวแปร
ในแผง คุณสมบัติตัวแปร คุณสามารถเปลี่ยนชื่อตัวแปร ดูตําแหน่งที่ตัวแทนของคุณใช้ หรือแปลงเป็น ตัวแปรส่วนกลางได้ คุณไม่สามารถแปลงตัวแปรส่วนกลางกลับไปยังตัวแปรหัวข้อได้ คุณยังสามารถเลือกได้ว่าจะให้ตัวแปรหัวข้อสามารถรับค่าจากหรือส่งผ่านค่าไปยังหัวข้ออื่นได้หรือไม่
หากต้องการเปิดแผง คุณสมบัติของตัวแปร สำหรับตัวแปร ให้เลือกตัวแปรที่ต้องการในแผง ตัวแปร คุณยังสามารถเปิดแผง คุณสมบัติตัวแปร จากโหนดใดก็ตามที่ใช้ตัวแปรโดยการเลือกตัวแปรที่ต้องการได้
ส่งผ่านตัวแปรระหว่างหัวข้อ
เมื่อคุณเปลี่ยนเส้นทางหัวข้อหนึ่งไปยังอีกหัวข้อหนึ่ง คุณสามารถส่งผ่านค่าของตัวแปรจากหัวข้อต้นทางไปยังหัวข้อปลายทาง และส่งกลับค่าจากหัวข้อปลายทางไปยังหัวข้อต้นทางได้ด้วย การส่งผ่านตัวแปรระหว่างหัวข้อจะมีประโยชน์อย่างยิ่งเมื่อคุณหัวข้อก่อนหน้ามีการรวบรวมข้อมูลที่หัวข้อที่ตามมาต้องการอยู่แล้ว ผู้ใช้ของคุณขอบคุณอย่างแน่นอนที่ไม่ต้องตอบคําถามเดียวกันมากกว่าหนึ่งครั้ง
รับค่าจากหัวข้ออื่นๆ
เมื่อหัวข้อกำหนดตัวแปร (ตัวอย่างเช่น ในโหนด คำถาม) เอเจนต์จะถามคำถามผู้ใช้เพื่อให้เติมค่าของตัวแปร หากเอเจนต์ได้รับค่ามาแล้วในหัวข้อก่อนหน้า ก็ไม่มีเหตุผลที่จะต้องถามคำถามซ้ำ ในกรณีดังกล่าว คุณสามารถตั้งค่าตัวแปรเป็น ได้รับค่าจากหัวข้ออื่นๆ เมื่อหัวข้ออื่นเปลี่ยนเส้นทางมาที่หัวข้อนี้ ก็สามารถส่งผ่านค่าของตัวแปร (หรือ ค่าสัญพจน์) ไปยังตัวแปรนี้ได้และข้ามคำถามไปเลย ประสบการณ์ของผู้ใช้ที่กำลังพูดคุยกับเอเจนต์ก็จะราบรื่น
ตัวอย่างนี้ใช้สองหัวข้อ คําทักทาย และ พูดคุยกับลูกค้า ทั้งสองหัวข้อจะขอชื่อลูกค้า อย่างไรก็ตาม หากหัวข้อ การทักทาย ทำงานก่อน หัวข้อ พูดคุยกับลูกค้า จะมีการข้ามคำถามนั้น แต่จะใช้ค่าของตัวแปรที่ส่งผ่านจากหัวข้อ คำทักทาย แทน
นี่คือขั้นตอนของหัวข้อ พูดคุยกับลูกค้า:
ดังที่แสดงในแผงทดสอบ หากหัวข้อนี้ถูกทริกเกอร์ก่อนจะถามผู้ใช้ว่า "ฉันควรเรียกคุณว่าอย่างไร" ซึ่งจัดเก็บค่าในตัวแปรสตริงที่เรียกว่าcustomerName ตัวแปร customerName ยังได้รับค่าจากหัวข้ออื่น ๆ ด้วย หัวข้อจบลงด้วยข้อความ "ฉันหวังว่าคุณจะมีวันที่สวยงามนะครับ/ค่ะ คุณ customerName"
นี่คือขั้นตอนของหัวข้อ การทักทาย:
ดังที่แสดงในแผงทดสอบ หากหัวข้อนี้ถูกทริกเกอร์ก่อน ระบบจะถามผู้ใช้ว่า "ชื่อของคุณคืออะไร" ซึ่งจัดเก็บค่าในตัวแปรสตริงที่เรียกว่าcustomerName หัวข้อส่งข้อความว่า "ยินดีที่ได้รู้จัก customerName" จากนั้นจะเปลี่ยนเส้นทางไปยังหัวข้อ พูดคุยกับลูกค้า ซึ่งจะส่งข้อความว่า "ฉันหวังว่าคุณจะมีวันที่สวยงามนะครับ/ค่ะ คุณ customerName" อย่างไรก็ตาม โปรดทราบว่าหัวข้อ พูดคุยกับลูกค้า จะข้ามการถามชื่อผู้ใช้อีกครั้ง แต่จะใช้ค่าของ customerName ตัวแปรที่ส่งผ่านจากหัวข้อ คําทักทาย แทน
สุดท้าย นี่คือการสนทนาครั้งที่สองอีกครั้ง คราวนี้มาจากมุมมองของหัวข้อ พูดคุยกับลูกค้า:
ทําตามขั้นตอนการตั้งค่าหัวข้อเพื่อรับค่าจากหัวข้ออื่น ๆ สถานการณ์ตัวอย่างนี้ใช้คํา ทักทาย ของหัวข้อที่กําหนดไว้ล่วงหน้าเป็นหัวข้อต้นทาง และหัวข้อใหม่ พูดคุยกับลูกค้า เป็นหัวข้อปลายทาง แต่ขั้นตอนเดียวกันจะใช้ได้กับหัวข้อใด ๆ ที่ควรใช้ค่าจากหัวข้อก่อนหน้าเมื่อเป็นไปได้
ตั้งค่าหัวข้อปลายทาง
หัวข้อปลายทางได้รับค่าจากหัวข้ออื่น ๆ ในตัวอย่างนี้ นี่คือการพูดคุยกับลูกค้า
สร้างหัวข้อใหม่ และตั้งชื่อว่า "พูดคุยกับลูกค้า"
เพิ่มวลีทริกเกอร์ เช่น "พูดคุยกับฉัน" "พูดกับฉัน" และ "สนทนากับฉัน"
เพิ่มโหนด คำถาม และป้อน "ฉันควรเรียกคุณว่าอะไร" สำหรับข้อความ
ภายใต้ ระบุ เลือกเอนทิตีที่สร้างไว้ล่วงหน้า ชื่อบุคคล
เลือกชื่อของตัวแปร แผง คุณสมบัติของตัวแปร จะเปิดขึ้น
แทนที่ชื่อเริ่มต้นด้วย
customerNameจากนั้นเลือกรับค่าจากหัวข้ออื่น ๆ
เพิ่มโหนด ข้อความ
ในกล่องข้อความ ให้ป้อน "ฉันหวังว่าคุณจะมีวันที่สวยงาม"
เลือกไอคอน แทรกตัวแปร ({x}) แล้วเลือก customerName
เลือกช่องว่างหลังตัวแปรและใส่เครื่องหมายอัศเจรีย์ (!)
บันทึกหัวข้อ
ตั้งค่าหัวข้อต้นทาง
หัวข้อต้นทางคือหัวข้อที่เปลี่ยนเส้นทางไปยังหัวข้ออื่น ซึ่งจะให้ค่าและส่งผ่านไปยังหัวข้อปลายทาง ในตัวอย่างนี้ นี่เป็นคําทักทาย
ไปที่หัวข้อ การทักทาย และลบโหนดเริ่มต้น ยกเว้นโหนด ทริกเกอร์
เพิ่มโหนด คำถาม และป้อน "คุณชื่ออะไร" สำหรับข้อความ
ภายใต้ ระบุ เลือกเอนทิตีที่สร้างไว้ล่วงหน้า ชื่อบุคคล
แทนที่ชื่อเริ่มต้นด้วย
customerNameFromGreetingเพิ่มโหนด ข้อความ
ในกล่องข้อความ ป้อน "ยินดีที่ได้รู้จัก"
เลือกไอคอน แทรกตัวแปร ({x}) แล้วเลือก customerNameFromGreeting
เลือกช่องว่างหลังตัวแปรและใส่เครื่องหมายอัศเจรีย์ (!)
เพิ่มโหนด เปลี่ยนเส้นทาง และเลือกหัวข้อปลายทาง พูดคุยกับลูกค้า
เลือก เพิ่มอินพุต แล้วเลือกตัวแปรจากหัวข้อปลายทางซึ่งคุณต้องการส่งผ่านค่าไป
เลือกไอคอน > จากนั้นเลือกตัวแปรที่คุณต้องการส่งค่า customerNameFromGreeting ในตัวอย่างนี้
โหนด เปลี่ยนเส้นทาง ควรมีลักษณะดังนี้:
บันทึกหัวข้อ
ส่งคืนค่ากลับไปยังหัวข้อเดิม
ในเอเจนต์ หัวข้อจะรวบรวมข้อมูลที่เฉพาะเจาะจง หัวข้ออื่น ๆ อีกมากมายสามารถเรียกใช้และคาดหวังว่าจะส่งกลับข้อมูลเป็นตัวแปร ตัวแปรจะกลายเป็นส่วนหนึ่งของหัวข้อต้นทางและสามารถใช้ได้เช่นเดียวกับตัวแปรอื่น ๆ โดยการทําให้ข้อมูลที่ตัวแทนได้รับพร้อมใช้งานในหัวข้อนี้วิธีการนี้จะช่วยลดความจําเป็นสําหรับตัวแปรโกลบอล
มาต่อกันด้วยตัวอย่างจากส่วนก่อนหน้า คุณถามคําถามใหม่ในหัวข้อ พูดคุยกับลูกค้า จากนั้นส่งกลับคําตอบไปยังหัวข้อ คําทักทาย
ตั้งค่าหัวข้อต้นทางสำหรับตัวแปรที่ส่งคืน
เมื่อคุณส่งกลับตัวแปรไปยังหัวข้อ หัวข้อต้นทางคือหัวข้อที่มีค่าที่จะส่งผ่านกลับไปยังหัวข้อเดิม ในตัวอย่างนี้ หัวข้อต้นทางคือ พูดคุยกับลูกค้า
ไปที่หัวข้อต้นทาง
เพิ่มโหนด คำถาม และป้อน "คุณอาศัยอยู่ในเมืองใด" สำหรับข้อความ
ภายใต้ ระบุ เลือกเอนทิตีที่สร้างไว้ล่วงหน้า เมือง
เลือกตัวแปรเพื่อเปิดแผง คุณสมบัติของตัวแปร ตั้งชื่อว่า
customerCityจากนั้นเลือก ส่งกลับค่า ไปยังหัวข้อเดิม
เพิ่มโหนด ข้อความ
เลือกไอคอน แทรกตัวแปร ({x}) แล้วเลือก customerCity
หลังตัวแปรในกล่องข้อความ ให้ป้อน "ในเวลานี้ของปีคงจะสวยงามมาก"
บันทึกหัวข้อ
ตั้งค่าหัวข้อปลายทางสำหรับตัวแปรที่ส่งคืน
เมื่อคุณส่งกลับตัวแปรไปยังหัวข้อ หัวข้อปลายทางจะได้รับค่าจากหัวข้อปัจจุบัน ในตัวอย่างต่อไปนี้ หัวข้อปลายทางคือ คําทักทาย
ไปที่หัวข้อปลายทาง
ตัวแปรที่คุณเลือกในหัวข้อต้นทางจะปรากฏบนโหนด การเปลี่ยนเส้นทาง เป็นตัวแปรเอาต์พุต
บันทึกหัวข้อ
แยกวิเคราะห์ค่า
โหนด ค่าการแยกวิเคราะห์ แปลงค่าจากชนิดหนึ่งเป็นอีกชนิดหนึ่ง กรณีการใช้งานทั่วไปสําหรับโหนด แยกวิเคราะห์ค่า จะแปลง JSON แบบ Raw ตัวอย่างเช่น ตัวแทนเรียกใช้โฟลว์ที่เรียกใช้ API API ส่งกลับผลลัพธ์ คุณจําเป็นต้องมีวิธีในการแยกวิเคราะห์ผลลัพธ์นี้และส่งกลับตัวแปรดั้งเดิมอย่างน้อยหนึ่งตัวแปร โดยการใช้โหนด ค่าการแยกวิเคราะห์ คุณสามารถส่งผลลัพธ์ API ทั้งหมดเป็นสตริงเช่นต่อไปนี้:
{
"Name": "Parker",
"Position": "Product manager",
"Company": "Contoso",
"FormerPositions": [{
"Position": "Customer service representative"
}
]
}
โหนดค่าการแยกวิเคราะห์แปลงตัวแปรสตริงเป็นตัวแปรชนิดระเบียน ตัวแก้ไข Power Fx ให้การเติมรหัส IntelliSense และคําแนะนําสําหรับประเภทนี้
นอกเหนือจากการแยกวิเคราะห์สตริง JSON แล้ว การใช้คีย์สําหรับโหนด ค่าการแยกวิเคราะห์ คือการแยกวิเคราะห์วัตถุที่ไม่พิมพ์ในขณะทํางาน กรณีการใช้งานที่พบบ่อยที่สุดคือ เมื่อคุณได้รับเหตุการณ์และต้องการแยกวิเคราะห์ค่าเหตุการณ์ หรือคุณอาจต้องการแยกวิเคราะห์คุณสมบัติ System.Activity.ChannelData ซึ่งแตกต่างกันในรันไทม์ตามช่องทาง
หากคุณต้องการแยกวิเคราะห์ข้อมูลจากเหตุการณ์ที่มาจาก Teams โปรดดูเอกสารสําหรับนักพัฒนา Teams เพื่อค้นหาตัวอย่างว่าเหตุการณ์ที่คาดไว้มีลักษณะเป็นอย่างไร จากนั้นคุณสามารถทําตามคําแนะนําในส่วนนี้ โดยใช้เหตุการณ์ตัวอย่างเป็นข้อมูลตัวอย่างได้
วิธีเพิ่มโหนด ค่า Parse ไปยังหัวข้อ:
เลือกไอคอน เพิ่มโหนด
ภายใต้โหนดที่คุณต้องการแยกวิเคราะห์ค่า ชี้ไปที่ การจัดการตัวแปร และเลือก ค่าการแยกวิเคราะห์เพิ่มโหนด แยกวิเคราะห์ค่า และเลือกตัวแปรที่คุณต้องการแยกวิเคราะห์
สําหรับชนิดข้อมูล ให้เลือก จากข้อมูลตัวอย่าง
เลือกรับ Schema จากตัวอย่าง JSON ใส่ตัวอย่าง JSON ที่ต้องการในตัวแก้ไขที่เปิดขึ้น และเลือกยืนยัน
เลือกตัวแปรเพื่อเก็บค่าที่แยกวิเคราะห์ โดยทั่วไปแล้ว คุณสร้างตัวแปรใหม่
ตอนนี้ตัวแปรเอาต์พุตมีชนิดที่คาดไว้: เรกคอร์ด
