arize-link

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 の範囲を広げます（±1 時間 → ±1 日 → 90 日）。
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 を参照してください。