Enregistrements des jeux de données bêta

API d'observabilité (beta) - enregistrements de dataset.

Récupérer le contenu d'une conversation donnée depuis un jeu de données

GET /v1/observability/dataset-records/{dataset_record_id}#

Récupérer le contenu d'une conversation donnée depuis un jeu de données

200

Réponse réussie

created_at#

*date-time

dataset_id#

*string

deleted_at#

*date-time|null

id#

*string

payload#

*map<any>

Objet d'entrée créé par l'appelant et stocké sur un enregistrement de jeu de données.

properties#

*map<any>

source#

*"EXPLORER"|"UPLOADED_FILE"|"DIRECT_INPUT"|"PLAYGROUND"

updated_at#

*date-time

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.datasets.records.fetch({
    datasetRecordId: "ce995349-abbf-45c0-be75-885fc1c4b4c0",
  });

  console.log(result);
}

run();

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

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

async function run() {
  const result = await mistral.beta.observability.datasets.records.fetch({
    datasetRecordId: "ce995349-abbf-45c0-be75-885fc1c4b4c0",
  });

  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.datasets.records.fetch(dataset_record_id="ce995349-abbf-45c0-be75-885fc1c4b4c0")

    # Handle response
    print(res)

from mistralai.client import Mistral
import os


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

    res = mistral.beta.observability.datasets.records.fetch(dataset_record_id="ce995349-abbf-45c0-be75-885fc1c4b4c0")

    # Handle response
    print(res)

curl https://api.mistral.ai/v1/observability/dataset-records/{dataset_record_id} \
 -X GET \
 -H 'Authorization: Bearer YOUR_APIKEY_HERE'

curl https://api.mistral.ai/v1/observability/dataset-records/{dataset_record_id} \
 -X GET \
 -H 'Authorization: Bearer YOUR_APIKEY_HERE'

200

{
  "created_at": "2025-12-17T10:25:07.818693Z",
  "dataset_id": "019b2bd7-96e7-7219-8c0b-45a73da50088",
  "deleted_at": null,
  "id": "019b2bd7-96e7-7219-8c0b-45a73da50088",
  "payload": [
    null
  ],
  "properties": [
    null
  ],
  "source": "EXPLORER",
  "updated_at": "2025-12-17T10:41:03.469341Z"
}

{
  "created_at": "2025-12-17T10:25:07.818693Z",
  "dataset_id": "019b2bd7-96e7-7219-8c0b-45a73da50088",
  "deleted_at": null,
  "id": "019b2bd7-96e7-7219-8c0b-45a73da50088",
  "payload": [
    null
  ],
  "properties": [
    null
  ],
  "source": "EXPLORER",
  "updated_at": "2025-12-17T10:41:03.469341Z"
}

Supprimer un enregistrement d'un jeu de données

DELETE /v1/observability/dataset-records/{dataset_record_id}#

Supprimer un enregistrement d'un jeu de données

Playground

Testez les endpoints en direct

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

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

async function run() {
  await mistral.beta.observability.datasets.records.delete({
    datasetRecordId: "799fed99-80b4-4a9a-a15e-05352b811702",
  });


}

run();

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

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

async function run() {
  await mistral.beta.observability.datasets.records.delete({
    datasetRecordId: "799fed99-80b4-4a9a-a15e-05352b811702",
  });


}

run();

from mistralai.client import Mistral
import os


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

    mistral.beta.observability.datasets.records.delete(dataset_record_id="799fed99-80b4-4a9a-a15e-05352b811702")

    # Use the SDK ...

from mistralai.client import Mistral
import os


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

    mistral.beta.observability.datasets.records.delete(dataset_record_id="799fed99-80b4-4a9a-a15e-05352b811702")

    # Use the SDK ...

curl https://api.mistral.ai/v1/observability/dataset-records/{dataset_record_id} \
 -X DELETE \
 -H 'Authorization: Bearer YOUR_APIKEY_HERE' \
 -H 'Content-Type: application/json'

curl https://api.mistral.ai/v1/observability/dataset-records/{dataset_record_id} \
 -X DELETE \
 -H 'Authorization: Bearer YOUR_APIKEY_HERE' \
 -H 'Content-Type: application/json'

Supprimer plusieurs enregistrements des jeux de données

POST /v1/observability/dataset-records/bulk-delete#

Supprimer plusieurs enregistrements de jeux de données

Playground

Testez les endpoints en direct

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

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

async function run() {
  await mistral.beta.observability.datasets.records.bulkDelete({
    datasetRecordIds: [
      "22fc78f7-e774-4ab5-b1ea-63852992ef31",
      "1c533b4f-882e-4bd0-9ef6-9933b825f8b1",
    ],
  });


}

run();

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

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

async function run() {
  await mistral.beta.observability.datasets.records.bulkDelete({
    datasetRecordIds: [
      "22fc78f7-e774-4ab5-b1ea-63852992ef31",
      "1c533b4f-882e-4bd0-9ef6-9933b825f8b1",
    ],
  });


}

run();

from mistralai.client import Mistral
import os


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

    mistral.beta.observability.datasets.records.bulk_delete(dataset_record_ids=[
        "22fc78f7-e774-4ab5-b1ea-63852992ef31",
        "1c533b4f-882e-4bd0-9ef6-9933b825f8b1",
    ])

    # Use the SDK ...

from mistralai.client import Mistral
import os


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

    mistral.beta.observability.datasets.records.bulk_delete(dataset_record_ids=[
        "22fc78f7-e774-4ab5-b1ea-63852992ef31",
        "1c533b4f-882e-4bd0-9ef6-9933b825f8b1",
    ])

    # Use the SDK ...

curl https://api.mistral.ai/v1/observability/dataset-records/bulk-delete \
 -X POST \
 -H 'Authorization: Bearer YOUR_APIKEY_HERE' \
 -H 'Content-Type: application/json' \
 -d '{
  "dataset_record_ids": [
    "019b2bd7-96e7-7219-8c0b-45a73da50088"
  ]
}'

curl https://api.mistral.ai/v1/observability/dataset-records/bulk-delete \
 -X POST \
 -H 'Authorization: Bearer YOUR_APIKEY_HERE' \
 -H 'Content-Type: application/json' \
 -d '{
  "dataset_record_ids": [
    "019b2bd7-96e7-7219-8c0b-45a73da50088"
  ]
}'

Exécuter le juge sur un enregistrement de jeu de données en fonction des options données

POST /v1/observability/dataset-records/{dataset_record_id}/live-judging#

Exécuter Judge sur un enregistrement de jeu de données en fonction des options fournies

200

Réponse réussie

analysis#

*string

answer#

*string|number

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.datasets.records.judge({
    datasetRecordId: "9de5d7a1-787a-45dd-b668-9f3407e76d8b",
    judgeDatasetRecordRequest: {
      judgeDefinition: {
        name: "<value>",
        description: "wisely railway deceivingly arcade minion back what yowza outrun service",
        modelName: "<value>",
        output: {
          type: "CLASSIFICATION",
          options: [
            {
              value: "<value>",
              description: "spork excluding without retrospectivity bah next yearly",
            },
          ],
        },
        instructions: "<value>",
        tools: [
          "<value 1>",
        ],
      },
    },
  });

  console.log(result);
}

run();

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

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

async function run() {
  const result = await mistral.beta.observability.datasets.records.judge({
    datasetRecordId: "9de5d7a1-787a-45dd-b668-9f3407e76d8b",
    judgeDatasetRecordRequest: {
      judgeDefinition: {
        name: "<value>",
        description: "wisely railway deceivingly arcade minion back what yowza outrun service",
        modelName: "<value>",
        output: {
          type: "CLASSIFICATION",
          options: [
            {
              value: "<value>",
              description: "spork excluding without retrospectivity bah next yearly",
            },
          ],
        },
        instructions: "<value>",
        tools: [
          "<value 1>",
        ],
      },
    },
  });

  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.datasets.records.judge(dataset_record_id="9de5d7a1-787a-45dd-b668-9f3407e76d8b", judge_definition={
        "name": "<value>",
        "description": "wisely railway deceivingly arcade minion back what yowza outrun service",
        "model_name": "<value>",
        "output": {
            "type": "CLASSIFICATION",
            "options": [
                {
                    "value": "<value>",
                    "description": "spork excluding without retrospectivity bah next yearly",
                },
            ],
        },
        "instructions": "<value>",
        "tools": [
            "<value 1>",
        ],
    })

    # Handle response
    print(res)

from mistralai.client import Mistral
import os


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

    res = mistral.beta.observability.datasets.records.judge(dataset_record_id="9de5d7a1-787a-45dd-b668-9f3407e76d8b", judge_definition={
        "name": "<value>",
        "description": "wisely railway deceivingly arcade minion back what yowza outrun service",
        "model_name": "<value>",
        "output": {
            "type": "CLASSIFICATION",
            "options": [
                {
                    "value": "<value>",
                    "description": "spork excluding without retrospectivity bah next yearly",
                },
            ],
        },
        "instructions": "<value>",
        "tools": [
            "<value 1>",
        ],
    })

    # Handle response
    print(res)

curl https://api.mistral.ai/v1/observability/dataset-records/{dataset_record_id}/live-judging \
 -X POST \
 -H 'Authorization: Bearer YOUR_APIKEY_HERE' \
 -H 'Content-Type: application/json' \
 -d '{
  "judge_definition": {
    "description": "My Judge description.",
    "instructions": "Evaluate the response.",
    "model_name": "mistral-small-latest",
    "name": "My Judge",
    "output": {
      "options": [
        {
          "description": "My Judge",
          "value": "approved"
        }
      ]
    },
    "tools": [
      "approved"
    ]
  }
}'

curl https://api.mistral.ai/v1/observability/dataset-records/{dataset_record_id}/live-judging \
 -X POST \
 -H 'Authorization: Bearer YOUR_APIKEY_HERE' \
 -H 'Content-Type: application/json' \
 -d '{
  "judge_definition": {
    "description": "My Judge description.",
    "instructions": "Evaluate the response.",
    "model_name": "mistral-small-latest",
    "name": "My Judge",
    "output": {
      "options": [
        {
          "description": "My Judge",
          "value": "approved"
        }
      ]
    },
    "tools": [
      "approved"
    ]
  }
}'

200

{
  "analysis": "Example analysis.",
  "answer": "Example answer."
}

{
  "analysis": "Example analysis.",
  "answer": "Example answer."
}

Mettre à jour la charge utile de conversation d'un enregistrement de jeu de données

PUT /v1/observability/dataset-records/{dataset_record_id}/payload#

Mettre à jour la charge utile d'une conversation d'enregistrement de jeu de données

Playground

Testez les endpoints en direct

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

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

async function run() {
  await mistral.beta.observability.datasets.records.updatePayload({
    datasetRecordId: "17506b15-748e-4e7c-9737-c97c44d04b0f",
    updateDatasetRecordPayloadRequest: {
      payload: {
        messages: [
          {
            "key": "<value>",
          },
          {

          },
          {
            "key": "<value>",
          },
        ],
      },
    },
  });


}

run();

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

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

async function run() {
  await mistral.beta.observability.datasets.records.updatePayload({
    datasetRecordId: "17506b15-748e-4e7c-9737-c97c44d04b0f",
    updateDatasetRecordPayloadRequest: {
      payload: {
        messages: [
          {
            "key": "<value>",
          },
          {

          },
          {
            "key": "<value>",
          },
        ],
      },
    },
  });


}

run();

from mistralai.client import Mistral, models
import os


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

    mistral.beta.observability.datasets.records.update_payload(dataset_record_id="17506b15-748e-4e7c-9737-c97c44d04b0f", payload=models.ConversationPayload(
        messages=[
            {
                "key": "<value>",
            },
            {

            },
            {
                "key": "<value>",
            },
        ],
    ))

    # Use the SDK ...

from mistralai.client import Mistral, models
import os


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

    mistral.beta.observability.datasets.records.update_payload(dataset_record_id="17506b15-748e-4e7c-9737-c97c44d04b0f", payload=models.ConversationPayload(
        messages=[
            {
                "key": "<value>",
            },
            {

            },
            {
                "key": "<value>",
            },
        ],
    ))

    # Use the SDK ...

curl https://api.mistral.ai/v1/observability/dataset-records/{dataset_record_id}/payload \
 -X PUT \
 -H 'Authorization: Bearer YOUR_APIKEY_HERE' \
 -H 'Content-Type: application/json' \
 -d '{
  "payload": [
    null
  ]
}'

curl https://api.mistral.ai/v1/observability/dataset-records/{dataset_record_id}/payload \
 -X PUT \
 -H 'Authorization: Bearer YOUR_APIKEY_HERE' \
 -H 'Content-Type: application/json' \
 -d '{
  "payload": [
    null
  ]
}'

Mettre à jour les propriétés d'une conversation

PUT /v1/observability/dataset-records/{dataset_record_id}/properties#

Mettre à jour les propriétés de conversation

Playground

Testez les endpoints en direct

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

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

async function run() {
  await mistral.beta.observability.datasets.records.updateProperties({
    datasetRecordId: "a4deefc5-0905-427e-ad15-1090ef9e216d",
    updateDatasetRecordPropertiesRequest: {
      properties: {
        "key": "<value>",
        "key1": "<value>",
        "key2": "<value>",
      },
    },
  });


}

run();

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

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

async function run() {
  await mistral.beta.observability.datasets.records.updateProperties({
    datasetRecordId: "a4deefc5-0905-427e-ad15-1090ef9e216d",
    updateDatasetRecordPropertiesRequest: {
      properties: {
        "key": "<value>",
        "key1": "<value>",
        "key2": "<value>",
      },
    },
  });


}

run();

from mistralai.client import Mistral
import os


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

    mistral.beta.observability.datasets.records.update_properties(dataset_record_id="a4deefc5-0905-427e-ad15-1090ef9e216d", properties={
        "key": "<value>",
        "key1": "<value>",
        "key2": "<value>",
    })

    # Use the SDK ...

from mistralai.client import Mistral
import os


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

    mistral.beta.observability.datasets.records.update_properties(dataset_record_id="a4deefc5-0905-427e-ad15-1090ef9e216d", properties={
        "key": "<value>",
        "key1": "<value>",
        "key2": "<value>",
    })

    # Use the SDK ...

curl https://api.mistral.ai/v1/observability/dataset-records/{dataset_record_id}/properties \
 -X PUT \
 -H 'Authorization: Bearer YOUR_APIKEY_HERE' \
 -H 'Content-Type: application/json' \
 -d '{
  "properties": [
    null
  ]
}'

curl https://api.mistral.ai/v1/observability/dataset-records/{dataset_record_id}/properties \
 -X PUT \
 -H 'Authorization: Bearer YOUR_APIKEY_HERE' \
 -H 'Content-Type: application/json' \
 -d '{
  "properties": [
    null
  ]
}'

Enregistrements des jeux de données bêta

Exemples

GET /v1/observability/dataset-records/{dataset_record_id}#

Parameters#

dataset_record_id#

created_at#

dataset_id#

deleted_at#

id#

payload#

properties#

source#

updated_at#

Playground

DELETE /v1/observability/dataset-records/{dataset_record_id}#

Parameters#

dataset_record_id#

Playground

POST /v1/observability/dataset-records/bulk-delete#

Request Body#

dataset_record_ids#

Playground

POST /v1/observability/dataset-records/{dataset_record_id}/live-judging#

Parameters#

dataset_record_id#

Request Body#

judge_definition#

analysis#

answer#

Playground

PUT /v1/observability/dataset-records/{dataset_record_id}/payload#

Parameters#

dataset_record_id#

Request Body#

payload#

Playground

PUT /v1/observability/dataset-records/{dataset_record_id}/properties#

Parameters#

dataset_record_id#

Request Body#

properties#

Playground