finding-experiments

実験を探す

ユーザーは実験を ID ではなく、名前、説明、相対的な参照で指定します。 このスキルは、自然言語による参照を具体的な実験 ID に解決します。

実験の探し方

Posthog-local MCP サーバーの experiment-list ツールを使用します。

重要：実験を探すために feature-flag-get-all や機能フラグのツールは使用しないでください。 専用の実験リストツール experiment-list を使用します。

このツールは、id、name、status、feature_flag_key、start_date、end_date、created_at を含む実験を返します。返されたリストを確認し、ユーザーの参照に一致する実験を探します。

• 名前で探す場合：name フィールドを確認して、一致するものを探します
• 新しさで探す場合：結果はデフォルトで新しい順に並んでいます
• ステータスで探す場合：status フィールド（draft、running、paused、exposure_frozen、stopped）で照合します
• フラグキーで探す場合：リストの確認を省略し、キーを指定して experiment-get-by-flag-key を呼び出します。実験全体が返されるか、found: false と reason が返されます。no_flag と no_experiment は、そのキーが空いていることを意味するため、これは experiment-create の前に実行する存在確認にもなります。ambiguous は、複数の実験で同じフラグが共有されていて、稼働中のものが 1 つに定まらないことを意味します。candidates を表示し、別の実験を作成する代わりに experiment-get で 1 つを選びます。
• 一部のフラグキーで探す場合：search に一部の文字列を指定して experiment-list を呼び出します。search は、大文字と小文字を区別せず、実験名とフラグキーに含まれる部分文字列を照合します。

一致する実験が見つかった場合

• 一致が 1 件の場合：その実験を使用します。破壊的な操作（削除、公開、終了）の前に、名前をユーザーに確認します。
• 複数一致する場合：名前、ステータス、作成日を一覧表示します。ユーザーに選択を依頼します。
• 一致しない場合：ユーザーにその旨を伝えます。アーカイブ済みの実験や別の用語を確認するよう提案します。

必要に応じて詳細を取得する

ID を特定したら、完全なオブジェクト（メトリクス、フラグの詳細、パラメーター）を取得するために experiment-get を呼び出します。

例

User: "pause my signup experiment"

Agent:
1. Calls experiment-list
2. Scans results, finds "New signup process" (ID: 1371, status: running)
3. Proceeds to pause experiment 1371

検索しない場合

• 会話の前の段階ですでに実験 ID を取得している場合
• ユーザーが実験を作成した直後で、作成時の応答から ID を取得している場合
• ユーザーが ID を直接指定した場合

関連スキル

• managing-experiment-lifecycle — ID の特定後に実験を操作します
• diagnosing-experiment-health — 見つかった実験を調査します