Arize Link

Gere links profundos para a UI do Arize para traces, spans, sessões, datasets, filas de rotulagem, avaliadores e configurações de anotação.

Quando Usar

• O usuário quer um link para um trace, span, sessão, dataset, fila de rotulagem, avaliador ou configuração de anotação.
• Você tem IDs de dados exportados ou logs e precisa vincular de volta à UI.
• O usuário pede para "abrir" ou "visualizar" qualquer um dos itens acima no Arize.

Entradas Necessárias

Colete do usuário ou contexto (dados de trace exportados, URLs analisados):

Todos os IDs de caminho devem ser codificados em base64 (caracteres: A-Za-z0-9+/=). Um ID numérico bruto produz uma URL com aparência válida que resulta em 404. Se o usuário fornecer um número, peça para ele copiar o ID diretamente da URL do navegador Arize (https://app.arize.com/organizations/{org_id}/spaces/{space_id}/…). Se você tiver um ID interno bruto (por exemplo, Organization:1:abC1), codifique-o em base64 antes de inseri-lo na URL.

Modelos de URL

URL base: https://app.arize.com (substituir para on-prem)

Trace (adicione &selectedSpanId={span_id} para destacar um span específico):

{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

Sessão:

{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

Dataset (selectedTab: examples ou experiments):

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

Lista de filas / fila específica:

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

Avaliador (omitir ?version=… para o mais recente):

{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}

O valor version deve ser codificado em URL (por exemplo, trailing = → %3D).

Configurações de anotação:

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

Intervalo de Tempo

CRÍTICO: startA e endA (milissegundos de época) são obrigatórios para links de trace/span/sessão — omiti-los define o padrão para os últimos 7 dias e mostrará "nenhum dado recente" se o trace cair fora dessa janela.

Ordem de prioridade:

1. URL fornecida pelo usuário — extraia e reutilize startA/endA diretamente.
2. Span start_time — preencha ±1 dia (ou ±1 hora para uma janela mais apertada).
3. Fallback — últimos 90 dias (now - 90d a now).

Prefira janelas apertadas; janelas de 90 dias carregam lentamente.

Instruções

1. Colete IDs do usuário, dados exportados ou contexto de URL.
2. Verifique se todos os IDs de caminho estão codificados em base64.
3. Determine startA/endA usando a ordem de prioridade acima.
4. Substitua no modelo apropriado e apresente como um link markdown clicável.

Solução de Problemas

Habilidades Relacionadas

• arize-trace: Exporte spans para obter trace_id, span_id e start_time.

Exemplos

Veja references/EXAMPLES.md para um conjunto completo de URLs concretas para cada tipo de link.