Arize Link

Générer des liens profonds vers l'interface Arize pour les traces, spans, sessions, datasets, files d'attente de labellisation, évaluateurs et configurations d'annotation.

Quand l'utiliser

• L'utilisateur souhaite un lien vers une trace, span, session, dataset, file d'attente de labellisation, évaluateur ou configuration d'annotation
• Vous disposez d'IDs provenant de données exportées ou de logs et devez renvoyer vers l'interface
• L'utilisateur demande « d'ouvrir » ou « afficher » l'un des éléments ci-dessus dans Arize

Entrées requises

Rassembler auprès de l'utilisateur ou du contexte (données de trace exportées, URLs analysées) :

Tous les IDs dans les chemins doivent être encodés en base64 (caractères : A-Za-z0-9+/=). Un ID numérique brut produit une URL valide en apparence mais qui retourne une erreur 404. Si l'utilisateur fournit un nombre, demandez-lui de copier l'ID directement depuis son URL Arize (https://app.arize.com/organizations/{org_id}/spaces/{space_id}/…). Si vous disposez d'un ID interne brut (par exemple Organization:1:abC1), encodez-le en base64 avant de l'insérer dans l'URL.

Modèles d'URL

URL de base : https://app.arize.com (à remplacer pour on-prem)

Trace (ajouter &selectedSpanId={span_id} pour mettre en évidence un span spécifique) :

{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

Session :

{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

Liste des files / file spécifique :

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

Évaluateur (omis ?version=… pour la dernière 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}

La valeur version doit être encodée en URL (par exemple, = final → %3D).

Configurations d'annotation :

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

Plage horaire

CRITIQUE : startA et endA (millisecondes epoch) sont requises pour les liens trace/span/session — les omettre revient à utiliser par défaut les 7 derniers jours et affichera « aucune donnée récente » si la trace sort de cette fenêtre.

Ordre de priorité :

1. URL fournie par l'utilisateur — extraire et réutiliser directement startA/endA.
2. start_time du span — ajouter une marge de ±1 jour (ou ±1 heure pour une fenêtre plus étroite).
3. Fallback — les 90 derniers jours (maintenant - 90j à maintenant).

Privilégier les fenêtres étroites ; les fenêtres de 90 jours se chargent lentement.

Instructions

1. Rassembler les IDs auprès de l'utilisateur, des données exportées ou du contexte d'URL.
2. Vérifier que tous les IDs dans les chemins sont encodés en base64.
3. Déterminer startA/endA en utilisant l'ordre de priorité ci-dessus.
4. Substituer dans le modèle approprié et présenter comme un lien markdown cliquable.

Dépannage

Compétences connexes

• arize-trace : Exporter des spans pour obtenir trace_id, span_id et start_time.

Exemples

Voir references/EXAMPLES.md pour un ensemble complet d'URLs concrètes pour chaque type de lien.