00 การตั้งค่า

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

ดูไฟล์ Markdown นี้

แนวทางผู้เรียน: 00 Setup

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

• ใช้ checkpoint/00-setup เป็นการ checkout base-app ที่เสถียร มันควรจะเทียบเท่ากับ checkpoint/01-base-app ไม่ใช่แอปอ้างอิงที่สมบูรณ์
• main มีการใช้งาน reference ที่สมบูรณ์ แต่ผู้เรียนควรใช้ checkpoint ดังนั้น setup และ base-app orientation จึงแชร์สถานะเริ่มต้นเดียวกัน
• ให้ผู้เรียนยืนยันบริการในเครื่องทั้งสอง: Vite บน 127.0.0.1:3333 และ Express API บน 127.0.0.1:8787/api/health หรือ 127.0.0.1:8787/api/support-context
• เน้นค่า EU Langfuse host: LANGFUSE_BASE_URL=https://cloud.langfuse.com
• เซิร์ฟเวอร์ Node และสคริปต์ helper โหลด repository .env โดยเปิดใช้งานการลบล้าง ดังนั้น LANGFUSE_* ที่ส่งออกแบบเก่า OPENAI_* หรือ DATASET_NAME ค่าจากโครงการท้องถิ่นอื่นไม่ควรถูกใช้งาน ให้ผู้เรียนแก้ไข .env เมื่อพวกเขาต้องการสลับกุญแจหรือโครงการ
• อย่าให้น้ำหนักมากกับ Project Settings → LLM Connections ที่นี่ ผู้เรียนกำหนดค่ารุ่นตัวประเมิน default ใน 04-monitoring เมื่อตัวประเมิน LLM-as-a-judge เริ่มเกี่ยวข้อง
• รักษาการจัดการกุญแจให้ชัดเจน: กุญแจ API จริงไป เฉพาะเข้า .env หรือฟิลด์ความลับ Langfuse ไม่เคยลงในสคริปต์ที่ใช้ร่วมกัน หมายเหตุ หรือแชท
• หลังจากการเปิดแชทสำเร็จหนึ่งครั้ง ให้ผู้เรียนสลับไปที่ checkpoint/02-tracing สำหรับขั้นตอนการสร้างแรก

ต้องระวัง

• .env ค่า หายไป แอปอาจแสดงผลในขณะที่การโทรรุ่นจะล้มเหลว
• Node เก่ากว่า ^20.19.0 || >=22.12.0 มูลค่า node -v ตรวจสอบในห้องก่อนให้ใครบางคนรัน npm install เพราะ npm ข้ามไฟล์ไบนารีดั้งเดิมเสริมของ Vite อย่างเงียบและความล้มเหลวจะปรากฏเฉพาะภายใน npm run dev ผู้เรียนที่อัปเกรดหลังจากนั้นต้องการ npm ci ไม่ใช่เพียงการรีสตาร์ท
• คนตรวจสอบ 127.0.0.1:8787/ ในการพัฒนา API server ทำงานบนพอร์ตนั้น แต่แอปเบราว์เซอร์ถูกให้บริการโดย Vite บน 127.0.0.1:3333 ดังนั้นให้ใช้ API route สำหรับการตรวจสอบเซิร์ฟเวอร์ นอกจากนี้ยังซ่อน Vite ที่ขัดข้อง: concurrently ให้เซิร์ฟเวอร์ API สตาร์ทขึ้น และ 8787/ ตอบสนองด้วย ENOENT ... dist/index.html
• ผู้เรียนแก้ไขการส่งออกเชลล์แทน .env เวิร์กชอป โดยเจตนา ถือ .env เป็นแหล่งที่มาที่เชื่อถือได้ด้าน Node
• คนคาดว่า checkpoint/00-setup การตั้งค่าในระหว่างการตั้งค่าเริ่มต้น แอปสามารถรันและติดตามได้อย่างถูกต้องก่อน checkpoint/01-base-app Langfuse-side LLM connection มีอยู่
• คนคาดว่า traces บน 02-tracing หรือ main ทั้งสองไม่มีการติดตาม โดยเจตนา การติดตามเริ่มต้นเท่านั้นหลังจาก main edits
• คนอยู่บน สำหรับการติดตาม ถูกเสร็จแล้ว reference implementation