ใช้การติดตามกิจกรรมเพื่อดีบักเอเจนต์ของคุณ

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

หมายเหตุ

ฟีเจอร์ในบทความนี้ขับเคลื่อนด้วยฮาร์เนส GitHub Copilot ซึ่งใช้ Copilot Credits สําหรับการเรียกเก็บเงินตามการใช้งาน เรียนรู้เพิ่มเติมเกี่ยวกับเครดิต Copilot ในภาพรวมการเรียกเก็บเงินสําหรับเจ้าหน้าที่ที่ขับเคลื่อนด้วย GitHub Copilot harness

การเรียกเก็บเงินตามการใช้งานครอบคลุมถึงการใช้ การสร้าง การทดสอบ และการประเมินเอเจนต์ การกระทําเหล่านี้อาจใช้เครดิต Copilot

Prerequisites

• เอเจนต์ที่สร้างขึ้นด้วยฮาร์เนส GitHub Copilot
• ต้องมีการสนทนาเพื่อทดสอบอย่างน้อยหนึ่งรายการในแท็บพรีวิว

เปิดการติดตามกิจกรรม

1. เปิดเอเจนต์ของคุณใน Copilot Studio แล้วเลือกแท็บ พรีวิว

2. ตรวจสอบให้แน่ใจว่าตัวสลับ พรีวิวสำหรับผู้ใช้ ปิดอยู่ (มุมมองผู้สร้างเริ่มต้น) การติดตามกิจกรรมจะปรากฏข้างหน้าต่างแชท โดยให้รายละเอียดการประมวลผลของแต่ละข้อความ

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

ทำความเข้าใจการติดตามกิจกรรม

การติดตามกิจกรรมจะแสดงมุมมองห่วงโซ่ความคิด (CoT) ของการประมวลผลของเอเจนต์ของคุณ แต่ละขั้นตอนในการติดตามจะปรากฏเป็นโหนดที่แสดงสิ่งที่เอเจนต์ดำเนินการและสาเหตุที่ดำเนินการดังกล่าว

ชนิดโหนด

การติดตามอาจประกอบด้วยชนิดโหนดต่อไปนี้:

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

ดูรายละเอียดโหนด

1. เลือกโหนดใดก็ได้ในการติดตามเพื่อขยายรายละเอียด

2. ตรวจสอบข้อมูลที่แสดง ซึ่งอาจรวมถึง:

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

แก้ไขปัญหาแหล่งความรู้

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

1. ค้นหาโหนด ความรู้ ในการติดตาม

2. ตรวจสอบแหล่งข้อมูลเพื่อดูว่าเข้าถึงแหล่งความรู้อะไรบ้าง

3. เลือกแหล่งข้อมูลเพื่อดูเนื้อหาที่ดึงมา

4. ตรวจสอบว่าเอเจนต์ใช้แหล่งข้อมูลที่ถูกต้องและเนื้อหาที่ดึงมามีความเกี่ยวข้อง

หากเอเจนต์ใช้แหล่งข้อมูลที่ไม่ถูกต้องหรือส่งคืนข้อมูลที่ไม่ถูกต้อง ให้ตรวจสอบการกําหนดค่าความรู้ในแท็บ สร้าง

ดีบักการทำงานของเครื่องมือ

เมื่อเอเจนต์ของคุณเรียกใช้เครื่องมือ การติดตามจะแสดงรายละเอียดการดำเนินการ:

1. ค้นหาโหนด เครื่องมือ, ตัวเชื่อมต่อ, โฟลว์ หรือ ทักษะ ในการติดตาม

2. ตรวจสอบรายละเอียดการดำเนินการ รวมถึงพารามิเตอร์อินพุตและผลลัพธ์เอาต์พุต

3. ตรวจสอบว่ามีการเรียกใช้เครื่องมือที่ถูกต้องและผลลัพธ์เป็นไปตามที่คาดไว้

4. หากการดำเนินการเครื่องมือล้มเหลว ให้ตรวจสอบรายละเอียดข้อผิดพลาดในโหนด

หากต้องการกำหนดค่าเครื่องมือใหม่ ให้เปิดแท็บ สร้าง และค้นหาเครื่องมือในส่วนการกำหนดค่าของเอเจนต์ของคุณ

แก้ปัญหาข้อผิดพลาด

เมื่อเกิดข้อผิดพลาดระหว่างการประมวลผล การติดตามจะเน้นข้อผิดพลาดเหล่านั้น:

1. ตรวจสอบโหนดที่มีสัญลักษณ์ข้อผิดพลาดในการติดตาม

2. เลือกโหนดข้อผิดพลาดเพื่อดูรายละเอียดข้อผิดพลาด รวมถึงข้อความแสดงข้อผิดพลาดและบริบท

3. ปัญหาทั่วไปได้แก่

   • ความล้มเหลวในการรับรองความถูกต้องสําหรับเครื่องมือหรือตัวเชื่อมต่อ
   • ข้อผิดพลาดในการเข้าถึงแหล่งความรู้
   • ข้อผิดพลาดการหมดเวลาสําหรับการเรียกใช้เครื่องมือที่ใช้เวลานาน
   • ค่าสถานะการกลั่นกรองเนื้อหา

4. แก้ไขสาเหตุที่แท้จริงในแท็บ สร้าง หรือ การตั้งค่า แล้วทดสอบใหม่

นําทางจากการติดตามไปยังแท็บสร้าง

การติดตามกิจกรรมจะรวมเข้ากับแท็บ สร้าง เพื่อการแก้ไขอย่างรวดเร็ว

1. เลือกแหล่งข้อมูล เครื่องมือ หรือส่วนประกอบใดๆ ในการติดตาม

2. Copilot Studio ไปยังส่วนประกอบที่เกี่ยวข้องในแท็บ สร้าง

3. ทำการแก้ไขของคุณแล้วกลับไปที่แท็บ พรีวิว เพื่อทดสอบใหม่

ข้อมูลที่เกี่ยวข้อง

• ดูตัวอย่างและทดสอบตัวแทน
• ทดสอบเอเจนต์
• แชร์ตัวแทนของคุณกับผู้อื่น
• จัดการการสนทนาตัวอย่าง
• ตรวจสอบเอเจนต์