arize-link

Arize リンク

プロジェクト、トレース、スパン、セッション、データセット、実験、ラベリングキュー、評価器、アノテーション設定への Arize UI のディープリンクを生成します。

使用するタイミング

• プロジェクト、トレース、スパン、セッション、データセット、ラベリングキュー、評価器、アノテーション設定へのリンクを求められた場合
• エクスポートしたデータやログから ID を取得しており、UI に戻るリンクが必要な場合
• 上記のいずれかを Arize で「開く」または「表示する」よう求められた場合

必要な入力

ユーザー、コンテキスト（エクスポートしたトレースデータまたは解析した URL）、または ax CLI から取得します。

常に必要	リソース固有
org_id（base64）	project_id + trace_id [+ span_id] — トレース／スパン
space_id（base64）	project_id + session_id — セッション
	dataset_id — データセット
	dataset_id + experiment_id（1 つ以上）— 実験または比較
	experiment_id — データセットなしの実験
	queue_id — 特定のキュー（一覧の場合は省略）
	evaluator_id [+ version] — 評価器

組織 ID とプロジェクト ID の確認

CLI で取得できる ID をユーザーに尋ねるよりも、CLI の使用を優先してください。

ax organizations list --output json

組織 ID には .organizations[].id を使用します。複数の組織が返された場合は、ユーザーが指定した組織名と照合するか、選択するよう尋ねてください。

プロジェクト ID を確認するには、該当するスペース内のプロジェクトを一覧表示します。

ax projects list --space "{space_name_or_id}" --limit 100 --output json

一致するプロジェクトの id を使用します。その space_id が URL に必要なスペース ID になります。このコマンドはスペース名または ID を受け付けます。スペースが不明な場合は、ax projects list --limit 100 --output json を実行し、一致するプロジェクトを選択してください。

実験 ID を確認するには、データセット上の実験を一覧表示します。各実験には id と dataset_id があります。

ax experiments list --dataset "{dataset_name_or_id}" --space "{space_name_or_id}" --output json

パス ID はすべて base64 でエンコードする必要があります（使用文字：A-Za-z0-9+/=）。数値の ID をそのまま使用すると、有効に見えても 404 になる URL が生成されます。ユーザーから数値が提示された場合は、Arize のブラウザー URL（https://app.arize.com/organizations/{org_id}/spaces/{space_id}/…）から ID を直接コピーするよう依頼してください。内部 ID（例：Organization:1:abC1）がある場合は、URL に挿入する前に base64 でエンコードしてください。

URL テンプレート

ベース URL：https://app.arize.com（オンプレミス環境では上書き）

プロジェクト：

{base_url}/organizations/{org_id}/spaces/{space_id}/projects/{project_id}

トレース（特定のスパンを強調表示するには &selectedSpanId={span_id} を追加）：

{base_url}/organizations/{org_id}/spaces/{space_id}/projects/{project_id}?selectedTraceId={trace_id}&queryFilterA=&selectedTab=llmTracing&timeZoneA=America%2FLos_Angeles&startA={start_ms}&endA={end_ms}&envA=tracing&modelType=generative_llm

セッション：

{base_url}/organizations/{org_id}/spaces/{space_id}/projects/{project_id}?selectedSessionId={session_id}&queryFilterA=&selectedTab=llmTracing&timeZoneA=America%2FLos_Angeles&startA={start_ms}&endA={end_ms}&envA=tracing&modelType=generative_llm

データセット（selectedTab：examples または experiments）：

{base_url}/organizations/{org_id}/spaces/{space_id}/datasets/{dataset_id}?selectedTab=examples

実験（実験を並べて比較するには experimentId を繰り返す）：

{base_url}/organizations/{org_id}/spaces/{space_id}/datasets/{dataset_id}/experiments/compare?experimentId={experiment_id}
{base_url}/organizations/{org_id}/spaces/{space_id}/datasets/{dataset_id}/experiments/compare?experimentId={experiment_id_a}&experimentId={experiment_id_b}

データセットなしの実験：

{base_url}/organizations/{org_id}/spaces/{space_id}/experiments/{experiment_id}

実験 ID は URL エンコードしてください（= → %3D、+ → %2B、/ → %2F）。

キュー一覧／特定のキュー：

{base_url}/organizations/{org_id}/spaces/{space_id}/queues
{base_url}/organizations/{org_id}/spaces/{space_id}/queues/{queue_id}

評価器（最新のバージョンを使用する場合は ?version=… を省略）：

{base_url}/organizations/{org_id}/spaces/{space_id}/evaluators/{evaluator_id}
{base_url}/organizations/{org_id}/spaces/{space_id}/evaluators/{evaluator_id}?version={version_url_encoded}

version の値は URL エンコードする必要があります（例：末尾の = → %3D）。

アノテーション設定：

{base_url}/organizations/{org_id}/spaces/{space_id}/annotation-configs

時間範囲

重要：トレース／スパン／セッションのリンクでは、startA と endA（エポックミリ秒）が必須です。省略すると直近 7 日間がデフォルトになり、トレースがその期間外にある場合は「最近のデータはありません」と表示されます。

優先順位：

1. ユーザー提供の URL — startA／endA を直接抽出して再利用します。
2. スパンの start_time — 前後に 1 日（または範囲を絞る場合は前後に 1 時間）の余裕を持たせます。
3. フォールバック — 直近 90 日間（now - 90d から now）。

範囲はできるだけ絞ってください。90 日間の範囲は読み込みに時間がかかります。

手順

1. ユーザー、エクスポートしたデータ、URL のコンテキスト、または CLI から ID を取得します。org_id の取得には ax organizations list --output json を、必要に応じて project_id の取得には ax projects list を使用します。
2. すべてのパス ID が base64 でエンコードされていることを確認します。
3. 上記の優先順位に従って、トレース、スパン、セッションのリンク用に startA／endA を決定します。
4. 適切なテンプレートに値を挿入し、クリック可能な Markdown リンクとして提示します。

トラブルシューティング

問題	解決方法
「データなし」／空のビュー	トレースが時間範囲外にあります。startA／endA の範囲を広げてください（±1h → ±1d → 90d）。
404	ID が間違っているか、Base64 形式ではありません。ax organizations list --output json で org_id、ax projects list で project_id、ブラウザーの URL で space_id を再確認してください。
スパンが強調表示されない	span_id が別のトレースに属している可能性があります。エクスポートしたスパンデータと照合してください。
org_id が不明	ax organizations list --output json を実行し、.organizations[].id を使用してください。CLI で組織にアクセスできない場合は、ユーザーに Arize のブラウザー URL からコピーしてもらってください。

関連スキル

• arize-trace：スパンをエクスポートして trace_id、span_id、start_time を取得します。

例

各リンクタイプの具体的な URL 一式については、references/EXAMPLES.md を参照してください。