ถามด้วยการ์ดที่ปรับเปลี่ยนได้

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

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

Copilot Studio ประกอบด้วยตัวออกแบบการ์ดที่ปรับเปลี่ยนได้ในตัว ซึ่งมีคุณลักษณะที่มีประโยชน์ที่สุดจาก ตัวออกแบบการ์ดที่ปรับเปลี่ยนได้

หรือคุณสามารถ:

• ใช้การแสดง JSON สำหรับการ์ดที่คุณต้องการแสดงต่อผู้ใช้
• ใช้ สูตร Power Fx เพื่อรวมข้อมูลแบบไดนามิกไว้บนการ์ด

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

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

โหนดเพิ่มการ์ดที่ปรับเปลี่ยนได้

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

2. เลือกจุดสามจุด (...) ของโหนด แล้วเลือก คุณสมบัติ

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

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

   เคล็ดลับ

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

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

   

   เคล็ดลับ

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

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

คุณสมบัติอื่นๆ

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

• วิธีที่เอเจนต์ตอบสนองต่อการตอบกลับที่ไม่ถูกต้อง
• หากสามารถขัดจังหวะได้

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

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

• ลองพร้อมท์ใหม่อีกครั้ง: ใช้คุณสมบัตินี้เพื่อกำหนดข้อความที่จะส่งเมื่อมีการลองใหม่พร้อมกับทำซ้ำการ์ด หากต้องการลงส่งข้อความใหม่อีกครั้ง ให้เลือก ปรับแต่งแล้วป้อนข้อความพร้อมท์ใหม่

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

ลักษณะการทํางานของปุ่มส่งสําหรับเอเจนต์ที่มีการ์ดติดต่อกัน

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

เพื่อป้องกันไม่ให้การดำเนินการส่งบนการ์ดหนึ่งรบกวนการ์ดอื่น:

• แยกการดำเนินการส่ง: ตรวจสอบว่าการ์ดที่ปรับเปลี่ยนได้แต่ละใบมีตัวระบุที่ไม่ซ้ำกันและตัวจัดการการดำเนินการของตนเอง

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

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

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

ใช้ Power Fx เพื่อทำให้การ์ดของคุณปรับเปลี่ยนตาม

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

1. เลือกจุดสามจุด (...) ของโหนด แล้วเลือก คุณสมบัติ

2. ในแผง คุณสมบัติโหนดของการ์ดที่ปรับเปลี่ยนได้ ให้สลับไปที่ สูตร การเลือก สูตร จะแปลงการแสดง JSON ของการ์ดเป็นสูตร Power Fx ของคุณโดยอัตโนมัติ

   

   ตัวอย่างเช่น เริ่มต้นด้วยตัวอักษร JSON ต่อไปนี้สำหรับการ์ด:

   {
     "$schema": "http://adaptivecards.io/schemas/adaptive-card.json",
     "type": "AdaptiveCard",
     "version": "1.5",
     "body": [{
         "type": "ColumnSet",
         "columns": [{
             "type": "Column",
             "width": 2,
             "items": [{
                 "type": "TextBlock",
                 "text": "Tell us about yourself",
                 "weight": "Bolder",
                 "size": "Medium",
                 "wrap": true,
                 "style": "heading"
               }, {
                 "type": "TextBlock",
                 "text": "We just need a few more details to get you booked for the trip of a lifetime!",
                 "isSubtle": true,
                 "wrap": true
               }, {
                 "type": "Input.Text",
                 "id": "myName",
                 "label": "Your name (Last, First)",
                 "isRequired": true,
                 "regex": "^[A-Z][a-z]+, [A-Z][a-z]+$",
                 "errorMessage": "Please enter your name in the specified format"
               }
             ]
           }
         ]
       }
     ],
     "actions": [{
         "type": "Action.Submit",
         "title": "Submit"
       }
     ]
   }
   

   นี่คือสูตรผลลัพธ์ของ Power Fx ที่ใช้ตัวแปรสองรายการ Topic.Title และ Topic.Subtitle แทนข้อความที่ฮาร์ดโค้ดจากสัญพจน์ JSON (ตัวอย่างนี้ถือว่าตัวแปรมีการกำหนดไว้ในหัวข้อของคุณ)

   {
     '$schema': "http://adaptivecards.io/schemas/adaptive-card.json",
     type: "AdaptiveCard",
     version: "1.5",
     body: [
       {
         type: "ColumnSet",
         columns: [
           {
             type: "Column",
             width: "2",
             items: [
               {
                 type: "TextBlock",
                 text: Topic.Title,
                 weight: "Bolder",
                 size: "Medium",
                 wrap: true,
                 style: "heading"
               },
               {
                 type: "TextBlock",
                 text: Topic.Subtitle,
                 isSubtle: true,
                 wrap: true
               },
               {
                 type: "Input.Text",
                 id: "myName",
                 label: "Your name (Last, First)",
                 isRequired: true,
                 regex: "^[A-Z][a-z]+, [A-Z][a-z]+$",
                 errorMessage: "Please enter your name in the specified format"
               }
             ]
           }
         ]
       }
     ],
     actions: [
       {
         type: "Action.Submit",
         title: "Submit"
       }
     ]
   }