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

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

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

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

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

1. เลือกตัวแปรที่ต้องการ

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

3. ชื่อตัวแปรจะได้รับการกำหนดคำนำหน้า bot. เพื่อแยกความแตกต่างจากตัวแปรระดับหัวข้อ ตัวอย่างเช่น ตอนนี้ตัวแปรUserEmail จะปรากฏเป็น bot.UserEmail

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

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

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

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

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

3. สลับไปที่แท็บ อื่นๆ และเลือกหัวข้อใดๆ ที่ใช้ตัวแปรเพื่อไปยังหัวข้อและโหนดนั้นโดยตรง

เลือกตัวแปรที่ต้องการในพื้นที่ทำงานการสร้าง แผง คุณสมบัติตัวแปร จะปรากฏขึ้น

• หากต้องการไปยังโหนดที่สร้างตัวแปรส่วนกลางโดยตรง ให้เลือก ไปยังแหล่งที่มา

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

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

ตัวแปรส่วนกลางสามารถเข้าถึงได้จากหัวข้อใดๆ และค่าของตัวแปรส่วนกลางยังคงอยู่ตลอด เซสชัน

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

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

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

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

เมื่อการสนทนามาถึงประเด็นในหัวข้อ "การจองการนัดหมาย" ที่มีการอ้างอิง bot.UserName เอเจนต์จะถูกไพวอทไปยังโหนดคำถามอย่างราบรื่นโดยกำหนด bot.UserName ไว้ก่อน

หลังจากลูกค้าตอบคำถาม เอเจนต์จะกลับมาดำเนินการหัวข้อ "การจองการนัดหมาย"

ลักษณะการทำงานตัวแปรส่วนกลางเมื่อใช้การดำเนินการผ่านโฟลว์และทักษะ Power Automate

บางครั้ง คุณอาจใช้ขั้โฟลว์หรือทักษะในการเริ่มต้นหรือเติมตัวแปร

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

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

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

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

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

2. เพิ่มโหนดตั้งค่าตัวแปรให้กับหัวข้อเฉพาะของคุณ

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

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

5. แทนที่ชื่อเริ่มต้นด้วยชื่อที่ตรงกันทุกประการกับชื่อของตัวแปรที่ส่งผ่านจากระบบภายนอก

6. ภายใต้ การใช้งาน เลือก ส่วนกลาง (สามารถเข้าถึงหัวข้อใดก็ได้) และ แหล่งภายนอกสามารถกำหนดค่าได้

7. ภายใต้ การอ้างอิง ให้เลือกจุดสามจุด (⋮) ที่มุมขวาบน แล้วเลือก รับค่าจากโหนดนี้หากว่างเปล่า

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

   สำหรับตัวแปรที่มาจากช่องทาง Omni สำหรับ Customer Service เราขอแนะนำค่า 10 วินาที (10,000 มิลลิวินาที) เป็นเวลารอสูงสุด

9. ในโหนด ตั้งค่าตัวแปร ให้ป้อนค่าเริ่มต้นที่จะใช้หากถึงระยะหมดเวลา เอเจนต์ของคุณจะคาดหวังค่าที่มีชนิดข้อมูลเดียวกัน ถ้าคุณต้องการให้ค่าเริ่มต้นนี้เป็นสตริงว่าง ให้ใช้ Text("") เป็นสูตร

   

10. สำหรับค่าอื่นๆ ที่คุณคาดว่าจะมาจากระบบภายนอก ให้เพิ่มโหนด ตั้งค่าตัวแปร ในหัวข้อเฉพาะของคุณ และกำหนดค่าตัวแปรส่วนกลางที่ต้องการในลักษณะเดียวกัน

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

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

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

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

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

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

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

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

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

ตัวอย่าง

• คุณมีตัวแปรส่วนกลางชื่อ Global.UserName
• URL ของเอเจนต์ของคุณคือ https://web.powerva.microsoft.com/webchat/bots/12345
• หากต้องการส่งผ่านชื่อของผู้ใช้เมื่อเริ่มต้นการสนทนาของเอเจนต์ในเว็บไซต์ของคุณ ให้แนบสตริงการสอบถาม UserName= เป็น: https://web.powerva.microsoft.com/webchat/bots/12345?UserName=Ana

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

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

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

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

   • คุณมีตัวแปรส่วนกลางชื่อ bot.UserEmail
   • URL ของเอเจนต์ของคุณคือ https://web.powerva.microsoft.com/webchat/bots/12345
   • หากต้องการส่งชื่อผู้ใช้เมื่อเริ่มการสนทนากับเอเจนต์บนเว็บไซต์ คุณสามารถแนบสตริงการสอบถาม UserEmail= เป็น: https://web.powerva.microsoft.com/webchat/bots/12345?UserEmail=Ana@contoso.com

2. ชื่อพารามิเตอร์ต้องตรงตามตัวพิมพ์ใหญ่-เล็ก ซึ่งหมายความว่า useremail=Ana@contoso.com จะทำงานในตัวอย่างนี้ด้วย

1. ในส่วน <script> ในหน้าที่คุณมีเอเจนต์ของคุณ กำหนดตัวแปรดังต่อไปนี้แทนที่ 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 เมื่อคุณฝังเอเจนต์ของคุณ ดังตัวอย่างต่อไปนี้โดยที่ store ถูกเรียกใช้ก่อนที่ styleOptions จะถูกเรียกใช้ (คุณต้องแทนที่ BOT_ID ด้วยรหัสเอเจนต์ของคุณ):

   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));
   

1. ในส่วน <script> ในหน้าที่คุณมีเอเจนต์ของคุณ กำหนดตัวแปรดังต่อไปนี้แทนที่ variableName1 สำหรับชื่อตัวแปรที่ไม่มีคำนำหน้า bot. และ 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 เมื่อคุณฝังเอเจนต์ของคุณ ดังตัวอย่างต่อไปนี้โดยที่ store ถูกเรียกใช้ก่อนที่ styleOptions จะถูกเรียกใช้ (คุณต้องแทนที่ BOT_ID ด้วยรหัสของคุณ):

   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));