แชร์ผ่าน

จับภาพการวัดและส่งข้อมูลทางไกลด้วย Application Insights

  • บทความ

บทความนี้จะอธิบายวิธีที่คุณสามารถเก็บข้อมูลการวัดและส่งข้อมูลทางไกลจากเอเจนต์ Copilot Studio ของคุณเพื่อใช้ใน Azure Application Insights

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

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

สำคัญ

Application Insights เป็นคุณสมบัติของ การตรวจสอบของ Azure ซึ่งเป็นเครื่องมือจัดการประสิทธิภาพแอปพลิเคชันที่ขยายได้ (APM) ที่ให้คุณตรวจสอบแอปพลิเคชันที่ใช้งานอยู่ ซึ่งต้องสมัครสมาชิกกับ Microsoft Azure

เชื่อมต่อเอเจนต์ Copilot Studio ของคุณกับ Application Insights

หากต้องการเชื่อมต่อเอเจนต์กับ Application Insights คุณต้องเพิ่มคีย์การรายงานข้อมูลระบบของคุณในการกำหนดค่าของเอเจนต์ก่อน

  1. ไปที่หน้า การตั้งค่า สำหรับเอเจนต์ของคุณ และเลือก ขั้นสูง

  2. ภายในส่วน Application Insights เติมข้อมูลการตั้งค่า สตริงการเชื่อมต่อ ดูที่ คู่มือ Azure Monitor เพื่อค้นหาวิธีค้นหาสตริงการเชื่อมต่อของคุณ

  3. หรือคุณสามารถเลือกเปิดใช้งานหนึ่งในการตั้งค่าต่อไปนี้:

    • บันทึกกิจกรรม: หากเปิดใช้งาน รายละเอียดของข้อความเข้า/ออกและเหตุการณ์จะถูกบันทึก

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

วิเคราะห์การวัดและส่งข้อมูลทางไกลของบอทด้วย Application Insights

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

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

การสอบถามตัวอย่าง

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

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

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

let queryStartDate = ago(14d);
let queryEndDate = now();
let groupByInterval = 1d;
customEvents
| where timestamp > queryStartDate
| where timestamp < queryEndDate
| summarize uc=dcount(user_Id) by bin(timestamp, groupByInterval)
| render timechart

สำคัญ

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

การตัดการวัดและส่งข้อมูลทางไกลออกจากการสนทนาทดสอบจากการสอบถามของคุณ

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

ตัวอย่างต่อไปนี้แสดงเหตุการณ์ที่กำหนดเองทั้งหมด ยกเว้นเหตุการณ์ที่บันทึกผ่านพื้นที่ทำงานทดสอบ

customEvents
| extend isDesignMode = customDimensions['designMode']
| where isDesignMode == "False"

มิติที่กำหนดเอง

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

เขตข้อมูล รายละเอียด ค่าตัวอย่าง
type ชนิดของกิจกรรม message, conversationUpdate, event, invoke
channelId รหัสช่องทาง emulator, directline, msteams, webchat
fromId รหัสผู้ส่ง <id>
fromName ชื่อผู้ใช้จากไคลเอ็นต์ John Bonham, Keith Moon, Steve Smith, Steve Gadd
locale ตำแหน่งที่ตั้งต้นทางไคลเอ็นต์ en-us, zh-cn, en-GB, de-de, zh-CN
recipientId รหัสผู้รับ <id>
recipientName ชื่อผู้รับ John Bonham, Keith Moon, Steve Smith, Steve Gadd
ข้อความ ตัวอักษรในข้อความ find a coffee shop
designMode การสนทนาที่เกิดขึ้นภายในพื้นที่ทำงานทดสอบ True / False