Arguments autorisés de l'API de complétion.













Agents bêta
API Agents (bêta)












Exemples
Exemples réels de code
Lister les entités d'agent.
GET /v1/agents
Récupérer une liste d'entités d'agent triées par date de création.
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.agents.list({});
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.agents.list({});
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.agents.list(page=0, page_size=20)
# 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.agents.list(page=0, page_size=20)
# Handle response
print(res)
curl https://api.mistral.ai/v1/agents \
-X GET \
-H 'Authorization: Bearer YOUR_APIKEY_HERE'curl https://api.mistral.ai/v1/agents \
-X GET \
-H 'Authorization: Bearer YOUR_APIKEY_HERE'200
[
{
"created_at": "2025-12-17T10:25:07.818693Z",
"deployment_chat": false,
"id": "019b2bd7-96e7-7219-8c0b-45a73da50088",
"model": "mistral-small-latest",
"name": "My resource",
"source": "upload",
"updated_at": "2025-12-17T10:41:03.469341Z",
"version": 87,
"versions": [
14
]
}
][
{
"created_at": "2025-12-17T10:25:07.818693Z",
"deployment_chat": false,
"id": "019b2bd7-96e7-7219-8c0b-45a73da50088",
"model": "mistral-small-latest",
"name": "My resource",
"source": "upload",
"updated_at": "2025-12-17T10:41:03.469341Z",
"version": 87,
"versions": [
14
]
}
]Créer un agent pouvant être utilisé au sein d'une conversation.
POST /v1/agents
Créer un nouvel agent en lui fournissant des instructions, des outils et une description. L'agent est ensuite disponible pour être utilisé comme assistant régulier dans une conversation ou en tant que partie d'un pool d'agents à partir duquel il peut être utilisé.
description
guardrails
handoffs
instructions
Instruction que le modèle suivra pendant la conversation.
metadata
model
name
Liste des outils disponibles pour le modèle durant la conversation.
version_message
200
Réponse réussie
created_at
deployment_chat
description
guardrails
handoffs
id
instructions
Instruction que le modèle suivra pendant la conversation.
metadata
model
name
object
Default Value: "agent"
source
Liste des outils disponibles pour le modèle durant la conversation.
updated_at
version
version_message
versions
Playground
Testez les endpoints en direct
import { Mistral } from "@mistralai/mistralai";
const client = new Mistral({ apiKey: process.env.MISTRAL_API_KEY });
const agent = await client.beta.agents.create({
model: "mistral-small-latest",
name: "Support assistant",
});
console.log(agent.id);
import { Mistral } from "@mistralai/mistralai";
const client = new Mistral({ apiKey: process.env.MISTRAL_API_KEY });
const agent = await client.beta.agents.create({
model: "mistral-small-latest",
name: "Support assistant",
});
console.log(agent.id);
import os
from mistralai import Mistral
client = Mistral(api_key=os.environ["MISTRAL_API_KEY"])
agent = client.beta.agents.create(
model="mistral-small-latest",
name="Support assistant",
)
print(agent.id)
import os
from mistralai import Mistral
client = Mistral(api_key=os.environ["MISTRAL_API_KEY"])
agent = client.beta.agents.create(
model="mistral-small-latest",
name="Support assistant",
)
print(agent.id)
curl https://api.mistral.ai/v1/agents \
-X POST \
-H 'Authorization: Bearer YOUR_APIKEY_HERE' \
-H 'Content-Type: application/json' \
-d '{
"model": "mistral-small-latest",
"name": "My Agent"
}'curl https://api.mistral.ai/v1/agents \
-X POST \
-H 'Authorization: Bearer YOUR_APIKEY_HERE' \
-H 'Content-Type: application/json' \
-d '{
"model": "mistral-small-latest",
"name": "My Agent"
}'200
{
"created_at": "2025-12-17T10:25:07.818693Z",
"deployment_chat": false,
"id": "019b2bd7-96e7-7219-8c0b-45a73da50088",
"model": "mistral-small-latest",
"name": "My resource",
"source": "upload",
"updated_at": "2025-12-17T10:41:03.469341Z",
"version": 87,
"versions": [
14
]
}{
"created_at": "2025-12-17T10:25:07.818693Z",
"deployment_chat": false,
"id": "019b2bd7-96e7-7219-8c0b-45a73da50088",
"model": "mistral-small-latest",
"name": "My resource",
"source": "upload",
"updated_at": "2025-12-17T10:41:03.469341Z",
"version": 87,
"versions": [
14
]
}Récupérer une entité d'agent.
GET /v1/agents/{agent_id}
Étant donné un agent, récupérer une entité d'agent avec ses attributs. Le paramètre agent_version peut être un numéro de version entier ou un alias de chaîne de caractères.
agent_id
agent_version
200
Réponse réussie
created_at
deployment_chat
description
guardrails
handoffs
id
instructions
Instruction que le modèle suivra pendant la conversation.
metadata
model
name
object
Default Value: "agent"
source
Liste des outils disponibles pour le modèle durant la conversation.
updated_at
version
version_message
versions
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.agents.get({
agentId: "<id>",
});
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.agents.get({
agentId: "<id>",
});
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.agents.get(agent_id="<id>")
# 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.agents.get(agent_id="<id>")
# Handle response
print(res)
curl https://api.mistral.ai/v1/agents/{agent_id} \
-X GET \
-H 'Authorization: Bearer YOUR_APIKEY_HERE'curl https://api.mistral.ai/v1/agents/{agent_id} \
-X GET \
-H 'Authorization: Bearer YOUR_APIKEY_HERE'200
{
"created_at": "2025-12-17T10:25:07.818693Z",
"deployment_chat": false,
"id": "019b2bd7-96e7-7219-8c0b-45a73da50088",
"model": "mistral-small-latest",
"name": "My resource",
"source": "upload",
"updated_at": "2025-12-17T10:41:03.469341Z",
"version": 87,
"versions": [
14
]
}{
"created_at": "2025-12-17T10:25:07.818693Z",
"deployment_chat": false,
"id": "019b2bd7-96e7-7219-8c0b-45a73da50088",
"model": "mistral-small-latest",
"name": "My resource",
"source": "upload",
"updated_at": "2025-12-17T10:41:03.469341Z",
"version": 87,
"versions": [
14
]
}Supprimer une entité d'agent.
DELETE /v1/agents/{agent_id}
agent_id
Playground
Testez les endpoints en direct
from mistralai.client import Mistral
import os
with Mistral(
api_key=os.getenv("MISTRAL_API_KEY", ""),
) as mistral:
mistral.beta.agents.delete(agent_id="<id>")
# Use the SDK ...
from mistralai.client import Mistral
import os
with Mistral(
api_key=os.getenv("MISTRAL_API_KEY", ""),
) as mistral:
mistral.beta.agents.delete(agent_id="<id>")
# Use the SDK ...
curl https://api.mistral.ai/v1/agents/{agent_id} \
-X DELETE \
-H 'Authorization: Bearer YOUR_APIKEY_HERE' \
-H 'Content-Type: application/json'curl https://api.mistral.ai/v1/agents/{agent_id} \
-X DELETE \
-H 'Authorization: Bearer YOUR_APIKEY_HERE' \
-H 'Content-Type: application/json'Mettre à jour une entité d'agent.
PATCH /v1/agents/{agent_id}
Mettre à jour les attributs d'un agent et créer une nouvelle version.
agent_id
deployment_chat
description
guardrails
handoffs
instructions
Instruction que le modèle suivra pendant la conversation.
metadata
model
name
Liste des outils disponibles pour le modèle durant la conversation.
version_message
200
Réponse réussie
created_at
deployment_chat
description
guardrails
handoffs
id
instructions
Instruction que le modèle suivra pendant la conversation.
metadata
model
name
object
Default Value: "agent"
source
Liste des outils disponibles pour le modèle durant la conversation.
updated_at
version
version_message
versions
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.agents.update({
agentId: "<id>",
agentUpdateRequest: {},
});
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.agents.update({
agentId: "<id>",
agentUpdateRequest: {},
});
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.agents.update(agent_id="<id>", completion_args={
"response_format": {
"type": "text",
},
})
# 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.agents.update(agent_id="<id>", completion_args={
"response_format": {
"type": "text",
},
})
# Handle response
print(res)
curl https://api.mistral.ai/v1/agents/{agent_id} \
-X PATCH \
-H 'Authorization: Bearer YOUR_APIKEY_HERE' \
-H 'Content-Type: application/json' \
-d '{}'curl https://api.mistral.ai/v1/agents/{agent_id} \
-X PATCH \
-H 'Authorization: Bearer YOUR_APIKEY_HERE' \
-H 'Content-Type: application/json' \
-d '{}'200
{
"created_at": "2025-12-17T10:25:07.818693Z",
"deployment_chat": false,
"id": "019b2bd7-96e7-7219-8c0b-45a73da50088",
"model": "mistral-small-latest",
"name": "My resource",
"source": "upload",
"updated_at": "2025-12-17T10:41:03.469341Z",
"version": 87,
"versions": [
14
]
}{
"created_at": "2025-12-17T10:25:07.818693Z",
"deployment_chat": false,
"id": "019b2bd7-96e7-7219-8c0b-45a73da50088",
"model": "mistral-small-latest",
"name": "My resource",
"source": "upload",
"updated_at": "2025-12-17T10:41:03.469341Z",
"version": 87,
"versions": [
14
]
}Mettre à jour une version d'agent.
PATCH /v1/agents/{agent_id}/version
Changer la version d'un agent.
agent_id
version
200
Réponse réussie
created_at
deployment_chat
description
guardrails
handoffs
id
instructions
Instruction que le modèle suivra pendant la conversation.
metadata
model
name
object
Default Value: "agent"
source
Liste des outils disponibles pour le modèle durant la conversation.
updated_at
version
version_message
versions
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.agents.updateVersion({
agentId: "<id>",
version: 157995,
});
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.agents.updateVersion({
agentId: "<id>",
version: 157995,
});
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.agents.update_version(agent_id="<id>", version=157995)
# 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.agents.update_version(agent_id="<id>", version=157995)
# Handle response
print(res)
curl https://api.mistral.ai/v1/agents/{agent_id}/version \
-X PATCH \
-H 'Authorization: Bearer YOUR_APIKEY_HERE' \
-H 'Content-Type: application/json'curl https://api.mistral.ai/v1/agents/{agent_id}/version \
-X PATCH \
-H 'Authorization: Bearer YOUR_APIKEY_HERE' \
-H 'Content-Type: application/json'200
{
"created_at": "2025-12-17T10:25:07.818693Z",
"deployment_chat": false,
"id": "019b2bd7-96e7-7219-8c0b-45a73da50088",
"model": "mistral-small-latest",
"name": "My resource",
"source": "upload",
"updated_at": "2025-12-17T10:41:03.469341Z",
"version": 87,
"versions": [
14
]
}{
"created_at": "2025-12-17T10:25:07.818693Z",
"deployment_chat": false,
"id": "019b2bd7-96e7-7219-8c0b-45a73da50088",
"model": "mistral-small-latest",
"name": "My resource",
"source": "upload",
"updated_at": "2025-12-17T10:41:03.469341Z",
"version": 87,
"versions": [
14
]
}Lister toutes les versions d'un agent.
GET /v1/agents/{agent_id}/versions
Récupérer toutes les versions pour un agent spécifique avec le contexte complet de l'agent. Prend en charge la pagination.
agent_id
page
Numéro de page (indexé à partir de 0)
page_size
Nombre de versions par page
Playground
Testez les endpoints en direct
from mistralai.client import Mistral
import os
with Mistral(
api_key=os.getenv("MISTRAL_API_KEY", ""),
) as mistral:
res = mistral.beta.agents.list_versions(agent_id="<id>", page=0, page_size=20)
# 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.agents.list_versions(agent_id="<id>", page=0, page_size=20)
# Handle response
print(res)
curl https://api.mistral.ai/v1/agents/{agent_id}/versions \
-X GET \
-H 'Authorization: Bearer YOUR_APIKEY_HERE'curl https://api.mistral.ai/v1/agents/{agent_id}/versions \
-X GET \
-H 'Authorization: Bearer YOUR_APIKEY_HERE'200
[
{
"created_at": "2025-12-17T10:25:07.818693Z",
"deployment_chat": false,
"id": "019b2bd7-96e7-7219-8c0b-45a73da50088",
"model": "mistral-small-latest",
"name": "My resource",
"source": "upload",
"updated_at": "2025-12-17T10:41:03.469341Z",
"version": 87,
"versions": [
14
]
}
][
{
"created_at": "2025-12-17T10:25:07.818693Z",
"deployment_chat": false,
"id": "019b2bd7-96e7-7219-8c0b-45a73da50088",
"model": "mistral-small-latest",
"name": "My resource",
"source": "upload",
"updated_at": "2025-12-17T10:41:03.469341Z",
"version": 87,
"versions": [
14
]
}
]Récupérer une version spécifique d'un agent.
GET /v1/agents/{agent_id}/versions/{version}
Obtenir une version spécifique d'un agent par numéro de version.
agent_id
version
200
Réponse réussie
created_at
deployment_chat
description
guardrails
handoffs
id
instructions
Instruction que le modèle suivra pendant la conversation.
metadata
model
name
object
Default Value: "agent"
source
Liste des outils disponibles pour le modèle durant la conversation.
updated_at
version
version_message
versions
Playground
Testez les endpoints en direct
from mistralai.client import Mistral
import os
with Mistral(
api_key=os.getenv("MISTRAL_API_KEY", ""),
) as mistral:
res = mistral.beta.agents.get_version(agent_id="<id>", version="788393")
# 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.agents.get_version(agent_id="<id>", version="788393")
# Handle response
print(res)
curl https://api.mistral.ai/v1/agents/{agent_id}/versions/{version} \
-X GET \
-H 'Authorization: Bearer YOUR_APIKEY_HERE'curl https://api.mistral.ai/v1/agents/{agent_id}/versions/{version} \
-X GET \
-H 'Authorization: Bearer YOUR_APIKEY_HERE'200
{
"created_at": "2025-12-17T10:25:07.818693Z",
"deployment_chat": false,
"id": "019b2bd7-96e7-7219-8c0b-45a73da50088",
"model": "mistral-small-latest",
"name": "My resource",
"source": "upload",
"updated_at": "2025-12-17T10:41:03.469341Z",
"version": 87,
"versions": [
14
]
}{
"created_at": "2025-12-17T10:25:07.818693Z",
"deployment_chat": false,
"id": "019b2bd7-96e7-7219-8c0b-45a73da50088",
"model": "mistral-small-latest",
"name": "My resource",
"source": "upload",
"updated_at": "2025-12-17T10:41:03.469341Z",
"version": 87,
"versions": [
14
]
}Lister tous les alias d'un agent.
GET /v1/agents/{agent_id}/aliases
Récupérer tous les alias de version pour un agent spécifique.
agent_id
200
Playground
Testez les endpoints en direct
from mistralai.client import Mistral
import os
with Mistral(
api_key=os.getenv("MISTRAL_API_KEY", ""),
) as mistral:
res = mistral.beta.agents.list_version_aliases(agent_id="<id>")
# 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.agents.list_version_aliases(agent_id="<id>")
# Handle response
print(res)
curl https://api.mistral.ai/v1/agents/{agent_id}/aliases \
-X GET \
-H 'Authorization: Bearer YOUR_APIKEY_HERE'curl https://api.mistral.ai/v1/agents/{agent_id}/aliases \
-X GET \
-H 'Authorization: Bearer YOUR_APIKEY_HERE'200
[
{
"alias": "production",
"created_at": "2025-12-17T10:25:07.818693Z",
"updated_at": "2025-12-17T10:41:03.469341Z",
"version": 87
}
][
{
"alias": "production",
"created_at": "2025-12-17T10:25:07.818693Z",
"updated_at": "2025-12-17T10:41:03.469341Z",
"version": 87
}
]Créer ou mettre à jour un alias de version d'agent.
PUT /v1/agents/{agent_id}/aliases
Créer un nouvel alias ou mettre à jour un alias existant pour pointer vers une version spécifique. Les alias sont uniques par agent et peuvent être réaffectés à différentes versions.
agent_id
alias
version
200
Réponse réussie
alias
created_at
updated_at
version
Playground
Testez les endpoints en direct
import os
from mistralai import Mistral
client = Mistral(api_key=os.environ["MISTRAL_API_KEY"])
alias = client.beta.agents.create_version_alias(
agent_id="019b2bd7-96e7-7219-8c0b-45a73da50088",
alias="production",
version=1,
)
print(alias)
import os
from mistralai import Mistral
client = Mistral(api_key=os.environ["MISTRAL_API_KEY"])
alias = client.beta.agents.create_version_alias(
agent_id="019b2bd7-96e7-7219-8c0b-45a73da50088",
alias="production",
version=1,
)
print(alias)
curl https://api.mistral.ai/v1/agents/{agent_id}/aliases \
-X PUT \
-H 'Authorization: Bearer YOUR_APIKEY_HERE' \
-H 'Content-Type: application/json'curl https://api.mistral.ai/v1/agents/{agent_id}/aliases \
-X PUT \
-H 'Authorization: Bearer YOUR_APIKEY_HERE' \
-H 'Content-Type: application/json'200
{
"alias": "production",
"created_at": "2025-12-17T10:25:07.818693Z",
"updated_at": "2025-12-17T10:41:03.469341Z",
"version": 87
}{
"alias": "production",
"created_at": "2025-12-17T10:25:07.818693Z",
"updated_at": "2025-12-17T10:41:03.469341Z",
"version": 87
}Supprimer un alias de version d'agent.
DELETE /v1/agents/{agent_id}/aliases
Supprimer un alias existant pour un agent.
agent_id
alias
Playground
Testez les endpoints en direct
import os
from mistralai import Mistral
client = Mistral(api_key=os.environ["MISTRAL_API_KEY"])
client.beta.agents.delete_version_alias(
agent_id="019b2bd7-96e7-7219-8c0b-45a73da50088",
alias="production",
)
import os
from mistralai import Mistral
client = Mistral(api_key=os.environ["MISTRAL_API_KEY"])
client.beta.agents.delete_version_alias(
agent_id="019b2bd7-96e7-7219-8c0b-45a73da50088",
alias="production",
)
curl https://api.mistral.ai/v1/agents/{agent_id}/aliases \
-X DELETE \
-H 'Authorization: Bearer YOUR_APIKEY_HERE' \
-H 'Content-Type: application/json'curl https://api.mistral.ai/v1/agents/{agent_id}/aliases \
-X DELETE \
-H 'Authorization: Bearer YOUR_APIKEY_HERE' \
-H 'Content-Type: application/json'