URL de base : https://api.mistral.ai/v1/observability, avec Authorization: Bearer $MISTRAL_API_KEY. L’accès dépend de votre rôle dans l’espace de travail ; consultez Avant de commencer.
Évaluateurs
| Méthode | Chemin | Notes |
|---|---|---|
POST | /scorers | Créer. Renvoie 201 avec le slug généré. |
GET | /scorers | Lister. q filtre sur le slug, le nom ou la description. Résultats paginés (page, page_size). |
GET | /scorers/{scorer_slug} | Inclut latest_version (version, config, variables). |
PATCH | /scorers/{scorer_slug} | Accepte les champs name, description ou config. Une modification de config crée une nouvelle version. |
La suppression n'est pas prise en charge. Les champs du corps de texte sont décrits dans Évaluateurs.
Évaluations en temps réel (pipelines)
| Méthode | Chemin | Notes |
|---|---|---|
POST | /pipelines | Créer. Renvoie 201 avec pipeline_configs[]. |
GET | /pipelines | Lister. q effectue une recherche textuelle, enabled filtre les résultats. Résultats paginés. |
GET | /pipelines/{pipeline_id} | |
PUT | /pipelines/{pipeline_id} | Mise à jour partielle : envoyez uniquement les champs à modifier. Une valeur null explicite est rejetée, sauf pour description. |
DELETE | /pipelines/{pipeline_id} | 204. Suppression définitive. |
Les champs du corps de texte et les règles de mise à jour sont décrits dans Évaluations en temps réel.
La réponse pour une évaluation en temps réel :
{
"id": "018f1a2b-…",
"slug": "support-answers-1c2d3e4f",
"name": "Support answers",
"description": "…",
"enabled": true,
"selectors": [{ "source_kind": "span", "filter": "…" }],
"pipeline_configs": [
{
"slug": "helpfulness-1a2b3c4d-7b04d1aa",
"scorer_slug": "helpfulness-1a2b3c4d",
"scorer_version": 3,
"pipeline_kind": "judge-v1",
"sampling": { "type": "probabilistic", "percentage": 20 },
"definition": { "model": "…", "prompt": "…", "result_spec": { "…": "…" }, "mapping": { "…": "…" }, "use_cache": true },
"…": "…"
}
],
"creator_id": "…",
"created_at": "…",
"updated_at": "…"
}Résultats
Toutes les routes de résultats nécessitent un rôle autorisé à consulter le trafic d’observabilité et acceptent from et to comme paramètres de requête (par défaut : la dernière heure, maximum : 30 jours en production).
| Méthode | Chemin | Corps de texte | Pagination |
|---|---|---|
| POST | /spans/evaluations/search | search_expression | page_size, cursor |
| POST | /spans/evaluations/search/latest | search_expression | page_size, cursor |
| POST | /pipeline-results/search | pipeline_config_slugs (1–100), search_expression | page_size, cursor |
| POST | /spans/evaluations/aggregate | metric, dimensions, time_dimension, search_expression, order_by, limit | — |
| GET | /spans/evaluations/fields | — | — |
| GET | /spans/evaluations/fields/{field_name}/options | — | — |
Les structures des réponses sont décrites dans Lire les résultats.
Erreurs
| Statut | Condition |
|---|---|
| 403 | Accès refusé. Demandez à l’administrateur de votre espace de travail de vérifier votre rôle et votre accès à l’observabilité. |
| 404 | Slug d'évaluateur ou identifiant de pipeline inconnu dans cet espace de travail. |
| 409 | Conflit de slug lors de la création. Réessayez la requête. |
| 422 | La validation : syntaxe de filtre incorrecte, modèle Jinja2 incorrect, clé de correspondance qui n'est pas une variable d'évaluateur, source_kind différent de span, fenêtre temporelle supérieure au maximum du déploiement ou from postérieur à to. |