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

สำคัญ

หัวข้อนี้มีคู่มือ Power Virtual Agents Preview และอาจจะมีการเปลี่ยนแปลงในอนาคต

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

หากคุณกำลังสร้างบอทที่พร้อมสำหรับการใช้งานจริง โปรดดูที่ ภาพรวมของ Power Virtual Agents

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

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

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

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

ข้อกำหนดเบื้องต้น

• สร้างและแก้ไขหัวข้อ

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

1. เลือก เพิ่มโหนด (+) แล้วเลือก ถามด้วยการ์ดที่ปรับเปลี่ยนได้

2. เลือกไอคอนการ์ด ซึ่งขยายบานหน้าต่างคุณสมบัติสำหรับโหนด หรือเลือก เมนูโหนด (⋮) แล้วเลือก คุณสมบัติ

   

3. ในส่วน แก้ไข JSON ให้ป้อน JSON สำหรับการ์ดของคุณ

   ในการเปิดมุมมองที่ใหญ่ขึ้นของตัวแก้ไข JSON ให้เลือกไอคอน ขยาย

   

เคล็ดลับ

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

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

   

   เคล็ดลับ

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

   

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

คุณสมบัติเพิ่มเติม

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

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

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

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

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

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

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

1. เลือกไอคอนการ์ด ซึ่งขยายบานหน้าต่างคุณสมบัติสำหรับโหนด หรือเลือก เมนูโหนด (⋮) แล้วเลือก คุณสมบัติ

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

ตัวอย่าง JSON

ด้านล่างนี้คือตัวอย่าง JSON ของการ์ดและ Power Fx ที่เป็นผลลัพธ์โดยที่ตัวแปรสองตัว Topic.Title และ Topic.Subtitle ใช้แทนข้อความฮาร์ดโค้ด

  {
    "$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

  {
  '$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"
    }
  ]
}