00 セットアップ
学習者ガイド: 00 セットアップ
ワークショップ資料は公開されている langfuse/langfuse-workshop リポジトリで管理されています。実行可能なアプリケーション、チェックポイント ブランチ、ローカル セットアップはリポジトリを参照してください。
学習者ガイド: 00 セットアップ
インストラクター ノート
checkpoint/00-setupを安定したベース アプリ チェックアウトとして使用してください。これはcheckpoint/01-base-appと同等である必要があり、完全なリファレンス アプリではありません。mainには完全なリファレンス実装が含まれていますが、学習者はチェックポイントを使用する必要があるため、セットアップとベース アプリのオリエンテーションは同じ開始状態を共有します。- 学習者に両方のローカル サービスを確認させてください:
127.0.0.1:3333の Vite、および127.0.0.1:8787/api/healthまたは127.0.0.1:8787/api/support-contextの Express API。 - EU Langfuse ホスト値を強調してください:
LANGFUSE_BASE_URL=https://cloud.langfuse.com。 - Node サーバーとヘルパー スクリプトはリポジトリ
.envを上書き有効で読み込むため、別のローカル プロジェクトからエクスポートされた古いLANGFUSE_*、OPENAI_*、またはDATASET_NAME値は効果がありません。学習者がキーを切り替える必要がある場合は.envを編集するよう指示してください。 - ここで Project Settings → LLM Connections をフロントロードしないでください。学習者は
04-monitoringで、LLM に基づく評価器が最初に関連するようになったときに、デフォルトの評価器モデルを設定します。 - キー処理を明示的にしてください: 実際の API キーは
.envまたは Langfuse シークレット フィールドのみに移動し、共有トランスクリプト、ノート、チャットには移動しません。 - 1 回のチャット ターンの後、学習者を
checkpoint/02-tracingに切り替えて最初のビルド ステップを実行させてください。
注視する点
.env値がない場合。アプリはレンダリングされますが、モデル呼び出しが失敗する可能性があります。^20.19.0 || >=22.12.0より古い Node。セッション開始前に部屋でnode -vチェックを実行する価値があります。npm installを実行する際は、npm が Vite のオプション ネイティブ バイナリをサイレント スキップし、失敗が後でnpm run devの内部でのみ表示されるため。その後アップグレードする学習者はnpm ciが必要ですが、単なる再起動ではありません。127.0.0.1:8787/を開発で確認する人。API サーバーはそのポートで実行されますが、ブラウザ アプリは127.0.0.1:3333の Vite によって提供されるため、サーバーチェック用に API ルートを使用してください。これは壊れた Vite も隠します:concurrentlyは API サーバーを稼働状態に保ち、8787/はENOENT ... dist/index.htmlで応答します。- 学習者が
.envの代わりにシェル エクスポートを編集する場合。ワークショップは意図的に.envを Node 側の情報源として扱っています。 - 初期セットアップ中に評価器のセットアップが予想される人。Langfuse 側の LLM 接続が存在する前に、アプリは正しく実行およびトレースできます。
checkpoint/00-setupまたはcheckpoint/01-base-appのトレースが期待される人。両方とも意図的にトレースされていません。トレーシングは02-tracing編集後にのみ開始します。mainでトレーシングを行ったままになっている人。mainはすでに完成したリファレンス実装です。