02 トレーシング

ワークショップ資料は公開されている langfuse/langfuse-workshop リポジトリで管理されています。実行可能なアプリケーション、チェックポイント ブランチ、ローカル セットアップはリポジトリを参照してください。

このマークダウン ファイルを表示

学習者ガイド: 02 トレーシング

インストラクター ノート

• 3 つの可視レイヤーで進行を教えてください: OpenAI の生成、1 つのエージェント ルート、次にツール オブザーベーション。
• コードの変更を小さく局所的に保ってください。ポイントは、Langfuse が既存のアプリ バウンダリーをラップしており、アーキテクチャの書き直しを強制していないことを示すことです。
• ユーザー/セッション伝播セクションはライブではオプションですが、後のチェックポイントに含まれているため、次の章には属性が利用可能です。

デモ リズム

1. LangfuseSpanProcessor と observeOpenAI を追加し、1 ターン実行し、別々の生成トレースを表示します。
2. runSupportConversationInner を observe(...) でラップし、もう一度実行し、ネストされた生成を表示します。
3. 2 つのローカル ツール ヘルパーをラップし、もう一度実行し、完全なツリーを表示します。

注視する点

• ステップ 2 の直後に dad-it-support-chat-turn の周りに不慮の空白の親コンテナーが時々発生します。これをコード バグと見なす前に一度リフレッシュしてください。毎ターン継続する場合、単一の observe(...) を超えた偶発的な余分なトレーシング ラッパーをチェックしてください。
• 学習者が別個のファクトリーで OpenAI クライアントをラップする場合。ワークショップは意図的にラッパーをインラインで保ちます。
• 学習者がステップ 3 ブロックを既存の executeTool の上に貼り付ける代わりに置き換える場合。サーバーは Multiple exports with the same name "executeTool" で終了します。古いコピーはさらに下の tools.ts にあります。
• index.ts でシャットダウン フラッシュが不足している場合。それなしではトレースが遅く到着する場合があります。