ตัวแปร Copilot ใช้ระหว่างเซสชันผู้ใช้คนเดียว คุณระบุตัวแปรที่ควรถือว่าเป็นตัวแปร Copilot เพื่อแยกความแตกต่างจากตัวแปรระดับหัวข้อ
สร้างตัวแปรส่วนกลาง
คุณสามารถสร้างตัวแปรส่วนกลางได้โดยการเปลี่ยนขอบเขตของตัวแปรหัวข้อ
สร้างตัวแปร หรือ ใช้บานหน้าต่าง ตัวแปร เพื่อเปิดตัวแปรที่มีอยู่
บนบานหน้าต่าง คุณสมบัติตัวแปร ให้เลือก ส่วนกลาง (หัวข้อใดๆ สามารถเข้าถึงได้)
ชื่อตัวแปรจะมีคำนำหน้า Global.
เพื่อแยกความแตกต่างจากตัวแปรระดับหัวข้อ ตัวอย่างเช่น ตัวแปร UserName
แสดงเป็น Global.UserName
บันทึกหัวข้อ
ชื่อตัวแปรส่วนกลางต้องไม่ซ้ำกันในทุกหัวข้อ หากมีข้อขัดแย้ง คุณจะต้องเปลี่ยนชื่อตัวแปรก่อนบันทึกหัวข้อของคุณ
ใช้ตัวแปรส่วนกลาง
เมื่อคุณเขียนข้อความ Copilot ในโหนดข้อความหรือโหนดคำถาม ให้เลือกไอคอน {x} เพื่อดูตัวแปรที่มีอยู่ในหัวข้อ ตัวแปรส่วนกลางปรากฏบนแท็บ กำหนดเอง ข้างตัวแปรหัวข้อใดๆ ตัวแปรจะแสดงตามลำดับตัวอักษร
ค้นหาหัวข้อทั้งหมดโดยใช้ตัวแปรส่วนกลาง
คุณสามารถดูได้ว่ามีการกำหนดตัวแปรส่วนกลางไว้ที่ใดและหัวข้อใดใช้ตัวแปรอยู่ สิ่งนี้จะมีประโยชน์หากคุณกำลังทำงานกับ Copilot ใหม่ หรือหากคุณมีตัวแปรหลายตัวและ สาขาหัวข้อที่ซับซ้อน
เลือกตัวแปรส่วนกลางในพื้นที่ทำงานการเขียนหรือเปิดบานหน้าต่าง ตัวแปร และเลือกตัวแปรส่วนกลาง
บนบานหน้าต่าง คุณสมบัติตัวแปร ในส่วน การอ้างอิง เลือกหัวข้อที่ใช้ตัวแปรเพื่อไปที่หัวข้อและโหนดนั้นโดยตรง
วงจรชีวิตของตัวแปรส่วนกลาง
ตามค่าเริ่มต้น ค่าของตัวแปรส่วนกลางจะยังคงอยู่จนกว่า เซสชัน จะสิ้นสุดลง โหนด ล้างค่าตัวแปร nจะรีเซ็ตค่าของตัวแปรส่วนกลางและใช้ในหัวข้อของระบบ รีเซ็ตการสนทนา หัวข้อนั้นสามารถทริกเกอร์ได้โดยการเปลี่ยนเส้นทางหรือเมื่อผู้ใช้พิมพ์ข้อความทริกเกอร์ เช่น "เริ่มใหม่" ในกรณีนั้น ตัวแปรส่วนกลางทั้งหมดจะถูกรีเซ็ต
ตั้งค่าตัวแปรส่วนกลางจากแหล่งภายนอก
หากคุณต้องการให้แน่ใจว่า Copilot เริ่มการสนทนาด้วยบริบทบางอย่าง คุณสามารถเริ่มต้นตัวแปรส่วนกลางด้วยแหล่งข้อมูลภายนอกได้ สมมติว่าไซต์ของคุณต้องการให้ผู้ใช้ลงชื่อเข้าใช้ เนื่องจาก Copilot ของคุณรู้ชื่อผู้ใช้อยู่แล้ว จึงสามารถทักทายลูกค้าด้วยชื่อก่อนที่จะเริ่มพิมพ์คำถามแรก
เลือกตัวแปรส่วนกลาง
ในบานหน้าต่าง คุณสมบัติตัวแปร ให้เลือก แหล่งภายนอกสามารถตั้งค่าได้
ตั้งค่าตัวแปรส่วนกลางใน Copilot แบบฝัง
หากคุณกำลัง ฝัง Copilot ของคุณในหน้าเว็บธรรมดา คุณสามารถผนวกตัวแปรและคำจำกัดความต่อท้าย URL ของ Copilot ได้ หรือหากคุณต้องการการควบคุมเพิ่มขึ้นอีกเล็กน้อย คุณสามารถใช้บล็อกโค้ด <script>
เพื่อเรียกและใช้ตัวแปรโดยทางโปรแกรม
ชื่อตัวแปรในสตริงการสอบถามของ URL ต้องตรงกับชื่อของตัวแปรส่วนกลาง โดยไม่มีคำนำหน้า Global.
ตัวอย่างเช่น ตัวแปรส่วนกลาง Global.UserName
จะถูกอ้างถึงเป็น UserName
ในการสอบถาม
ตัวอย่างที่ตามมาเป็นการประกาศอย่างง่ายสำหรับตัวแปร ในสถานการณ์การใช้งานจริง คุณอาจส่งผ่านเป็นพารามิเตอร์การสอบถามหรือนิยามตัวแปรตัวแปรอื่นที่เก็บชื่อผู้ใช้ไว้แล้ว (ตัวอย่างเช่น หากคุณมีชื่อผู้ใช้จากสคริปต์การลงชื่อเข้าใช้)
ผนวกตัวแปรและคำจำกัดความเข้ากับ URL ของ Copilot เป็น พารามิเตอร์สตริงการสอบถาม ในรูปแบบ botURL?variableName1=variableDefinition1&variableName2=variableDefinition2
ตัวอย่าง
ชื่อพารามิเตอร์ต้องตรงตามตัวพิมพ์ใหญ่-เล็ก
username=Renata
จะทำงานในตัวอย่างนี้ด้วย
เพิ่มตัวแปรส่วนกลางลงในพื้นที่ทำงานแบบกำหนดเอง
คุณยังสามารถเพิ่มตัวแปรลงใน พื้นที่ทำงานแบบกำหนดเอง ได้ด้วย
ในส่วน <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);
});
ในส่วน <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));
ตัวแปร Copilot ใช้ระหว่างเซสชันผู้ใช้คนเดียว คุณระบุตัวแปรที่ควรถือว่าเป็นตัวแปร Copilot เพื่อแยกความแตกต่างจากตัวแปรระดับหัวข้อ
ตั้งค่าตัวแปร Copilot
หลังจากคุณตั้งค่าตัวแปร Copilot แล้ว Copilot จะพร้อมใช้งานสำหรับทุกหัวข้อ
เมื่อคุณเลือกปุ่ม {x}
ในโหนดข้อความหรือโหนดคำถามเมื่อคุณเขียนข้อความ Copilot คุณจะเห็นว่าตัวแปร Copilot พร้อมใช้งาน ตัวแปรจะเรียงตามลำดับตัวอักษร ดังนั้นคุณจะพบว่าตัวแปร Copilot ทั้งหมดถูกจัดกลุ่มเข้าด้วยกันในเมนูตัวแปรเพราะทั้งหมดขึ้นต้นด้วย copilot.
เมื่อคุณใช้โหนดเงื่อนไข โหนดโฟลว์การดำเนินการ หรือโหนดทักษะ คุณจะเห็นตัวแปร Copilot พร้อมใช้งานที่นั่น
นำตัวแปรไปใช้ซ้ำในหัวข้อต่าง ๆ โดยตั้งเป็นตัวแปร Copilot
เลือกตัวแปรใดก็ได้ในพื้นที่ทำงานการสร้าง
บนบานหน้าต่าง คุณสมบัติของตัวแปร ด้านล่าง การใช้งาน เลือก Copilot (หัวข้อใดๆ สามารถเข้าถึงได้)
ชื่อตัวแปรจะได้รับสตริงคำนำหน้า copilot.
เพื่อแยกความแตกต่างจากตัวแปรระดับหัวข้อ ตัวอย่างเช่น ตัวแปรUserName
แสดงเป็น copilot.UserName
หมายเหตุ
ชื่อตัวแปร Copilot ทต้องไม่ซ้ำกันในทุกหัวข้อ ในกรณีที่มีข้อขัดแย้ง คุณจะต้องเปลี่ยนชื่อตัวแปรก่อนบันทึกการเปลี่ยนแปลงของคุณ
จัดการตัวแปร Copilot
หลังจากที่คุณสร้างตัวแปร Copilot แล้ว คุณสามารถดูได้ว่ามีการกำหนดไว้ที่ใดก่อนและหัวข้ออื่น ๆ ใช้ สิ่งนี้จะมีประโยชน์หากคุณกำลังทำงานกับ Copilot ใหม่ หรือหากคุณมีตัวแปรหลายตัวและ สาขาหัวข้อที่ซับซ้อน
ไปที่แหล่งที่มาของนิยามของตัวแปร Copilot
เลือกตัวแปรใดก็ได้ในพื้นที่ทำงานการสร้าง
บนบานหน้าต่าง คุณสมบัติของตัวแปร เลือก ไปที่ต้นทาง
สิ่งนี้จะนำคุณไปยังโหนดในหัวข้อที่สร้างตัวแปร Copilot
ค้นหาหัวข้อทั้งหมดโดยใช้ตัวแปร Copilot
เลือกตัวแปร Copilot ใดก็ได้ในพื้นที่ทำงานการสร้าง
บนบานหน้าต่าง คุณสมบัติของตัวแปร ในส่วน ใช้โดย เลือกหัวข้อที่ใช้ตัวแปรเพื่อตรงไปที่หัวข้อและโหนดนั้น
การเตรียมใช้งานตัวแปร Copilot
หากตัวแปร Copilot ถูกทริกเกอร์ก่อนที่จะเริ่มต้น (หรือ "เติมเต็ม") Copilot จะทริกเกอร์ส่วนของหัวข้อโดยอัตโนมัติโดยที่ตัวแปร Copilot ถูกกำหนดก่อนแม้ว่าจะอยู่ในหัวข้ออื่นก่อนจะกลับไปใช้หัวข้อเดิม สิ่งนี้ช่วยให้ Copilot สามารถเติมตัวแปรทั้งหมดได้โดยไม่รบกวนการสนทนา
ตัวอย่างเช่น ลูกค้าเริ่มการสนทนาในหัวข้อ "การจองการนัดหมาย" ซึ่งตัวแปร Copilot copilot.UserName
ถูกนำมาใช้ อย่างไรก็ตาม เริ่มแรกตัวแปร copilot.UserName
ถูกกำหนดไว้ในหัวข้อ "ยินดีต้อนรับ"
เมื่อการสนทนามาถึงประเด็นในหัวข้อ "การจองการนัดหมาย" ที่ copilot.UserName
ถูกอ้างอิง Copilot จะควบคุมการแสดงผลอย่างสั้นไปยังโหนดคำถามอย่างราบรื่นโดยกำหนด copilot.UserName
ไว้ก่อน
หลังจากลูกค้าตอบคำถาม Copilot จะกลับมาดำเนินการหัวข้อ "การจองการนัดหมาย"
ลักษณะการทำงานตัวแปร Copilot เมื่อใช้การดำเนินการผ่านโฟลว์และทักษะ Power Automate
บางครั้ง คุณอาจใช้ขั้โฟลว์หรือทักษะในการเริ่มต้นหรือเติมตัวแปรใน Copilot
อย่างไรก็ตาม เมื่อผู้ใช้โต้ตอบกับ Copilot ตัวแปรอาจถูกเติมในช่วงก่อนหน้าของการสนทนา หรือคุณอาจ ตั้งค่าตัวแปรภายนอกแล้ว
ในสถานการณ์นี้ โฟลว์หรือทักษะจะยังคงทำงานและเติมตัวแปร โดยเขียนทับสิ่งที่เก็บไว้ก่อนหน้านี้ในตัวแปร
วงจรชีวิตของตัวแปร Copilot และการรีเซ็ตค่า
ตัวแปร Copilot สามารถเข้าถึงได้จากหัวข้อใดๆ และค่าที่กำหนดของตัวแปร Copilot ยังคงมีอยู่ตลอด เซสชัน
ค่านี้จะถูกล้างก็ต่อเมื่อผู้ใช้ Copilot ถูกเปลี่ยนเส้นทางไปยัง หัวข้อระบบ เริ่มต้นใหม่ หรือเมื่อผู้ใช้ทริกเกอร์หัวข้ นี้โดยตรง (ตัวอย่างเช่น โดยการพิมพ์ เริ่มต้นใหม่) ในกรณีนี้ ตัวแปร Copilot ทั้งหมดจะถูกรีเซ็ต และจะไม่มีค่าใดๆ
ตั้งค่าตัวแปร Copilot จากแหล่งภายนอก
คุณสามารถตั้งค่าตัวแปร Copilot ที่จะเริ่มต้นด้วยแหล่งภายนอกได้ สิ่งนี้ช่วยให้ Copilot เริ่มการสนทนาด้วยบริบทบางอย่าง
ตัวอย่างเช่น ลูกค้าเรียก Copilot จากเว็บไซต์ของคุณ และไซต์นั้นก็รู้ชื่อลูกค้าแล้ว คุณแจ้งให้ Copilot ทราบชื่อผู้ใช้ก่อนเริ่มการสนทนา และ Copilot สามารถสนทนากับลูกค้าได้อย่างชาญฉลาดมากขึ้นโดยไม่ต้องถามชื่ออีก
ตั้งค่าตัวแปร Copilot จากแหล่งภายนอก
เลือกตัวแปรใดก็ได้ในพื้นที่ทำงานการสร้าง
บนบานหน้าต่าง คุณสมบัติของตัวแปร ในส่วร การใช้งาน เลือกช่องทำเครื่องหมาย แหล่งภายนอกสามารถกำหนดค่าได้
คุณสามารถต่อท้ายตัวแปรและคำจำกัดความได้หากคุณเพียงแค่ ฝัง Copilot ของคุณในหน้าเว็บง่าย ๆ หรือคุณสามารถใช้บล็อกโค้ด <script>
เพื่อเรียกและใช้ตัวแปรทางโปรแกรม
หมายเหตุ
ชื่อตัวแปรในสตริงแบบสอบถามต้องตรงกับตัวแปร Copilot โดยไม่มีคำนำหน้า copilot.
ตัวอย่างเช่น ตัวแปร Copilot copilot.UserName
จะต้องแสดงผลเป็น UserName=
ในตัวอย่างที่อธิบายไว้ที่นี่ มีการประกาศอย่างง่ายสำหรับตัวแปร ในสถานการณ์การใช้งานจริง คุณอาจส่งผ่านเป็นพารามิเตอร์การสอบถามหรือนิยามตัวแปรตัวแปรอื่นที่เก็บชื่อผู้ใช้ไว้แล้ว (ตัวอย่างเช่น หากคุณมีชื่อผู้ใช้จากสคริปต์การลงชื่อเข้าใช้)
หากต้องการเพิ่มตัวแปรให้กับ Copilot ที่ฝังไว้
ผนวกตัวแปรและคำจำกัดความเข้ากับ URL ของ Copilot เป็น พารามิเตอร์สตริงการสอบถาม (ในรูปแบบ botURL?variableName1=variableDefinition1&variableName2=variableDefinition2
) ตัวอย่างเช่น:
ชื่อพารามิเตอร์ต้องตรงตามตัวพิมพ์ใหญ่-เล็ก ซึ่งหมายความว่า username=Renata
จะทำงานในตัวอย่างนี้ด้วย
ในส่วน <script>
ในหน้าที่คุณมี Copilot ของคุณ กำหนดตัวแปรดังต่อไปนี้แทนที่ variableName1
สำหรับชื่อตัวแปรที่ไม่มีคำนำหน้า copilot.
และ 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);
});
ภายในส่วน <script>
เรียกใช้ store
เมื่อคุณฝัง Copilot ของคุณ ดังตัวอย่างต่อไปนี้โดยที่ 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));
ลบตัวแปร Copilot
เมื่อลบตัวแปร Copilot ที่ใช้ในหัวข้ออื่น การอ้างอิงถึงตัวแปรนั้นในหัวข้อจะถูกทำเครื่องหมายเป็น Unknown
คุณจะได้รับคำเตือนเกี่ยวกับการลบตัวแปร Copilot ก่อนที่จะยืนยันการดำเนินการ
โหนดที่มีการอ้างอิงถึงตัวแปร Copilot ที่ถูกลบจะบอกคุณว่ามีตัวแปรที่ไม่รู้จัก
หัวข้อที่มีโหนดที่มีการอ้างอิงถึงตัวแปร Copilot ที่ถูกลบอาจหยุดทำงาน ตรวจสอบให้แน่ใจว่าคุณลบหรือแก้ไขหัวข้อทั้งหมดที่ใช้ตัวแปรที่ถูกลบก่อนที่จะเผยแพร่
ขึ้นอยู่กับการตั้งค่าการตรวจสอบความถูกต้องของ Copilot คุณจะมีชุดของตัวแปร Copilot ที่เกี่ยวข้องกับตัวให้บริการข้อมูลเอกลักษณ์ที่พร้อมใช้งานสำหรับคุณ สำหรับรายละเอียดเกี่ยวกับชุดตัวแปรที่พร้อมใช้งานและวิธีการใช้งาน โปรดดู เพิ่มการรับรองความถูกต้องผู้ใช้ปลายทางในหัวข้อ