La spec OpenAPI
Home
Tree BG 1
Tree
Tree
TreeLeaves
TreeLeaves
Cat IdleGrassGrassRockRock

Spans d'observabilité (bêta)

(bêta) API Observabilité - spans.

Rechercher des spans

POST /v1/observability/spans/search#

Rechercher des spans

200

Réponse réussie

spans#
*FeedResultGetSpan

Playground

Testez les endpoints en direct

import { Mistral } from "@mistralai/mistralai";

const mistral = new Mistral({
  apiKey: "MISTRAL_API_KEY",
});

async function run() {
  const result = await mistral.beta.observability.spans.searchSpans({
    spansRequest: {},
  });

  console.log(result);
}

run();

from mistralai.client import Mistral
import os


with Mistral(
    api_key=os.getenv("MISTRAL_API_KEY", ""),
) as mistral:

    res = mistral.beta.observability.spans.search_spans(page_size=50)

    # Traiter la réponse
    print(res)


curl https://api.mistral.ai/v1/observability/spans/search \
 -X POST \
 -H 'Authorization: Bearer YOUR_APIKEY_HERE' \
 -H 'Content-Type: application/json' \
 -d '{}'

200

{
  "spans": {}
}

Agréger des spans

POST /v1/observability/spans/aggregate#

Agréger des spans

200

Réponse réussie

data#
*array<AggregationRow>
meta#
*AggregationMeta

Playground

Testez les endpoints en direct

curl https://api.mistral.ai/v1/observability/spans/aggregate \
 -X POST \
 -H 'Authorization: Bearer YOUR_APIKEY_HERE' \
 -H 'Content-Type: application/json' \
 -d '{
  "metric": {
    "aggregation": "count",
    "measure": "ipsum eiusmod"
  }
}'

200

{
  "data": [
    {
      "metric_name": "ipsum eiusmod"
    }
  ],
  "meta": {
    "from_timestamp": "2025-12-17T10:25:07.818693Z",
    "to_timestamp": "2025-12-17T10:25:07.818693Z"
  }
}

Rechercher des évaluations de spans

POST /v1/observability/spans/evaluations/search#

Rechercher des évaluations de spans

200

Réponse réussie

span_evaluations#
*FeedResultGetSpanEvaluation

Playground

Testez les endpoints en direct

import { Mistral } from "@mistralai/mistralai";

const mistral = new Mistral({
  apiKey: "MISTRAL_API_KEY",
});

async function run() {
  const result = await mistral.beta.observability.spans.searchSpanEvaluations({
    spanEvaluationsRequest: {},
  });

  console.log(result);
}

run();

from mistralai.client import Mistral
import os


with Mistral(
    api_key=os.getenv("MISTRAL_API_KEY", ""),
) as mistral:

    res = mistral.beta.observability.spans.search_span_evaluations(page_size=50)

    # Traiter la réponse
    print(res)


curl https://api.mistral.ai/v1/observability/spans/evaluations/search \
 -X POST \
 -H 'Authorization: Bearer YOUR_APIKEY_HERE' \
 -H 'Content-Type: application/json' \
 -d '{}'

200

{
  "span_evaluations": {}
}

Rechercher les dernières évaluations de spans

POST /v1/observability/spans/evaluations/search/latest#

Rechercher les dernières évaluations de spans

200

Réponse réussie

span_evaluations#
*FeedResultGetSpanEvaluation

Playground

Testez les endpoints en direct

import { Mistral } from "@mistralai/mistralai";

const mistral = new Mistral({
  apiKey: "MISTRAL_API_KEY",
});

async function run() {
  const result = await mistral.beta.observability.spans.searchLatestSpanEvaluations({
    spanEvaluationsRequest: {},
  });

  console.log(result);
}

run();

from mistralai.client import Mistral
import os


with Mistral(
    api_key=os.getenv("MISTRAL_API_KEY", ""),
) as mistral:

    res = mistral.beta.observability.spans.search_latest_span_evaluations(page_size=50)

    # Traiter la réponse
    print(res)


curl https://api.mistral.ai/v1/observability/spans/evaluations/search/latest \
 -X POST \
 -H 'Authorization: Bearer YOUR_APIKEY_HERE' \
 -H 'Content-Type: application/json' \
 -d '{}'

200

{
  "span_evaluations": {}
}

Obtenir les définitions de champs de span

GET /v1/observability/spans/fields#

Obtenir les définitions de champs de span

200

Réponse réussie

field_definitions#
*array<OtelFieldDefinition>

Playground

Testez les endpoints en direct

import { Mistral } from "@mistralai/mistralai";

const mistral = new Mistral({
  apiKey: "MISTRAL_API_KEY",
});

async function run() {
  const result = await mistral.beta.observability.spans.listSpanFields();

  console.log(result);
}

run();

from mistralai.client import Mistral
import os


with Mistral(
    api_key=os.getenv("MISTRAL_API_KEY", ""),
) as mistral:

    res = mistral.beta.observability.spans.list_span_fields()

    # Traiter la réponse
    print(res)


curl https://api.mistral.ai/v1/observability/spans/fields \
 -X GET \
 -H 'Authorization: Bearer YOUR_APIKEY_HERE'

200

{
  "field_definitions": [
    {
      "label": "approved",
      "name": "My resource",
      "supported_aggregations": [
        "count"
      ],
      "supported_operators": [
        "eq"
      ],
      "type": "ENUM"
    }
  ]
}

Obtenir les définitions de champs d'évaluation de span

GET /v1/observability/spans/evaluations/fields#

Obtenir les définitions de champs d'évaluation de span

200

Réponse réussie

field_definitions#
*array<OtelFieldDefinition>

Playground

Testez les endpoints en direct

import { Mistral } from "@mistralai/mistralai";

const mistral = new Mistral({
  apiKey: "MISTRAL_API_KEY",
});

async function run() {
  const result = await mistral.beta.observability.spans.listSpanEvalFields();

  console.log(result);
}

run();

from mistralai.client import Mistral
import os


with Mistral(
    api_key=os.getenv("MISTRAL_API_KEY", ""),
) as mistral:

    res = mistral.beta.observability.spans.list_span_eval_fields()

    # Traiter la réponse
    print(res)


curl https://api.mistral.ai/v1/observability/spans/evaluations/fields \
 -X GET \
 -H 'Authorization: Bearer YOUR_APIKEY_HERE'

200

{
  "field_definitions": [
    {
      "label": "approved",
      "name": "My resource",
      "supported_aggregations": [
        "count"
      ],
      "supported_operators": [
        "eq"
      ],
      "type": "ENUM"
    }
  ]
}

Obtenir les options pour un champ de span

GET /v1/observability/spans/fields/{field_name}/options#

Obtenir les options pour un champ de span

200

Réponse réussie

options#
*array<string>|null

Playground

Testez les endpoints en direct

import { Mistral } from "@mistralai/mistralai";

const mistral = new Mistral({
  apiKey: "MISTRAL_API_KEY",
});

async function run() {
  const result = await mistral.beta.observability.spans.fetchSpanFieldOptions({
    fieldName: "<value>",
  });

  console.log(result);
}

run();

from mistralai.client import Mistral
import os


with Mistral(
    api_key=os.getenv("MISTRAL_API_KEY", ""),
) as mistral:

    res = mistral.beta.observability.spans.fetch_span_field_options(field_name="<value>")

    # Traiter la réponse
    print(res)


curl https://api.mistral.ai/v1/observability/spans/fields/{field_name}/options \
 -X GET \
 -H 'Authorization: Bearer YOUR_APIKEY_HERE'

200

{
  "options": null
}

Obtenir les options pour un champ d'évaluation de span

GET /v1/observability/spans/evaluations/fields/{field_name}/options#

Obtenir les options pour un champ d'évaluation de span

200

Réponse réussie

options#
*array<string>|null

Playground

Testez les endpoints en direct

import { Mistral } from "@mistralai/mistralai";

const mistral = new Mistral({
  apiKey: "MISTRAL_API_KEY",
});

async function run() {
  const result = await mistral.beta.observability.spans.fetchSpanEvalFieldOptions({
    fieldName: "<value>",
  });

  console.log(result);
}

run();

from mistralai.client import Mistral
import os


with Mistral(
    api_key=os.getenv("MISTRAL_API_KEY", ""),
) as mistral:

    res = mistral.beta.observability.spans.fetch_span_eval_field_options(field_name="<value>")

    # Traiter la réponse
    print(res)


curl https://api.mistral.ai/v1/observability/spans/evaluations/fields/{field_name}/options \
 -X GET \
 -H 'Authorization: Bearer YOUR_APIKEY_HERE'

200

{
  "options": null
}