00 Thiết lập

Tài liệu hội thảo được duy trì trong kho lưu trữ langfuse/langfuse-workshop công khai. Sử dụng kho lưu trữ cho ứng dụng có thể chạy, nhánh điểm kiểm tra và thiết lập cục bộ.

Xem tệp Markdown này

Hướng dẫn học viên: 00 Thiết lập

Ghi chú hướng dẫn viên

• Sử dụng checkpoint/00-setup làm kiểm tra base-app ổn định. Nó phải tương đương với checkpoint/01-base-app, không phải là ứng dụng tham khảo hoàn chỉnh.
• main chứa triển khai tham khảo hoàn chỉnh, nhưng học viên nên sử dụng điểm kiểm tra để thiết lập và định hướng base-app chia sẻ cùng một trạng thái bắt đầu.
• Làm cho học viên xác nhận cả hai dịch vụ cục bộ: Vite trên 127.0.0.1:3333 và API Express trên 127.0.0.1:8787/api/health hoặc 127.0.0.1:8787/api/support-context.
• Nhấn mạnh giá trị máy chủ Langfuse EU: LANGFUSE_BASE_URL=https://cloud.langfuse.com.
• Server Node và các tập lệnh trợ giúp tải kho lưu trữ .env với ghi đè được bật, vì vậy các giá trị LANGFUSE_*, OPENAI_* hoặc DATASET_NAME lỗi thời được xuất từ ​​một dự án cục bộ khác không nên thắng. Có học viên chỉnh sửa .env khi họ cần chuyển đổi khóa hoặc dự án.
• Không tải trước Cài đặt Dự án → Kết nối LLM tại đây. Học viên cấu hình mô hình đánh giá mặc định trong 04-monitoring, khi đánh giá LLM-as-a-judge lần đầu tiên trở nên liên quan.
• Giữ xử lý khóa rõ ràng: các khóa API thực chỉ đi vào .env hoặc các trường bí mật Langfuse, không bao giờ vào các bảng điểm chia sẻ, ghi chú hoặc trò chuyện.
• Sau một lần quay chat thành công, hãy có học viên chuyển sang checkpoint/02-tracing cho bước xây dựng đầu tiên.

Chú ý

• Thiếu giá trị .env. Ứng dụng có thể hiển thị trong khi các cuộc gọi mô hình không thành công.
• Node cũ hơn ^20.19.0 || >=22.12.0. Đáng để node -v kiểm tra trong phòng trước khi ai đó chạy npm install, vì npm bỏ qua nhị phân tệp tùy chọn của Vite im lặng và lỗi chỉ xuất hiện sau trong npm run dev. Học viên nâng cấp sau đó cần npm ci, không chỉ khởi động lại.
• Những người kiểm tra 127.0.0.1:8787/ trong dev. Server API chạy trên cổng đó, nhưng ứng dụng trình duyệt được cung cấp bởi Vite trên 127.0.0.1:3333, vì vậy hãy sử dụng tuyến đường API để kiểm tra máy chủ. Nó cũng ẩn một Vite bị lỗi: concurrently giữ cho máy chủ API hoạt động và 8787/ trả lời bằng ENOENT ... dist/index.html.
• Học viên chỉnh sửa xuất shell thay vì .env. Hội thảo có chủ đích coi .env là nguồn sự thật cạnh Node.
• Những người mong đợi thiết lập đánh giá trong quá trình thiết lập ban đầu. Ứng dụng có thể chạy và tracing chính xác trước khi kết nối LLM cạnh Langfuse tồn tại.
• Những người mong đợi traces trên checkpoint/00-setup hoặc checkpoint/01-base-app. Cả hai đều có chủ đích không có trace; tracing chỉ bắt đầu sau các chỉnh sửa 02-tracing.
• Những người ở lại main để tracing. main đã là triển khai tham khảo hoàn thành.