00 Penyiapan

Materi workshop dikelola dalam repositori publik langfuse/langfuse-workshop. Gunakan repositori untuk aplikasi yang dapat dijalankan, cabang checkpoint, dan pengaturan lokal.

Lihat file Markdown ini

Panduan pelajar: 00 Pengaturan

Catatan instruktur

• Gunakan checkpoint/00-setup sebagai checkout aplikasi-dasar yang stabil. Seharusnya setara dengan checkpoint/01-base-app, bukan aplikasi referensi lengkap.
• main berisi implementasi referensi lengkap, tetapi pelajar harus menggunakan checkpoint sehingga orientasi pengaturan dan aplikasi-dasar berbagi status awal yang sama.
• Buat pelajar mengkonfirmasi kedua layanan lokal: Vite di 127.0.0.1:3333, dan API Express di 127.0.0.1:8787/api/health atau 127.0.0.1:8787/api/support-context.
• Tekankan nilai host Langfuse EU: LANGFUSE_BASE_URL=https://cloud.langfuse.com.
• Server Node dan skrip pembantu memuat repositori .env dengan override diaktifkan, jadi LANGFUSE_*, OPENAI_*, atau DATASET_NAME nilai yang diekspor usang dari proyek lokal lain tidak harus menang. Buat pelajar mengedit .env ketika mereka perlu mengganti kunci atau proyek.
• Jangan muat di depan Project Settings → LLM Connections di sini. Pelajar mengonfigurasi model evaluator default di 04-monitoring, ketika evaluator berbasis LLM pertama kali menjadi relevan.
• Jaga penanganan kunci tetap eksplisit: kunci API nyata hanya masuk ke .env atau bidang rahasia Langfuse, tidak pernah ke transkrip bersama, catatan, atau chat.
• Setelah satu putaran obrolan yang berhasil, buat pelajar beralih ke checkpoint/02-tracing untuk langkah pembangunan pertama.

Perhatikan

• .env nilai yang hilang. Aplikasi dapat dirender saat panggilan model gagal.
• Node lebih tua dari ^20.19.0 || >=22.12.0. Layak node -v periksa di ruangan sebelum siapa pun menjalankan npm install, karena npm melewatkan biner asli opsional Vite secara diam-diam dan kegagalan hanya muncul nanti di dalam npm run dev. Pelajar yang meningkatkan setelahnya perlu npm ci, bukan hanya restart.
• Orang memeriksa 127.0.0.1:8787/ di dev. Server API berjalan di port itu, tetapi aplikasi browser disajikan oleh Vite di 127.0.0.1:3333, jadi gunakan rute API untuk pemeriksaan server. Ini juga menyembunyikan Vite yang mogok: concurrently membuat server API tetap aktif, dan 8787/ menjawab dengan ENOENT ... dist/index.html.
• Pelajar mengedit ekspor shell alih-alih .env. Workshop sengaja memperlakukan .env sebagai sumber kebenaran Node-side.
• Orang mengharapkan pengaturan evaluator selama pengaturan awal. Aplikasi dapat berjalan dan melacak dengan benar sebelum koneksi LLM Langfuse-side ada.
• Orang mengharapkan jejak di checkpoint/00-setup atau checkpoint/01-base-app. Keduanya sengaja tidak dilacak; pelacakan dimulai hanya setelah 02-tracing mengedit.
• Orang tetap di main untuk pelacakan. main sudah merupakan implementasi referensi yang selesai.