แชร์ผ่าน

ใช้ตัวแปรซ้ำในหัวข้อต่างๆ

  • บทความ

สำคัญ

ความสามารถและคุณลักษณะต่างๆ ของ Power Virtual Agents เป็น ส่วนหนึ่งของ Microsoft Copilot Studio แล้ว ภายหลังการลงทุนที่สำคัญใน Generative AI และการรวมที่ได้รับการปรับปรุงใน Microsoft Copilot

บทความและภาพหน้าจอบางรายการอาจอ้างถึง Power Virtual Agents ในขณะที่เราอัปเดตคู่มือและเนื้อหาการฝึกอบรม

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

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

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

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

สร้างตัวแปรส่วนกลาง

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

  1. สร้างตัวแปร หรือ ใช้บานหน้าต่าง ตัวแปร เพื่อเปิดตัวแปรที่มีอยู่

  2. บนบานหน้าต่าง คุณสมบัติตัวแปร ให้เลือก ส่วนกลาง (หัวข้อใดๆ สามารถเข้าถึงได้)

    ชื่อตัวแปรจะมีคำนำหน้า Global. เพื่อแยกความแตกต่างจากตัวแปรระดับหัวข้อ ตัวอย่างเช่น ตัวแปร UserName แสดงเป็น Global.UserName

    ภาพหน้าจอแสดงบานหน้าต่างคุณสมบัติตัวแปร โดยไฮไลต์การตั้งค่าส่วนกลาง

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

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

ใช้ตัวแปรส่วนกลาง

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

ภาพหน้าจอแสดงตัวเลือกของตัวแปรส่วนกลาง

ค้นหาหัวข้อทั้งหมดโดยใช้ตัวแปรส่วนกลาง

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

  1. เลือกตัวแปรส่วนกลางในพื้นที่ทำงานการเขียนหรือเปิด บานหน้าต่าง ตัวแปร และเลือกตัวแปรส่วนกลาง

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

    ภาพหน้าจอแสดงรายการหัวข้อที่ตัวแปรใช้ในบานหน้าต่างคุณสมบัติตัวแปร

วงจรชีวิตของตัวแปรส่วนกลาง

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

ตั้งค่าตัวแปรส่วนกลางจากแหล่งภายนอก

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

  1. เลือกตัวแปรส่วนกลาง

  2. ในบานหน้าต่าง คุณสมบัติตัวแปร ให้เลือก แหล่งภายนอกสามารถตั้งค่าได้

ตั้งค่าตัวแปรส่วนกลางใน Copilot แบบฝัง

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

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

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

ผนวกตัวแปรและคำจำกัดความเข้ากับ URL ของ Copilot เป็น พารามิเตอร์สตริงการสอบถาม ในรูปแบบ botURL?variableName1=variableDefinition1&variableName2=variableDefinition2

ตัวอย่าง

ชื่อพารามิเตอร์ต้องตรงตามตัวพิมพ์ใหญ่-เล็ก username=Renata จะทำงานในตัวอย่างนี้ด้วย

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

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

  1. ในส่วน <script> ในหน้าที่คุณมี Copilot ของคุณ กำหนดตัวแปรดังต่อไปนี้แทนที่ variableName1 สำหรับชื่อตัวแปรที่ไม่มีคำนำหน้า Global. และ variableDefinition1 สำหรับคำจำกัดความ แยกตัวแปรหลายตัวด้วยเครื่องหมายจุลภาค (,)

       const store = WebChat.createStore({}, ({ dispatch }) => next => action => {
     if (action.type === 'DIRECT_LINE/CONNECT_FULFILLED') {
       dispatch({
          type: "WEB_CHAT/SEND_EVENT",
          payload: {
            name: "pvaSetContext",
            value: {
               "variableName1": "variableDefinition1",
               "variableName2": "variableDefinition2"
            }
          },
        });
      }
        return next(action);
    });

  2. ในส่วน <script> เรียก store เมื่อคุณฝัง Copilot ของคุณ ดังตัวอย่างต่อไปนี้โดยที่ store เรียกใช้อยู่เหนือที่ styleOptions เรียกใช้ (คุณจะต้องแทนที่ BOT_ID ด้วยรหัส Copilot ของคุณ):

    const BOT_ID = "12345-5678";
const theURL = "https://powerva.microsoft.com/api/botmanagement/v1/directline/directlinetoken?botId=" + BOT_ID;

fetch(theURL)
    .then(response => response.json())
    .then(conversationInfo => {
        window.WebChat.renderWebChat(
            {
                directLine: window.WebChat.createDirectLine({
                    token: conversationInfo.token,
                }),
                store,
                styleOptions
            },
            document.getElementById('webchat')
        );
    })
    .catch(err => console.error("An error occurred: " + err));