Arize Link

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

使用するタイミング

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

必須入力

ユーザーまたはコンテキスト（エクスポートされたトレースデータ、解析されたURL）から収集してください：

常に必須	リソース固有
org_id (base64)	project_id + trace_id [+ span_id] — トレース/スパン
space_id (base64)	project_id + session_id — セッション
	dataset_id — データセット
	queue_id — 特定のキュー（リスト表示の場合は省略）
	evaluator_id [+ version] — 評価器

すべてのパスID は base64 エンコードされている必要があります（文字：A-Za-z0-9+/=）。生の数値ID は有効に見える URL を生成しますが、404 エラーになります。ユーザーが数値を提供した場合、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（オンプレミスの場合はオーバーライド）

トレース（特定のスパンをハイライトするには &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

キューリスト / 特定のキュー：

{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 コンテキストから ID を収集します。
2. すべてのパス ID が base64 エンコードされていることを確認します。
3. 上記の優先順位を使用して startA/endA を決定します。
4. 適切なテンプレートに置き換え、クリック可能な Markdown リンクとして表示します。

トラブルシューティング

問題	解決策
「データなし」/空のビュー	トレースが時間範囲外にあります — startA/endA を広げてください（±1h → ±1d → 90d）。
404	ID が間違っているか、base64 エンコードされていません。ブラウザURL から org_id、space_id、project_id を再確認してください。
スパンがハイライトされない	span_id が別のトレースに属している可能性があります。エクスポートされたスパンデータに対して検証してください。
org_id が不明	ax CLI は公開していません。ユーザーに https://app.arize.com/organizations/{org_id}/spaces/{space_id}/… からコピーするよう要求してください。

関連スキル

• arize-trace: trace_id、span_id、start_time を取得するためにスパンをエクスポートします。

例

すべてのリンクタイプの具体的な URL の完全なセットについては、references/EXAMPLES.md を参照してください。