02 การติดตาม

เอกสารเวิร์กชอปนี้รักษาไว้ในที่เก็บข้อมูลสาธารณะ langfuse/langfuse-workshop ใช้ที่เก็บข้อมูลสำหรับแอปที่รันได้ สาขา checkpoint และการตั้งค่าในเครื่อง

ดูไฟล์ Markdown นี้

แนวทางผู้เรียน: 02 Tracing

หมายเหตุผู้สอน

• สอนความก้าวหน้าในสามชั้นที่มองเห็นได้: OpenAI generations, agent root หนึ่งตัว จากนั้น tool observations
• เก็บการเปลี่ยนแปลงโค้ดให้เล็กและในท้องถิ่น จุดประสงค์คือการแสดงให้เห็นว่า Langfuse ห่อขอบเขตแอปที่มีอยู่แทนการบังคับให้เขียนสถาปัตยกรรมใหม่
• ส่วน user/session propagation เป็นทางเลือกสดใจ แต่ checkpoints ภายหลังรวมไว้ดังนั้นบทต่อไปจึงมี attribution ที่มีอยู่

จังหวะการสาธิต

1. เพิ่ม LangfuseSpanProcessor และ observeOpenAI รันหนึ่ง turn ถัดเรียงแสดง generation traces ที่แยกต่างหาก
2. ห่อ runSupportConversationInner ด้วย observe(...) รันอีกครั้ง แสดง generations ที่ซ้อนกัน
3. ห่อ local tool helpers ทั้งสอง รันอีกครั้ง แสดง tree แบบเต็ม

ต้องระวัง

• บางครั้งภาชนะพื้นที่ว่างโดยรอบ dad-it-support-chat-turn ขวาหลัง Step 2 รีเฟรชครั้งหนึ่งก่อนที่จะกำหนดให้เป็น code bug ถ้ามันอยู่ทุกครั้ง ให้ตรวจสอบสำหรับตัวห่อติดตามพิเศษโดยอุบัติเหตุเกิน observe(...) เดี่ยว ในบทเรียน
• ผู้เรียนห่อ OpenAI client ในโรงงานแยก เวิร์กชอป โดยเจตนา เก็บตัวห่ออยู่ข้างใน
• ผู้เรียนวาง Step 3 block ด้านบน executeTool ที่มีอยู่แทนที่จะแทนที่มัน เซิร์ฟเวอร์ออกด้วย Multiple exports with the same name "executeTool" สำเนาที่เหลือนั้นไกลขึ้นไป tools.ts
• ล้างการ shutdown หายไป ใน index.ts traces สามารถมาสายได้หากปราศจากมัน