クエリは、ダッシュボード・監査・調査の下に位置する柔軟なレイヤーです。アドホックSQLでアイデアを検証し、定期的なワークフローの一部になったらクエリを保存しましょう。
クエリの作成と実行
- Analyze → Queries に移動し、new query を選択します。
- スキーマブラウザを開き、イベント・セッション・評価データからフィールドを選びます。
- SQLを記述し、必要に応じてパラメータを追加してクエリを実行します。
- わかりやすい名前と説明を付けて保存し、結果をモニタリングしたい場合は add to dashboard を使用します。
クエリエディタはイベントスキーマ、SQL、パラメータ、結果プレビューを統合しており、保存前に問いを検証できます。
保存されたクエリは共有ライブラリに表示され、チームメンバーが再実行したり、結果をダッシュボードに追加したりできます。
SQLを開き直さなくても結果が理解できるよう、わかりやすい名前と説明を付けましょう。IDの確認には fp query list を、保存済みクエリの削除には fp query delete <query-id> を使用します。 主な用途
- 同じツールへの繰り返し呼び出しを含むセッションを検索する。
- モデルや環境をまたいで評価スコアを比較する。
- 人間の待機から再開までの時間を計測する。
- ポリシーによる拒否の後に成功した代替手段が続くケースを特定する。
- 監査用のコホートを作成する。
未知のフィールドに対してクエリを書く前に Queries → Schema を開いて確認しましょう。時間や環境のフィルタは明示的に指定し、調査中は結果件数に上限を設けることをお勧めします。
クエリは疑わしいパターンを発見できますが、それだけで障害モードが確定するわけではありません。結果をポリシーに反映する前に、代表的なトレースを開くか監査を実施してください。
