メインコンテンツへスキップ
これはインタラクティブなノートブックです。ローカルで実行するか、以下のリンクを利用できます。

Weave で統合する: 本番ダッシュボード

このノートブックでは、Weave の API と関数を使用して、Weave の Traces ビューの拡張として、本番モニタリング向けのカスタム ダッシュボードを作成する方法を説明します。このガイドは、本番環境で LLM アプリケーションを運用しており、デフォルトの Traces ビューだけでは得られないパフォーマンス、コスト、ユーザー フィードバックを、用途に合わせて可視化したい開発者や ML エンジニアを対象としています。このノートブックでは、次の内容に重点を置きます。
  • Weave からトレース、コスト、フィードバック、その他のメトリクスを取得する。
  • ユーザー フィードバックとコスト分布の集約ビューを作成する。
  • トークン使用量とレイテンシの時系列可視化を作成する。
このノートブックを終えるころには、Weave プロジェクトのトレース データ、コスト、フィードバックを単一のビューに集約した、実際に使えるカスタム ダッシュボードが完成します。streamlit をインストールして production dashboard script を実行すれば、ご自身の Weave プロジェクトでこのダッシュボードを試せます。 Weave を使用した本番ダッシュボードの例

セットアップ

まず、以下のパッケージをインストールします。

実装

以下のセクションでは、Weave クライアントの初期化、call データの取得、ダッシュボード用の可視化の生成について順を追って説明します。

Weave クライアントを初期化してコストを定義する

まず、Weave クライアントを初期化し、各モデルのコストを追加する関数を設定します。この手順は、後続のコストクエリで各 Call のトークン単価を適切に対応付けるために必須です。 W&B には多くの一般的なモデル向けの標準コストが含まれており、独自のカスタムコストやカスタムモデルを追加することもできます。次の例では、いくつかのモデルにカスタムコストを追加し、それ以外には標準コストを使用する方法を示します。 コストは、Weave で各 Call についてトラッキングされたトークン数に基づいて計算されます。多くの LLM ベンダーのライブラリでは、Weave がトークン使用量を自動的にトラッキングしますが、任意の Call に対してカスタムのトークン数を返すこともできます。カスタムモデルのトークン数とコスト計算の定義方法について詳しくは、custom cost cookbookを参照してください。

Weave から Call データを取得する

クライアントを初期化し、コストを設定したら、次のステップは Weave から Call データを取得することです。Call データを取得する方法は 2 つあります。
  • Call ごとにデータを取得する
  • 高レベル API を使用する
以下のセクションでは、それぞれの方法について説明します。

データを Call ごとに取得する

Weave からデータにアクセスする最初の方法は、フィルターされた Call のリストを取得し、必要なデータを Call ごとに抽出することです。これを行うには、calls_query_stream API を使用して Weave から Call データを取得します。
  • calls_query_stream API: Weave から Call データを取得する API です。
  • filter dictionary: Call データを取得するためのフィルター パラメーターを含む辞書です。詳しくは、CallSchema リファレンスを参照してください。
  • expand_columns list: Call データ内で展開する列を含むリストです。
  • sort_by list: Call データの並べ替えパラメーターを含むリストです。
  • include_costs boolean: Call データにコストを含めるかどうかを示す真偽値です。
  • include_feedback boolean: Call データにフィードバックを含めるかどうかを示す真偽値です。
Weaveからの戻り値を使ってCallを処理します。関連する情報を抽出し、辞書のリストに格納します。次に、その辞書のリストを pandas DataFrame に変換して返します。

高レベル API の使用

個々のcallをすべて確認する代わりに、Weave にはモデルのコスト、フィードバック、そのほかのメトリクスに直接アクセスできる高レベル API も用意されています。 たとえばコストについては、query_costs API を使用して、プロジェクト内で使用されているすべての LLM のコストを取得します。

入力データを集約して可視化を生成する

Call データとコストを DataFrame として利用できるため、plotly を使って可視化を生成できます。これは用途に応じて自由にカスタマイズできる、出発点となるダッシュボードです。より高度な例については、knowledge-worker-weave リポジトリ内の Streamlit の例を参照してください。

結論

このクックブックでは、Weave の API と関数を使用して、カスタムの本番モニタリング ダッシュボードを作成する方法を紹介しました。Weave は、高速なインテグレーションによってデータの取り込みを効率化するとともに、カスタム プロセス向けにデータを抽出できることに重点を置いています。
  • データ入力:
    • @weave-op() デコレータによるフレームワーク非依存のトレースと、CSV から Call をインポートするオプション (関連する import cookbook を参照してください) 。
    • さまざまなプログラミング フレームワークや言語から Weave にログするための Service API endpoint。詳細は Service API リファレンス を参照してください。
  • データ出力:
    • データを CSV、TSV、JSONL、または JSON 形式でダウンロードできます。詳細は Service API リファレンス を参照してください。
    • データへのプログラムによるアクセスを使用してエクスポートします。このクックブックで説明したように、エクスポート パネルの「Use Python」セクションを参照してください。詳細は Querying and exporting calls を参照してください。
このカスタム ダッシュボードは、Weave に標準搭載されている Traces ビューを拡張し、本番環境の LLM アプリケーションを用途に応じてモニタリングできるようにします。より複雑なダッシュボードについては、agent-dev-collection リポジトリの Streamlit example を確認してください。ここでは独自の Weave プロジェクト URL を追加できます。