保存済みビューを作成・管理する

Weave の 保存済みビュー を使用すると、トレースされた関数の Call と評価の操作方法をカスタマイズできます。保存済みビューでフィルター、並べ替え、列の表示を設定しておけば、必要なデータにすばやくアクセスできます。また、毎回設定をやり直さなくても、自分やチームのメンバーが同じ条件で絞り込んだトレースや評価をいつでも表示できます。ビューは、UI から、または Weave Python SDK から直接作成、変更、保存できます。UI では Traces タブと Evals タブでさまざまな表の設定を試して保存できます。一方、Python SDK では、プログラムによるフィルタリングやクエリをきめ細かく制御できます。ワークフローに合ったタブを選択してください。

UI
Python

Weights & Biases の UI では、保存済みビューの作成、読み込み、リネーム、編集を行えます。その場で調整した表の設定を再利用可能なビューとして取得するには、UI を使用するのが最も手軽です。プログラムで制御する場合は、Python タブを選択してください。

保存済みビューを作成する

Traces タブまたは Evals タブにアクセスします。
表の設定で、次のいずれかの項目を調整します。
- フィルター
- 並べ替えの順序
- ページサイズ
- 列の可視性
- 列の固定
次のいずれかの方法でビューを保存します。
- 右上にある Save view をクリックします。
- Save view の左にある menu () ボタンをクリックし、ドロップダウンメニューで + Save as new view をクリックします。

保存済みビューを読み込む

Traces タブまたは Evals タブにアクセスします。
タブのタイトルの左にある menu () ボタンをクリックします。すべての保存済みビューを一覧表示するドロップダウンメニューが表示されます。
開きたいビューをクリックします。Traces タブまたは Evals タブに保存済みビューが表示されます。

保存済みビューをリネームする

保存済みビューを読み込むの手順に従います。
Traces タブまたは Evals タブの左上にあるビュー名をクリックします。
ビューの新しい名前を入力します。
Enter キーを押して、新しいビュー名を保存します。

保存済みビューを編集する

保存済みビューを読み込むの手順に従います。
表の設定を調整します。
右上にある Save view をクリックします。

保存済みビューを削除する

自分やチームにとって不要になったビューは削除できます。この操作は元に戻せません。

Traces タブまたは Evals タブにアクセスします。
削除するビューを読み込みます。
Save view の左にある menu () ボタンをクリックします。
ドロップダウンメニューで Delete view をクリックします。
ポップアップモーダルで Delete view をクリックして確定します。削除を中止する場合は、Cancel をクリックします。

デフォルトのビューに戻す

Traces タブまたは Evals タブにアクセスします。
Traces タブまたは Evals タブの右にある menu () ボタンをクリックします。すべての保存済みビューを一覧表示するドロップダウンメニューが表示されます。
メニューの下部にある Traces または Evals をクリックします。デフォルトのビューが表示されます。

Weave の SavedView クラスを使用すると、トレースデータや評価データのビューを保存、フィルター、並べ替え、カスタマイズできます。以下のセクションでは、ビューの初期化、列とフィルターの設定、そして条件に一致する Call を後で取得できるようにするためのビューの永続化について、順を追って説明します。

`SavedView` を初期化する

Weave プロジェクトで SavedView インスタンスを初期化します：

import weave
client = weave.init("[MY_PROJECT]")

view = weave.SavedView()

`SavedView` をグリッド形式で可視化する

.to_grid() を使用すると、保存済みビューをグリッド形式で表示できます。表示する最大行数は limit で指定します。

view.to_grid(limit=5)

.show() を使用して、グリッド表現を表示します。

view.to_grid().show()

表示する列を設定する

.set_columns() を使用して、ビューに表示する列を設定します。表示する列を 1 つ以上指定します。

view.set_columns("id", "op_name")

列を追加する

ビューに新しい列を追加するには、.add_column() を使用します。追加する列を 1 つ以上指定します。

# フィールド指定子とラベルが "Created" の列を追加します
view.add_column("Created")
# 必要に応じて 2 番目の引数を渡すと、新しい列に別のラベル名を指定できます。デフォルトでは、フィールド指定子がラベルとして使用されます。

列を並べ替える

特定の列を基準に結果を並べ替えるには、.sort_by() を使用します。並べ替えの対象とする列名と、並べ替えの順序 (asc または desc) を指定します。

view.sort_by("started_at", "desc")

操作名でフィルターする

Weave では、すべてのトレースと評価が操作名に関連付けられています。 .filter_op() を使用すると、SavedView をフィルターして、特定の操作が実行された Call のみに絞り込むことができます。

view.filter_op("Evaluation.predict_and_score")

オペレーターと条件でフィルターする

.add_filter() を使用して、ビューにカスタムフィルターを適用します。フィルターは、サポートされるフィルターオペレーターのいずれかと条件を組み合わせて定義します。

view.add_filter("output.model_latency", ">=", 5)

フィルターのオペレーター

オペレーター	説明	例
`"contains"`	string に部分文字列が含まれているかを確認します。	`view.add_filter("output.status", "contains", "error")`
`"equals"`	string が指定された値と完全に一致するかを確認します。	`view.add_filter("input.category", "equals", "Alice")`
`"in"`	string が値のリストに含まれているかを確認します。	`view.add_filter("category", "in", ["A", "B", "C"])`
`"="`	数値が指定された値と等しいかを確認します。	`view.add_filter("output.score", "=", 80)`
`"≠", "!="`	数値が指定した値と等しくないかどうかを確認します。	`view.add_filter("metrics.loss", "!=", 0.5)`
`"<"`	数値が指定した値より小さいかどうかを確認します。	`view.add_filter("age", "<", 30)`
`"≤", "<="`	数値が指定した値以下かどうかを確認します。	`view.add_filter("metric.value", "<=", 100)`
`">"`	数値が指定した値より大きいかどうかを確認します。	`view.add_filter("output.score", ">", 90)`
`"≥", ">="`	数値が指定した値以上かどうかを確認します。	`view.add_filter("output.model_latency", ">=", 5)`
`"is"`	ブール型フィールドが `True` か `False` かを確認します。	`view.add_filter("is_active", "is", True)`
`"after"`	日付が指定のタイムスタンプより後かどうかを確認します。	`view.add_filter("started_at", "after", "2024-01-01")`
`"before"`	日付が指定のタイムスタンプより前かどうかを確認します。	`view.add_filter("ended_at", "before", "2024-12-31")`
`"is empty"`	フィールドが空 (`None` または `""`) かどうかを判定します。	`view.add_filter("comments", "is empty", None)`
`"is not empty"`	フィールドが空でないかどうかを確認します。	`view.add_filter("attachments", "is not empty", None)`

フィルターを削除する

.remove_filter() を使用すると、インデックスまたはフィールド名を指定して、ビューから特定のフィルターを削除できます。

view.remove_filter("output.model_latency")

すべてのフィルターを削除するには、.remove_filters() を使用します。

view.remove_filters()

`SavedView` を保存する

.save() を使用して、保存済みビューを Weave にパブリッシュします。

view.save()

関数の Call を取得する

.get_calls() を使用すると、保存済みビューのフィルターに一致する関数の Call を取得できます。limit や offset などの任意のパラメーターも指定できます。

calls = view.get_calls(limit=10)

​保存済みビューを作成する

​保存済みビューを読み込む

​保存済みビューをリネームする

​保存済みビューを編集する

​保存済みビューを削除する

​デフォルトのビューに戻す

​SavedView を初期化する

​SavedView をグリッド形式で可視化する

​表示する列を設定する

​列を追加する

​列を並べ替える

​操作名でフィルターする

​オペレーターと条件でフィルターする

​フィルターのオペレーター

​フィルターを削除する

​SavedView を保存する

​関数の Call を取得する

保存済みビューを作成する

保存済みビューを読み込む

保存済みビューをリネームする

保存済みビューを編集する

保存済みビューを削除する

デフォルトのビューに戻す

`SavedView` を初期化する

`SavedView` をグリッド形式で可視化する

表示する列を設定する

列を追加する

列を並べ替える

操作名でフィルターする

オペレーターと条件でフィルターする

フィルターのオペレーター

フィルターを削除する

`SavedView` を保存する

関数の Call を取得する