หมายเหตุ
การเข้าถึงหน้านี้ต้องได้รับการอนุญาต คุณสามารถลอง ลงชื่อเข้าใช้หรือเปลี่ยนไดเรกทอรีได้
การเข้าถึงหน้านี้ต้องได้รับการอนุญาต คุณสามารถลองเปลี่ยนไดเรกทอรีได้
เอเจนต์ดีบักเกอร์เป็นเครื่องมือวินิจฉัยที่ช่วยให้คุณโหลดการสนทนาที่บันทึกไว้และตรวจสอบการตัดสินใจแต่ละครั้งที่เอเจนต์ทำ สำหรับทุกรอบการสนทนา คุณสามารถตรวจสอบเส้นทางการดำเนินการ จังหวะเวลาขั้นตอน การใช้โทเค็น แหล่งความรู้ อาร์กิวเมนต์ขั้นตอน และเหตุผลของแอปพลิเคชันประสานการทำงานของระบบ
เอเจนต์ดีบักเกอร์รองรับแหล่งข้อมูลสองแหล่ง:
- การถอดเสียงการสนทนา (Dataverse): เมื่อการสนทนาทำงานใน Copilot Studio แพลตฟอร์มจะบันทึกบันทึกกิจกรรมเป็นการถอดเสียงการสนทนาใน Dataverse เอเจนต์ดีบักเกอร์จะสอบถามเรกคอร์ดเหล่านั้นโดยตรง ดังนั้นเอเจนต์ที่เผยแพร่ด้วยข้อมูลการถอดเสียงจะพร้อมใช้งานทันที
- สแนปช็อต Copilot Studio (ZIP): แผงทดสอบ Copilot Studio มีตัวเลือก ดาวน์โหลดสแนปช็อต ที่ส่งออกการสนทนาทดสอบปัจจุบันเป็นไฟล์ ZIP การอัปโหลดไฟล์นั้นไปยังเอเจนต์ดีบักเกอร์จะทำให้คุณมีมุมมองการวิเคราะห์แบบเต็มโดยไม่ต้องเชื่อมต่อ Dataverse วิธีนี้มีประโยชน์สำหรับการดีบักการสนทนาก่อนการผลิต การสร้างปัญหาแบบออฟไลน์ หรือการแชร์เซสชันที่ล้มเหลวกับเพื่อนร่วมงาน
แหล่งข้อมูลทั้งสองจะส่งข้อมูลเข้าสู่อินเทอร์เฟซการวิเคราะห์เดียวกัน แผง รายละเอียดขั้นตอน และการแสดงภาพจะเหมือนกันโดยไม่คำนึงถึงวิธีการโหลดข้อมูล
ข้อกำหนดเบื้องต้น
เมื่อต้องการใช้เอเจนต์ดีบักเกอร์ ตรวจสอบให้แน่ใจว่าตรงตามข้อกำหนดเบื้องต้นต่อไปนี้:
- เอเจนต์มีอยู่ใน คลังเอเจนต์ และมีบันทึกการถอดเสียงการสนทนาอย่างน้อยหนึ่งรายการ คุณสามารถตรวจสอบเงื่อนไขนี้ได้โดยเปิดมุมมองรายการคลังเอเจนต์ เลือกเอเจนต์ และเลือก แสดงเพิ่มเติม เพื่อขยายฟิลด์เพิ่มเติม ฟิลด์ มีการถอดความ ต้องตั้งค่าเป็น ใช่ การคลังเอเจนต์จะตั้งค่าฟิลด์นี้โดยอัตโนมัติเมื่อมีการถอดเสียงการสนทนาอย่างน้อยหนึ่งรายการสำหรับเอเจนต์ใน Dataverse
- ผู้ใช้ที่ลงชื่อเข้าใช้มี Security role เป็น CSK - ผู้ดูแลระบบ หรือ ผู้ดูแลระบบ ในสภาพแวดล้อมของชุดอุปกรณ์
- ผู้ใช้ที่ลงชื่อเข้าใช้มีสิทธิ์ อ่าน บนตาราง
conversationtranscripts,botและbotcomponentsในสภาพแวดล้อมเป้าหมาย
หมายเหตุ
ถ้าเอเจนต์ที่คุณกำลังดีบักอยู่ในสภาพแวดล้อมที่แตกต่างจากที่ติดตั้งชุดอุปกรณ์ คุณต้องรับรองความถูกต้องของการเชื่อมต่อ Dataverse ในสภาพแวดล้อมระยะไกลด้วยสิทธิ์การอ่านเดียวกัน
เลือกการสนทนา
เมื่อคุณเปิดเอเจนต์ดีบักเกอร์ แถบตัวกรองจะมีตัวควบคุมที่คุณต้องการเพื่อค้นหาการสนทนาเพื่อวิเคราะห์
| ตัวกรอง | คำอธิบาย |
|---|---|
| สภาพแวดล้อม | เติมข้อมูลจากชื่อสภาพแวดล้อมที่แตกต่างกันที่พบในคลังเอเจนต์ การเลือกสภาพแวดล้อมจะจำกัดดรอปดาวน์ เอเจนต์ ให้แคบลงเป็นเอเจนต์ที่ลงทะเบียนในสภาพแวดล้อมนั้น |
| เอเจนต์ | แสดงเอเจนต์ในสภาพแวดล้อมที่เลือกซึ่งมีฟิลด์ มีการถอดความ ถูกตั้งค่าเป็น ใช่ การเลือกเอเจนต์จะโหลดการสนทนาล่าสุด 50 รายการภายในช่วงเวลาที่เลือกลงในดรอปดาวน์ รหัสการสนทนา |
| รหัสการสนทนา | แสดงการสนทนาที่ไม่ซ้ำกัน 50 รายการล่าสุดสำหรับเอเจนต์ที่เลือกภายในช่วงเวลาที่กำหนดค่าไว้ การพิมพ์ในกล่องจะทริกเกอร์การค้นหาแบบเต็มในการถอดเสียงทั้งหมดสำหรับเอเจนต์นั้น (สูงสุด 100,000 เรกคอร์ด) ดังนั้นคุณจึงสามารถค้นหาการสนทนาที่เก่ากว่าหรือเฉพาะเจาะจงโดยไม่คำนึงถึงช่วงเวลา |
| ช่วงเวลา | จำกัดรายการ รหัสการสนทนา ให้แคบลงเป็นหน้าต่างเฉพาะ เลือกจาก 30 นาทีที่ผ่านมา, ชั่วโมงที่ผ่านมา, 4 ชั่วโมงที่ผ่านมา, 24 ชั่วโมงที่ผ่านมา, 7 วันที่ผ่านมา หรือ ช่วงที่กำหนดเอง เมื่อคุณเลือก ช่วงที่กำหนดเอง ตัวเลือกวันที่และเวลาจะปรากฏขึ้นเพื่อตั้งค่าการประทับเวลาเริ่มต้นและสิ้นสุด |
| การสนทนาที่ผิดพลาดเท่านั้น | กรองดรอปดาวน์ รหัสการสนทนา ไปยังการสนทนาที่มีขั้นตอนที่ล้มเหลวหรือข้อผิดพลาดของระบบอย่างน้อยหนึ่งขั้นตอน ใช้ตัวเลือกนี้เมื่อคัดแยกเหตุการณ์หรือตรวจสอบเอเจนต์ที่มีปัญหาความน่าเชื่อถือที่ทราบ |
หลังจากที่คุณเลือก รหัสการสนทนาการวิเคราะห์ จะพร้อมใช้งาน เลือกเพื่อเปิดมุมมองการวิเคราะห์
หมายเหตุ
การพิมพ์รหัสการสนทนาโดยตรงจะค้นหาการถอดเสียงทั้งหมดเสมอโดยไม่คำนึงถึงช่วงเวลาที่ใช้งานอยู่ ตัวกรอง การสนทนาที่ผิดพลาดเท่านั้น จะสแกนเนื้อหาการถอดเสียงในฝั่งไคลเอ็นต์เท่านั้น และใช้เวลานานกว่าการสืบค้นมาตรฐาน ปล่อยทิ้งไว้ เว้นแต่คุณจะต้องกรองตามข้อผิดพลาดโดยเฉพาะ
อัปโหลดสแนปช็อตจาก Copilot Studio
แท็บ อัปโหลดสแนปช็อต มีจุดเริ่มต้นทางเลือกที่ไม่ต้องการการเข้าถึง Dataverse แทนที่จะเลือกการสนทนาสดจากดรอปดาวน์ คุณจะอัปโหลดไฟล์ ZIP สแนปช็อตที่ดาวน์โหลดจากบานหน้าต่างทดสอบ Copilot Studio
ในการดาวน์โหลดสแนปช็อตจาก Copilot Studio:
- เปิดเอเจนต์หลักของคุณใน Copilot Studio และไปที่แผง ทดสอบเอเจนต์ของคุณ
- รันหรือตรวจสอบการสนทนา
- เลือก ดาวน์โหลดสแนปช็อต ในแถบเครื่องมือของแผงทดสอบ
Copilot Studio จะดาวน์โหลดไฟล์ .zip ที่มี:
-
dialog.json: กิจกรรม Bot Framework ทั้งหมดสำหรับการสนทนา (จำเป็น) -
botContent.yml: ส่วนประกอบแบบเต็มของเอเจนต์และข้อกำหนดโฟลว์ ซึ่งใช้ในการแก้ไขชื่อขั้นตอน (ไม่บังคับ หากไม่มี ชื่อ Schema ดิบจะแสดงขึ้น)
ในการอัปโหลดสแนปช็อตไปยังเอเจนต์ดีบักเกอร์:
- สลับไปยังแท็บ อัปโหลดสแนปช็อต ในส่วนหัวเอเจนต์ดีบักเกอร์
- ลากและวางไฟล์
.zipบนโซนวาง หรือเลือกเพื่อเรียกดู
เอเจนต์ดีบักเกอร์ตรวจสอบความถูกต้องของ ZIP แยกไฟล์ และเปิดมุมมองการวิเคราะห์ ไม่จำเป็นต้องเลือกสภาพแวดล้อม เอเจนต์ หรือการสนทนา เมตริกข้อมูลทั่วไปทั้งหมดได้มาจากไฟล์ที่อัปโหลด
ใช้โหมดอัปโหลดสแนปช็อตเมื่อคุณต้องการ:
- แก้ไขข้อบกพร่องการสนทนาที่เกิดขึ้นในบานหน้าต่างทดสอบก่อนที่เอเจนต์จะถูกเผยแพร่
- วิเคราะห์การสนทนาจากสภาพแวดล้อมที่คุณไม่สามารถรับรองความถูกต้องได้
- สร้างปัญหาแบบออฟไลน์หรือแชร์เซสชันที่ล้มเหลวกับเพื่อนร่วมงานโดยไม่ให้สิทธิ์การเข้าถึง Dataverse
- ตรวจสอบพฤติกรรมของเอเจนต์ในสภาพแวดล้อมการพัฒนาภายในเครื่อง
วิเคราะห์การสนทนา
มุมมองการวิเคราะห์จะเปิดขึ้นหลังจากที่คุณเลือก วิเคราะห์ หรืออัปโหลดสแนปช็อต ประกอบด้วยแถวสรุป ข้อมูลทั่วไป ที่ด้านบน ส่วนการวิเคราะห์ที่ยุบได้ที่มีสี่แผง (เส้นทางการดำเนินการ, เส้นเวลาประสิทธิภาพการทำงาน, รายละเอียดเอเจนต์ และ คำแนะนำ) และเค้าโครงสองแผงที่แสดง ตัวอย่างการสนทนา ควบคู่ไปกับแผง ข้อมูลดีบัก panel.
ข้อมูลทั่วไป
แถวข้อมูลทั่วไปแสดงไทล์เมตริกสรุปสำหรับการสนทนา
| ฟิลด์ | คำอธิบาย |
|---|---|
| เซสชัน | จำนวนเซสชันการสนทนา เซสชันหลายเซสชันจะเกิดขึ้นเมื่อผู้ใช้กลับไปยังการสนทนาเดิมหลังจากไม่มีการใช้งาน |
| รอบ | จำนวนข้อความของผู้ใช้ในการสนทนา |
| ผลลัพธ์ | ผลลัพธ์ของเซสชันที่รายงานโดยแพลตฟอร์ม เช่น แก้ไขแล้ว ส่งต่อ ถูกละทิ้ง หรือ SystemError |
| ระยะเวลา | ระยะเวลาการสนทนาทั้งหมดตั้งแต่กิจกรรมแรกถึงกิจกรรมสุดท้าย |
| เวลาเริ่มต้น | เมื่อการสนทนาเริ่มต้นขึ้น (เวลาท้องถิ่น) |
| ช่องทาง | ช่องทางการสื่อสารที่ใช้ เช่น เว็บแชทหรือ msteams แสดงเมื่อพร้อมใช้งาน |
| โมเดล | โมเดล AI ที่ใช้โดยแอปพลิเคชันประสานการทำงานของระบบของเอเจนต์สำหรับการสนทนานี้ |
เมื่อโหลดตัวแทนสนทนาสด ลิงก์ เปิดเอเจนต์ จะปรากฏในส่วนหัวของข้อมูลทั่วไป ลิงก์จะเปิดหน้าการกำหนดค่าของเอเจนต์ใน Copilot Studio
เส้นทางการดำเนินการ
เส้นทางการดำเนินการจะแสดงลำดับการดำเนินการแบบเต็มในการสนทนาทั้งหมดเป็นไดอะแกรมโฟลว์ที่กำกับไว้ ขั้นตอนต่างๆ ดำเนินจากซ้ายไปขวาตามลำดับการทำงาน เส้นประแนวตั้งจะทำเครื่องหมายขอบเขตการเลี้ยว และข้อความของผู้ใช้แต่ละข้อความจะเริ่มส่วนใหม่ เปิดป้ายกำกับจะปรากฏที่ด้านบนของแต่ละส่วน การเลือกป้ายรอบจะเป็นการเลื่อน ตัวอย่างการสนทนา ไปยังข้อความนั้น
แต่ละชนิดขั้นตอนใช้สีที่แตกต่างกัน และคำอธิบายที่ด้านล่างของไดอะแกรมจะแมปสีกับประเภทขั้นตอน เช่น หัวข้อ ความรู้ เครื่องมือ ตัวเชื่อมต่อ โฟลว์ โค้ด MCP และเอเจนต์ที่เชื่อมต่อ แต่ละโหนดจะแสดงชื่อขั้นตอนและระยะเวลาการดำเนินการ ขั้นตอนที่ล้มเหลวจะถูกเน้นด้วยสีแดง เอเจนต์ที่เชื่อมต่อจะปรากฏเป็นกล่องคอนเทนเนอร์ที่จัดกลุ่มขั้นตอนรองที่พวกเขาดำเนินการ
ไทม์ไลน์ประสิทธิภาพ
ไทม์ไลน์ประสิทธิภาพแสดงแผนภูมิน้ำตกของเวลาดำเนินการตามขั้นตอนที่จัดกลุ่มตามรอบการสนทนา แถบขั้นตอนจะถูกปรับขนาดตามระยะเวลาทั้งหมดของรอบเพื่อให้มองเห็นเวลาสัมพัทธ์ รหัสสีตรงกับคำอธิบายเส้นทางการดำเนินการ และขั้นตอนที่ล้มเหลวจะปรากฏเป็นสีแดง
แผงนี้รวมคุณลักษณะดังต่อไปนี้:
- ปุ่ม ขยาย/ยุบทั้งหมด จะสลับส่วนรอบทั้งหมดพร้อมกัน แต่ละส่วนของรอบยังสามารถยุบแยกกันได้
- สถิติต่อรอบแสดงจำนวนก้าว ชื่อขั้นตอนและระยะเวลาที่ช้าที่สุด และจำนวนความล้มเหลว
- ข้อมูลสรุปส่วนกลางที่ด้านบนจะแสดงขั้นตอนทั้งหมด เวลาที่ผ่านไปทั้งหมด ขั้นตอนที่ช้าที่สุดในการสนทนาทั้งหมด และจำนวนความล้มเหลวทั้งหมด
- ขั้นตอนที่ช้ากว่า 10 วินาทีจะถูกตั้งค่าสถานะด้วยตัวบ่งชี้คำเตือน
รายละเอียดตัวแทน
แผงรายละเอียดเอเจนต์แสดงการกำหนดค่าทั้งหมดของเอเจนต์ตามที่มีอยู่ในขณะที่มีการวิเคราะห์การสนทนา ข้อมูลจะถูกจัดระเบียบเป็นหกแท็บ
| แท็บ | คำอธิบาย |
|---|---|
| ภาพรวม | ไทล์ KPI สำหรับหัวข้อ เครื่องมือ ความรู้ เอเจนต์ย่อย โหมดการประสานงาน ภาษา โหมดการรับรองความถูกต้อง ความรู้แบบจำลอง การค้นหาเชิงความหมาย และโมเดลล่าสุด แต่ละไทล์มีคำแนะนำเครื่องมือที่อธิบายการตั้งค่า |
| คำแนะนำ | พร้อมท์ระบบแบบเต็มของเอเจนต์ตามที่กำหนดค่าไว้ใน Copilot Studio |
| หัวข้อ | หัวข้อทั้งหมดที่มีชื่อ คำอธิบาย ตัวแปรอินพุต/เอาต์พุต และสถานะเปิดใช้งาน/ปิดใช้งาน |
| เครื่องมือ | เครื่องมือทั้งหมดที่มีชื่อ คำอธิบาย ป้ายประเภท (MCP, โฟลว์, ตัวเชื่อมต่อ, พร้อมท์) และสถานะเปิดใช้งาน/ปิดใช้งาน |
| ความรู้ | แหล่งความรู้ทั้งหมดที่มีชื่อ ป้ายชนิด (SharePoint, เว็บ, Dataverse, ไฟล์), URL และสถานะเปิดใช้งาน/ปิดใช้งาน |
| เอเจนต์ | เอเจนต์ย่อยที่เชื่อมต่อทั้งหมดที่มีชื่อ ชนิดความสัมพันธ์ และสถานะเปิดใช้งาน/ปิดใช้งาน |
คำแนะนำ
แผงคำแนะนำจะตรวจหาปัญหาในการสนทนาโดยอัตโนมัติ และแสดงเป็นการ์ดที่ดำเนินการได้พร้อมการให้คะแนนความรุนแรง
| ความรุนแรง | คำอธิบาย |
|---|---|
| สูง | น่าจะทำให้เกิดการตอบสนองที่ล้มเหลวหรือไม่ถูกต้อง ตรวจสอบทันที |
| ปานกลาง | ประสบการณ์ที่ลดลงหรือความเสี่ยงด้านความน่าเชื่อถือ ตรวจสอบเร็วๆ นี้ |
| ตํ่า | ความไร้ประสิทธิภาพเล็กน้อยหรือหมายเหตุข้อมูล |
ตรวจพบปัญหาชนิดต่อไปนี้:
| ประเด็น | ความรุนแรง | คำอธิบาย |
|---|---|---|
| ขั้นตอนล้มเหลวหรือข้อผิดพลาด | สูง | ขั้นตอนส่งกลับข้อผิดพลาดหรือข้อยกเว้น |
| บล็อค AI ที่รับผิดชอบ | สูง | เนื้อหาถูกกรองโดยระบบ AI ที่รับผิดชอบ |
| การยกระดับการสนทนา | สูง | การสนทนาถูกส่งต่อไปยังเอเจนต์ที่เป็นมนุษย์ |
| การละทิ้งการสนทนา | สูง | ผู้ใช้จากไปโดยไม่มีวิธีแก้ไขปัญหา |
| ทริกเกอร์หัวข้อสำรอง | สูง | เอเจนต์ล้มเหลวในการกำหนดเส้นทางข้อความของผู้ใช้ไปยังหัวข้อ |
| ขั้นตอนช้า (>10 วินาที) | ปานกลาง | ขั้นตอนหนึ่งใช้เวลามากกว่า 10 วินาทีในการดำเนินการ |
| การค้นหาองค์ความรู้ล้มเหลว | ปานกลาง | มีการสอบถามแหล่งความรู้ แต่ไม่แสดงผลลัพธ์ |
| ใกล้ถึงขีดจำกัดโทเค็นแล้ว | ปานกลาง | การใช้โทเค็นใกล้เคียงกับขีดจำกัดหน้าต่างบริบทของโมเดล |
| ข้อผิดพลาดขั้นตอนโค้ด | สูง | ขั้นตอนโค้ด Python ทำให้เกิดข้อยกเว้น |
| การเริ่มต้น MCP ล้มเหลว | สูง | เซิร์ฟเวอร์ MCP ล้มเหลวในการเริ่มต้นระหว่างการสนทนา |
การ์ดคำแนะนำแต่ละใบจะแสดงไอคอนและสีความรุนแรง ป้ายหมวดหมู่ ชื่อและคำอธิบายของปัญหาที่ตรวจพบ คำแนะนำเกี่ยวกับวิธีตรวจสอบหรือแก้ไข และปุ่ม ไปที่รอบ ที่เลื่อน ตัวอย่างการสนทนา ไปยังข้อความผู้ใช้ที่เกี่ยวข้อง เมื่อตรวจไม่พบปัญหา แผงควบคุมจะแสดงข้อความสถานะว่างเปล่า
ตัวอย่างการสนทนา
แผงแสดงตัวอย่างการสนทนาจะแสดงการแลกเปลี่ยนการสนทนาแบบเต็มตามที่ปรากฏต่อผู้ใช้ รวมถึงฟองข้อความของบอทและผู้ใช้ การ์ดที่ปรับเปลี่ยนได้ที่แสดงแบบอินไลน์ ชิปการดำเนินการที่แนะนำ และพร้อมท์ความคิดเห็น
การเลือกฟองข้อความของผู้ใช้จะโหลดขั้นตอนที่เปลี่ยนเป็นแผง ข้อมูลดีบัก ข้อความที่เลือกจะถูกไฮไลต์เพื่อให้คุณสามารถติดตามได้ว่าเลี้ยวใดที่ใช้งานอยู่ แผงควบคุมสามารถเลื่อนได้อย่างอิสระ การเลือกดู JSON ในส่วนหัวของการแสดงตัวอย่างการสนทนาจะเปิดกล่องโต้ตอบ JSON การถอดเสียงแบบเต็ม
ข้อมูลดีบัก
แผงข้อมูลการแก้ไขข้อบกพร่องจะแสดงรายละเอียดระดับขั้นตอนสำหรับรอบข้อความของผู้ใช้ที่เลือก แผงประกอบด้วยรายการขั้นตอนทางด้านซ้ายและมุมมองรายละเอียดขั้นตอนที่เปิดขึ้นเมื่อคุณเลือกขั้นตอน
รายการขั้นตอนแสดงทุกขั้นตอนของแอปพลิเคชันประสานการทำงานของระบบที่ดำเนินการสำหรับรอบที่เลือก พร้อมไอคอนขั้นตอนและสีที่ระบุชนิดขั้นตอน ชื่อขั้นตอน (แก้ไขเป็นชื่อที่แสดงที่เข้าใจง่ายหากเป็นไปได้) ระยะเวลาการดำเนินการ และตัวบ่งชี้ความสำเร็จหรือความล้มเหลว ขั้นตอนที่เป็นของเอเจนต์ที่เชื่อมต่อจะถูกจัดกลุ่มภายในการ์ดคอนเทนเนอร์ที่ยุบได้ซึ่งแสดงชื่อเอเจนต์และเวลาดำเนินการทั้งหมด ปุ่ม โหลดรายละเอียดเอเจนต์ที่เชื่อมต่อ บนคอนเทนเนอร์จะโหลดการถอดเสียงแบบเต็มของเอเจนต์ย่อยตามความต้องการ
รองรับชนิดขั้นตอนต่อไปนี้:
| ชนิด | คำอธิบาย |
|---|---|
| หัวข้อ | หัวข้อที่มีชื่อในรายการหัวข้อของเอเจนต์ |
| หัวข้อของระบบ | หัวข้อแพลตฟอร์มที่มีอยู่แล้วภายใน เช่น การทักทาย สำรอง หรือการเลื่อนระดับ |
| ความรู้ | ขั้นตอนการค้นหาแหล่งความรู้ |
| เครื่องมือ / การดำเนินการ | โฟลว์ Power Automate หรือการดำเนินการตัวเชื่อมต่อ |
| รหัส | ขั้นตอนการเรียกใช้โค้ด Python |
| พร้อมท์แบบกำหนดเอง | ขั้นตอนพร้อมท์ AI สร้างสรรค์แบบกำหนดเอง |
| ผู้ให้เหตุผล | ขั้นตอนการให้เหตุผลภายในที่ใช้โดยแอปพลิเคชันประสานการทำงานของระบบ |
| เซิร์ฟเวอร์ MCP | การเรียกใช้เครื่องมือโปรโตคอลบริบทของโมเดล |
| เอเจนต์ที่เชื่อมต่อ | การมอบหมายไปยังเอเจนต์ย่อยที่เชื่อมต่อ |
การเลือกขั้นตอนจะเปิดแผงรายละเอียดที่มีส่วนต่อไปนี้ ซึ่งแสดงเมื่อมีข้อมูลอยู่ในการถอดเสียง
- กระบวนการคิด: ข้อความการให้เหตุผลของแอปพลิเคชันประสานการทำงานของระบบที่บันทึกไว้ก่อนที่จะเรียกใช้ขั้นตอน แสดงให้เห็นว่าโมเดลตัดสินใจเรียกขั้นตอนนี้อย่างไรและคาดหวังอะไรจากขั้นตอนนี้
- ชนิดขั้นตอน: ป้ายชื่อจำแนกสำหรับขั้นตอน
- อาร์กิวเมนต์: มุมมองแผนผัง JSON ที่ยุบได้ของพารามิเตอร์อินพุตที่ส่งผ่านไปยังขั้นตอน มีตัวเลือกการคัดลอกเพื่อบันทึก JSON สำหรับตั๋วการสนับสนุน
- การสังเกต: ค่าเอาต์พุตหรือค่าส่งคืนจากขั้นตอน ยังแสดงเป็นแผนผัง JSON ที่ยุบได้พร้อมรองรับการคัดลอก
- ดูตัวอย่างโค้ด: สำหรับขั้นตอนโค้ด Python ซอร์สโค้ดจะแสดงพร้อมกับการเน้นไวยากรณ์
- การใช้โทเค็น: จำนวนโทเค็นพร้อมท์ จำนวนโทเค็นที่เสร็จสมบูรณ์ และผลรวมสำหรับขั้นตอน พร้อมกับชื่อโมเดลที่ใช้
- แหล่งความรู้: แหล่งที่มาที่ค้นหา ผลลัพธ์ที่ส่งคืน (ผลลัพธ์) และแหล่งที่มาที่อ้างถึงจริงในการตอบกลับขั้นสุดท้าย แต่ละรายการจะแสดงชื่อแหล่งที่มา ชนิด URL หากมี และลิงก์เพื่อเปิดแหล่งที่มา
- ข้อมูลเซิร์ฟเวอร์ MCP: สำหรับขั้นตอน MCP จะแสดงเวอร์ชันโปรโตคอลของเซิร์ฟเวอร์ ความสามารถที่ประกาศไว้ และรายการเครื่องมือที่เซิร์ฟเวอร์จัดเตรียมไว้ระหว่างการเริ่มต้น
- ข้อมูลข้อผิดพลาด: เมื่อขั้นตอนล้มเหลว จะแสดงรหัสข้อผิดพลาด ข้อความแสดงข้อผิดพลาด และ (สำหรับบล็อก AI ที่รับผิดชอบ) ประเภทความปลอดภัยของเนื้อหาที่ทริกเกอร์ตัวกรอง
- การ์ดที่ปรับเปลี่ยนได้: เมื่อขั้นตอนสร้างการตอบสนองของการ์ดที่ปรับเปลี่ยนได้การ์ดจะแสดงผลแบบอินไลน์ในแผงรายละเอียดตรงตามที่ผู้ใช้จะเห็น
JSON การถอดข้อความ
เมื่อคุณเลือก ดู JSON ในส่วนหัวของการแสดงตัวอย่างการสนทนา กล่องโต้ตอบจะเปิดขึ้นซึ่งแสดงกิจกรรมการถอดเสียงดิบแบบเต็มที่มีการเน้นไวยากรณ์ การค้นหาข้อความแบบเต็มภายในแผนผัง JSON และตัวเลือกการคัดลอกไปยังคลิปบอร์ดสำหรับเพย์โหลดทั้งหมด
ใช้มุมมองนี้เมื่อ:
- คุณต้องตรวจสอบประเภทเหตุการณ์ที่ไม่ได้ปรากฏในแผง ข้อมูลดีบัก
- คุณต้องการคัดลอกฟิลด์เฉพาะสำหรับตั๋วการสนับสนุน
- คุณกำลังตรวจสอบพฤติกรรมที่ไม่คาดคิดในมุมมองที่แยกวิเคราะห์
กำลังแก้ไขปัญหา
ส่วนต่อไปนี้จะอธิบายถึงปัญหาทั่วไปและวิธีแก้ไข
เอเจนต์ไม่ปรากฏในดรอปดาวน์สภาพแวดล้อมหรือเอเจนต์
เอเจนต์ไม่ได้ซิงค์กับคลังเอเจนต์ หรือไม่มีการถอดเสียงการสนทนาใดๆ
เพื่อแก้ปัญหานี้:
- เรียกใช้การซิงค์คลังเอเจนต์ด้วยตนเองสำหรับสภาพแวดล้อม
- ตรวจสอบว่าเรกคอร์ดเอเจนต์มีอยู่ในตารางรายละเอียดเอเจนต์ใน Dataverse
- ตรวจสอบว่าคอลัมน์ มีการถอดข้อความ ถูกตั้งค่าเป็น ใช่ ในเรกคอร์ด การซิงค์จะตั้งค่าฟิลด์นี้เมื่อมีการถอดเสียงอย่างน้อยหนึ่งรายการ
สำหรับข้อมูลเพิ่มเติม โปรดดู ตรวจสอบเอเจนต์โดยใช้คลังเอเจนต์ใน Copilot Agent Kit
ไม่พบรหัสการสนทนาในเมนูดรอปดาวน์
สำหรับประสิทธิภาพ ดรอปดาวน์จะโหลดล่วงหน้าเฉพาะการสนทนาล่าสุด 50 รายการภายในช่วงเวลาที่ใช้งานอยู่ การถอดเสียงที่เก่ากว่ายังคงมีอยู่ใน Dataverse แต่ไม่ปรากฏตามค่าเริ่มต้น อีกทางหนึ่ง อาจยังไม่ได้เขียนการถอดเสียงหากการสนทนาเพิ่งจบลง
เพื่อแก้ปัญหานี้:
- พิมพ์รหัสการสนทนาลงในฟิลด์ รหัสการสนทนา โดยตรง การพิมพ์จะทริกเกอร์การค้นหาแบบเต็มในการถอดเสียงทั้งหมดสำหรับเอเจนต์นั้น โดยไม่สนใจช่วงเวลา
- หากช่วงเวลาแคบ (เช่น 30 นาทีที่ผ่านมา) ให้ขยายหรือสลับไปยังช่วงที่กำหนดเองซึ่งครอบคลุมวันที่การสนทนา
- หากการสนทนาเพิ่งจบลง ให้รอ 35-40 นาทีเพื่อให้การถอดเสียงถูกเขียนไปยัง Dataverse จากนั้นรีเฟรช
วิเคราะห์จำนวนงานในศูนย์การผลิต แต่ไม่มีขั้นตอนปรากฏในแผงข้อมูลดีบัก
การถอดเสียงมีอยู่ แต่มีเฉพาะกิจกรรมชนิดข้อความที่ไม่มีเหตุการณ์การติดตามการวินิจฉัย ปัญหานี้มักเกิดขึ้นเมื่อการสนทนามาจากช่องทางที่ไม่ส่งข้อมูลการติดตาม เช่น ช่องทางที่กำหนดเองบางช่องทางหรือเวอร์ชัน Schema ที่เก่ากว่า
เพื่อแก้ปัญหานี้:
- เลือก ดู JSON ในส่วนหัวของการแสดงตัวอย่างการสนทนาเพื่อยืนยันว่ามีกิจกรรมอยู่
- ค้นหารายการ
type: "trace"หรือtype: "event"หากไม่มี ช่องทางอาจไม่ส่งข้อมูลการติดตาม
การเข้าถึงถูกปฏิเสธหรือหน้าว่างเปล่าเมื่อโหลด
บทบาทหรือสิทธิ์หายไปในสภาพแวดล้อมหนึ่งหรือทั้งสองสภาพแวดล้อม
เพื่อแก้ปัญหานี้:
- ในสภาพแวดล้อมชุดอุปกรณ์ ตรวจสอบว่าผู้ใช้มี Security role เป็น CSK - ผู้ดูแลระบบ หรือ ผู้ดูแลระบบ
- ในสภาพแวดล้อมเป้าหมาย ตรวจสอบให้แน่ใจว่าผู้ใช้ที่ลงชื่้อเข้าใช้มีการในการอ่านตาราง
conversationtranscripts,botและbotcomponents
ข้อความถอดเสียงดูไม่สมบูรณ์ (ไม่มีข้อความในช่วงต้น)
การสนทนาแบบยาวจะถูกแบ่งออกเป็นเรกคอร์ด Dataverse หลายรายการ (ขีดจำกัด 1 MB ต่อเรกคอร์ด) หากนโยบายการเก็บรักษาล้างระเบียนบางรายการ การถอดเสียงที่ผสานจะมีช่องว่าง
เพื่อแก้ปัญหานี้:
- Dataverse ล้างการถอดเสียงการสนทนาที่เก่ากว่า 30 วันตามค่าเริ่มต้น หากการเก็บรักษาเป็นปัญหา ให้อัปเดตกำหนดการงานลบจำนวนมากใน Power Apps>การตั้งค่า>การตั้งค่าขั้นสูง>การจัดการข้อมูล>การลบเรกคอร์ดจำนวนมาก
- ถ้าการเก็บรักษาไม่ใช่สาเหตุ ให้ตรวจสอบว่าเรกคอร์ดการถอดเสียงทั้งหมดสำหรับการสนทนามีอยู่ในตาราง
conversationtranscriptsใน Dataverse
ขั้นตอนแสดงชื่อ Schema ดิบแทนชื่อหัวข้อที่อ่านได้
การค้นหาตาราง botcomponents ล้มเหลว หรือเรกคอร์ดส่วนประกอบถูกลบ
เพื่อแก้ปัญหานี้:
- ตรวจสอบว่าผู้ใช้ที่ลงชื่อเข้าใช้มีสิทธิ์อ่านข้อมูลตาราง
botcomponentsในสภาพแวดล้อมเป้าหมาย - หากส่วนถูกลบออกจาก Copilot Studio จะไม่มีเรกคอร์ดที่ตรงกัน และเอเจนต์ดีบักเกอร์จะกลับไปใช้ชื่อ Schema ดิบ เช่น
cr123_mytopicลักษณะการทำงานนี้คาดว่าจะเกิดขึ้นสำหรับหัวข้อหรือการดำเนินการที่ถูกลบ
แผงรายละเอียดเอเจนต์ไม่แสดงข้อมูล
การดึงข้อมูลการกำหนดค่าเอเจนต์ล้มเหลว หรือการเชื่อมต่อของผู้ใช้ที่ลงชื่อเข้าใช้ไม่มีสิทธิ์อ่านตาราง bot และ botcomponents ในสภาพแวดล้อมเป้าหมาย
เพื่อแก้ปัญหานี้:
- ตรวจสอบสิทธิ์การอ่านตาราง
botและbotcomponentsสำหรับการอ้างอิงการเชื่อมต่อที่ใช้โดยแอป - หากเอเจนต์ถูกลบหรือยกเลิกการเผยแพร่หลังจากบันทึกการสนทนา เรกคอร์ดการกำหนดค่าอาจไม่มีอยู่อีกต่อไป ในกรณีนี้ แผง รายละเอียดเอเจนต์ จะยังคงว่างเปล่า แต่แผงการถอดเสียงและดีบักยังคงทำงานได้อย่างสมบูรณ์
แผงคำแนะนำไม่แสดงปัญหา แต่การสนทนาล้มเหลว
คำแนะนำมาจากรูปแบบในเหตุการณ์การติดตามการถอดเสียง ถ้าการถอดเสียงขาดข้อมูลการติดตาม หรือหากความล้มเหลวเกิดขึ้นนอกการสนทนา (ตัวอย่างเช่น การหมดเวลาของเครือข่ายแบบเงียบที่การถอดเสียงไม่ได้บันทึก) ระบบจะไม่สร้างคำแนะนำใดๆ
เพื่อแก้ปัญหานี้:
- เปิด JSON การถอดเสียงเพื่อค้นหาเพย์โหลดข้อผิดพลาดดิบที่ไม่ได้แสดงเป็นคำแนะนำ
- ตรวจสอบเส้นทางการดำเนินการสำหรับขั้นตอนที่แสดงเป็นสีแดง ขั้นตอนเหล่านี้บ่งชี้ถึงความล้มเหลวที่ไม่ได้จับคู่กับรูปแบบคำแนะนำที่ทราบ