แชร์ผ่าน


ทำงานกับตัวแปร

คุณสามารถใช้ตัวแปรเพื่อบันทึกคำตอบของลูกค้าและนำเนื้อหามาใช้ใหม่ในภายหลังในการสนทนา

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

ตัวแปรยังสามารถส่งผ่านเข้าและส่งคืนจาก หัวข้ออื่นๆ และ โฟลว์ Power Automate

สร้างตัวแปร

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

ภาพหน้าจอของโหนดคำถามที่เน้นชื่อและชนิดของตัวแปรเริ่มต้น

เคล็ดลับ

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

ไม่สามารถเปลี่ยนชื่อโหนด ทริกเกอร์ และโหนด ไปที่ขั้นตอน ได้

ชื่อโหนดสามารถมีความยาวได้สูงสุด 500 อักขระ

เลือกเอนทิตีที่จะใช้

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

ภาพหน้าจอของโหนดคำถามที่เปิดแผง 'เลือกข้อมูลที่จะระบุ'

เปลี่ยนชื่อตัวแปร

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

  1. เลือกตัวแปรเพื่อเปิดในบานหน้าต่าง คุณสมบัติตัวแปร

  2. ภายใต้ ชื่อตัวแปร ให้ป้อนชื่อใหม่สำหรับตัวแปรของคุณ

ตั้งค่าตัวแปร

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

  1. เลือก เพิ่มโหนด (+) เพื่อเพิ่มโหนด จากนั้นเลือก การจัดการตัวแปร>ตั้งค่าตัวแปร

  2. เลือกกล่องภายใต้ ตั้งค่าตัวแปร แล้วเลือก สร้างตัวแปรใหม่

    ภาพหน้าจอของปุ่ม สร้างตัวแปรใหม่

    ระบบสร้างตัวแปรใหม่ ชนิดของตัวแปรจะเป็น ไม่รู้จัก จนกว่าคุณจะกำหนดค่า

    ภาพหน้าจอของโหนดตั้งค่าค่าตัวแปรด้วยตัวแปรใหม่ที่เป็นชนิดไม่รู้จัก

  3. สำหรับ เป็นค่า ให้กำหนดค่าโดยใช้หนึ่งในตัวเลือกต่อไปนี้:

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

หมายเหตุ

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

ใช้ตัวแปรในโหนดการดำเนินการ

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

ภาพหน้าจอของโหนดการดำเนินการที่มีพารามิเตอร์อินพุตและเอาต์พุตสำหรับการดำเนินการของทักษะ

ใช้ค่าสัญพจน์สำหรับอินพุตตัวแปร

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

ภาพหน้าจอแสดงการใช้ค่าตามตัวอักษรสำหรับพารามิเตอร์อินพุตตัวแปรที่ชื่อ productName

โหนดพยายามตีความค่าตัวอักษรเป็นสตริง ตัวเลข หรือบูลีน ตัวอย่างเช่น มีการตีความ 123 เป็นตัวเลข หากคุณต้องการให้ตีความเป็นค่าสตริงแทน คุณสามารถใส่ค่านี้ในเครื่องหมายคำพูดคู่ ดังนี้: "123"

สำหรับบางสถานการณ์ (ตัวอย่างเช่น สถานการณ์ที่ใช้ชนิดที่ซับซ้อน) คุณอาจต้องใช้ สูตร Power Fx เพื่อตั้งค่าชนิดเฉพาะ

ใช้ตัวแปรสภาพแวดล้อมสำหรับ Azure Key Vault secrets

ตัวแปรสภาพแวดล้อมสามารถอ้างอิงข้อมูลลับใน Key Vault ได้ ตัวแปรสภาพแวดล้อมข้อมูลลับเป็นกรณีพิเศษของตัวแปรสภาพแวดล้อมที่มีข้อควรพิจารณาเฉพาะ

เพื่อสร้างตัวแปรสภาพแวดล้อมข้อมูลลับในพอร์ทัล Power Apps คุณต้อง กำหนดค่า Key Vault

หากต้องการอนุญาตให้ Copilot Studio อ่าน Key Vault นี้ คุณต้องดำเนินการดังต่อไปนี้:

  1. กำหนดบทบาท Key Vault Secrets User ให้กับแอปพลิเคชัน Microsoft Virtual Agents Service

  2. หากต้องการอนุญาตให้เอเจนต์ทั้งหมดจากสภาพแวดล้อมเข้าถึงข้อมูลลับ ให้สร้างแท็ก AllowedEnvironments สำหรับข้อมูลลับและเพิ่มรหัสสภาพแวดล้อมที่อนุญาตโดยคั่นด้วยเครื่องหมายจุลภาค

  3. หากต้องการอนุญาตเฉพาะเอเจนต์จากสภาพแวดล้อมเพื่อใช้ Key Vault นี้ ให้สร้างแท็ก AllowedAgents และใส่ตัวระบุเอเจนต์ในรูปแบบ {envId}/{schemaName} สำหรับค่าหลายค่า ให้คั่นค่าด้วยเครื่องหมายจุลภาค

หากคุณมีอักขระถึงจำนวนสูงสุดแต่ยังต้องเพิ่มตัวแทนเพิ่มเติม ให้เพิ่มแท็กอื่นที่มีชื่อที่สื่อความหมายแต่ไม่ซ้ำกัน (ตัวอย่างเช่น: AllowedAgents2)

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

คำเตือน

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

บานหน้าต่างตัวแปร

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

หากต้องการเปิดบานหน้าต่าง ตัวแปร ในแถบเมนูของหัวข้อ ให้เลือก ตัวแปร

ภาพหน้าจอของบานหน้าต่างตัวแปรในพื้นที่ทำงานการเขียน Copilot Studio ที่มีการเน้นปุ่มตัวแปร

บานหน้าต่างคุณสมบัติของตัวแปร

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

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

ส่งผ่านตัวแปรระหว่างหัวข้อ

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

รับค่าจากหัวข้ออื่นๆ

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

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

นี่คือขั้นตอนของหัวข้อ พูดคุยกับลูกค้า:

ภาพหน้าจอของโฟลว์การสนทนาหัวข้อพูดคุยกับลูกค้า

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

นี่คือขั้นตอนของหัวข้อ การทักทาย:

ภาพหน้าจอของโฟลว์การสนทนาหัวข้อการทักทาย

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

สุดท้าย นี่คือการสนทนาครั้งที่สองอีกครั้ง คราวนี้มาจากมุมมองของหัวข้อ พูดคุยกับลูกค้า:

ภาพหน้าจอของโฟลว์การสนทนาหัวข้อพูดคุยกับลูกค้าเมื่อมีการทริกเกอร์หัวข้อการทักทายก่อน

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

ตั้งค่าหัวข้อปลายทาง

หัวข้อปลายทางคือหัวข้อที่ถูกเปลี่ยนเส้นทาง ซึ่งเป็นปลายทางที่จะรับค่าจากหัวข้ออื่น ในตัวอย่างของเรา คือ พูดคุยกับลูกค้า

  1. สร้างหัวข้อใหม่และเรียกว่า "พูดคุยกับลูกค้า"

  2. เพิ่มวลีทริกเกอร์ เช่น "คุยกับฉัน" "พูดกับฉัน" "แชทกับฉัน"

  3. เพิ่มโหนด คำถาม และป้อน "ฉันควรเรียกคุณว่าอะไร" สำหรับข้อความ

  4. ภายใต้ ระบุ เลือกเอนทิตีที่สร้างไว้ล่วงหน้า ชื่อบุคคล

  5. เลือกชื่อของตัวแปร แผง คุณสมบัติของตัวแปร จะเปิดขึ้น

  6. แทนที่ชื่อเริ่มต้นด้วย "customerName" จากนั้นเลือก รับค่าจากหัวข้ออื่นๆ

    ภาพหน้าจอของแผง 'คุณสมบัติของตัวแปร' ที่แสดงตัวแปร customerName และคุณสมบัติ

  7. เพิ่มโหนด ข้อความ

  8. ในกล่องข้อความ ให้ป้อน "ฉันหวังว่าคุณจะมีวันที่สวยงาม"

  9. เลือกไอคอน แทรกตัวแปร ({x}) จากนั้นเลือก customerName

  10. เลือกช่องว่างหลังตัวแปรและป้อน "!"

  11. บันทึกหัวข้อ

ตั้งค่าหัวข้อต้นทาง

หัวข้อต้นทางคือหัวข้อที่ทำการเปลี่ยนเส้นทาง ซึ่งเป็นหัวข้อที่ให้ค่าและส่งผ่านไปยังหัวข้อปลายทาง ในตัวอย่างของเราคือ การทักทาย

  1. ไปที่หัวข้อ การทักทาย และลบโหนดเริ่มต้น ยกเว้นโหนด ทริกเกอร์

  2. เพิ่มโหนด คำถาม และป้อน "คุณชื่ออะไร" สำหรับข้อความ

  3. ภายใต้ ระบุ เลือกเอนทิตีที่สร้างไว้ล่วงหน้า ชื่อบุคคล

  4. เปลี่ยนชื่อเริ่มต้นด้วย "customerNameFromGreeting"

  5. เพิ่มโหนด ข้อความ

  6. ในกล่องข้อความ ป้อน "ยินดีที่ได้รู้จัก"

  7. เลือกไอคอน แทรกตัวแปร ({x}) จากนั้นเลือก customerNameFromGreeting

  8. เลือกช่องว่างหลังตัวแปรและป้อน "!"

  9. เพิ่มโหนด เปลี่ยนเส้นทาง และเลือกหัวข้อปลายทาง พูดคุยกับลูกค้า

  10. เลือก เพิ่มอินพุต แล้วเลือกตัวแปรจากหัวข้อปลายทางซึ่งคุณต้องการส่งผ่านค่าไป

    ภาพหน้าจอของหัวข้อคำทักทายที่มีการเพิ่มตัวแปร customerName เป็นอินพุตในโหนดเปลี่ยนเส้นทาง

  11. เลือกไอคอน > จากนั้นเลือกตัวแปรที่คุณต้องการส่งค่า customerNameFromGreeting ในตัวอย่างนี้

    โหนด เปลี่ยนเส้นทาง ควรมีลักษณะดังนี้:

    ภาพหน้าจอของโหนดเปลี่ยนเส้นทางที่เสร็จสมบูรณ์ในหัวข้อคำทักทาย

  12. บันทึกหัวข้อ

ส่งคืนค่ากลับไปยังหัวข้อเดิม

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

มาต่อกันด้วยตัวอย่างจากส่วนก่อนหน้า เราถามคำถามใหม่ในหัวข้อ พูดคุยกับลูกค้า แล้วส่งคำตอบกลับไปยังหัวข้อ การทักทาย

ตั้งค่าหัวข้อต้นทางสำหรับตัวแปรที่ส่งคืน

เมื่อคุณส่งคืนตัวแปรไปยังหัวข้อ หัวข้อต้นทางคือหัวข้อที่ให้ค่าเพื่อส่งกลับไปยังหัวข้อเดิม ในตัวอย่างนี้ หัวข้อต้นทางคือ พูดคุยกับลูกค้า

  1. ไปที่หัวข้อต้นทาง

  2. เพิ่มโหนด คำถาม และป้อน "คุณอาศัยอยู่ในเมืองใด" สำหรับข้อความ

  3. ภายใต้ ระบุ เลือกเอนทิตีที่สร้างไว้ล่วงหน้า เมือง

  4. เลือกตัวแปรเพื่อเปิดในบานหน้าต่าง คุณสมบัติตัวแปร ตั้งชื่อว่า "customerCity" จากนั้นเลือก ส่งคืนค่าไปยังหัวข้อต้นฉบับ

    ภาพหน้าจอของหัวข้อ พูดคุยกับลูกค้า ที่มีตัวแปร customerCity และคุณสมบัติถูกเน้น

  5. เพิ่มโหนด ข้อความ

  6. เลือกไอคอน แทรกตัวแปร ({x}) จากนั้นเลือก customerCity

  7. หลังตัวแปรในกล่องข้อความ ให้ป้อน "ในเวลานี้ของปีคงจะสวยงามมาก"

  8. บันทึกหัวข้อ

ตั้งค่าหัวข้อปลายทางสำหรับตัวแปรที่ส่งคืน

เมื่อคุณส่งคืนตัวแปรไปยังหัวข้อ หัวข้อปลายทางคือหัวข้อที่ได้รับค่าจากหัวข้อปัจจุบัน ในตัวอย่างของเรา หัวข้อปลายทางคือ การทักทาย

  1. ไปที่หัวข้อปลายทาง

  2. ตัวแปรที่คุณเลือกในหัวข้อต้นทางควรปรากฏในโหนด เปลี่ยนเส้นทาง เป็นตัวแปรเอาต์พุต

    ภาพหน้าจอของโฟลว์การสนทนาหัวข้อการทักทายที่มีตัวแปรที่ส่งคืนในโหนดเปลี่ยนเส้นทาง

  3. บันทึกหัวข้อ

โหนดแยกวิเคราะห์ค่า

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

ภาพหน้าจอของเมนูที่จะเพิ่มโหนด โดยเลือก การจัดการตัวแปร จากนั้นเลือก แยกวิเคราะห์ค่า

สถานการณ์สำคัญที่ใช้โหนด แยกวิเคราะห์ค่า มุ่งเน้นไปที่การแปลง JSON แบบดิบหรือตัวแปรที่ไม่ได้กำหนดชนิด (ซึ่งไม่ทราบค่าหรือโครงสร้างจนกว่าจะรันไทม์ เช่น ChannelData) เป็นชนิดที่เป็นรูปธรรม

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

{
    "Name": "Parker",
    "Position": "Product manager",
    "Company": "Contoso",
    "FormerPositions": [{
            "Position": "Customer service representative"
        }
    ]
}

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

ตัวอย่างการใช้โหนดแยกวิเคราะห์ค่า

  1. เพิ่มโหนด แยกวิเคราะห์ค่า และเลือกตัวแปรที่คุณต้องการแยกวิเคราะห์

    ภาพหน้าจอแสดงตัวเลือกของตัวแปรที่จะแยกวิเคราะห์

  2. เลือกชนิดข้อมูล ในกรณีนี้ ให้เลือก จากข้อมูลตัวอย่าง

    ภาพหน้าจอแสดงตัวเลือกชนิดข้อมูลสำหรับโหนดแยกวิเคราะห์ค่า

  3. เลือก รับ Schema จาก JSON ตัวอย่าง และป้อนตัวอย่าง JSON ที่ต้องการในตัวแก้ไขที่เปิดขึ้น

    ภาพหน้าจอแสดงรับ Schema จาก JSON ตัวอย่าง

  4. สุดท้าย ระบุตัวแปรที่คุณต้องการวางค่าที่แยกวิเคราะห์ โดยปกติแล้ว คุณจะสร้างตัวแปรใหม่สำหรับรายการนี้

    ภาพหน้าจอแสดงตัวเลือกตัวแปรเป้าหมายสำหรับค่าที่แยกวิเคราะห์

    โปรดทราบว่าตัวแปรเอาต์พุตเป็นชนิดที่ถูกต้อง: เรกคอร์ด

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

เช่นเดียวกับการแยกวิเคราะห์สตริง JSON การใช้งานที่สำคัญของโหนด แยกวิเคราะห์ค่า คือการแยกวิเคราะห์ UntypedObjects ขณะรันไทม์ กรณีการใช้งานที่พบบ่อยที่สุดคือเมื่อคุณได้รับเหตุการณ์และคุณจำเป็นต้องประมวลผลค่าเหตุการณ์ หรือคุณอาจต้องการแยกวิเคราะห์คุณสมบัติ System.Activity.ChannelData ซึ่งแตกต่างกันไปขณะรันไทม์ตามช่องทาง

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