Assistants (Deprecated) - Alibaba Cloud Model Studio - Centre de documentation Alibaba Cloud

L'API Assistant simplifie la création d'assistants, un type d'application basée sur les grands modèles de langage (LLM). Cette rubrique décrit les méthodes fournies par l'API Assistant pour gérer ces assistants : création, liste, récupération, mise à jour et suppression.

ImportantL'API Assistant est en cours de dépréciation. Migrez vers l'API Responses comme alternative. L'API Responses intègre plusieurs outils natifs et prend en charge la gestion du contexte multi-tours.

Fonctionnalités : Pour plus d'informations sur les fonctionnalités et l'utilisation de base de l'API Assistant, consultez la Présentation de l'API Assistant .

Persistance : Toutes les instances d'assistant sont enregistrées sur le serveur Alibaba Cloud Model Studio sans date d'expiration. Récupérez un assistant à l'aide de son assistant.id.

RemarqueL'Application Agent (Agent 1.0) et les assistants constituent deux types d'applications LLM aux fonctionnalités et usages distincts.

Applications Agent : créez, consultez, mettez à jour et supprimez les applications agent uniquement dans la console. Appelez-les via l'API d'appel d'application.
Assistants : créez, consultez, mettez à jour, supprimez et appelez les assistants exclusivement via l'API Assistant.

Créer un agent

Crée un nouvel assistant.

HTTP

Exemple de code

curl --location 'https://dashscope-intl.aliyuncs.com/api/v1/assistants' \
--header "Content-Type: application/json" \
--header "Authorization: Bearer $DASHSCOPE_API_KEY" \
--data '{
    "model": "qwen-max",
    "name": "Intelligent assistant",
    "description": "This is an intelligent assistant",
    "instructions": "You are an intelligent assistant that can call different tools based on user query and then give responses. Please use tools when needed.",
    "tools": [
        {
            "type": "code_interpreter"
        }
    ],
    "metadata": {}
}'

Paramètres de la requête

Nom du paramètre	Description	Type	Obligatoire
model	Modèle utilisé par l'agent.	str	Oui
name	Nom de l'agent.	str	Non
description	Description de l'agent.	str	Non
instructions	Invite système pour le LLM de l'agent.	str	Non
tools	Liste des outils que l'agent peut appeler. Transmet les informations d'authentification pour un plugin personnalisé. `{ "type": "${plugin_id}", "auth": { # This field is used only for user-level authentication. "type": "user_http", "user_token": "bearer-token", } }`	Optional[List[Dict]]	Non (par défaut : [])
metadata	Autres paramètres liés à l'agent. Ce paramètre permet de stocker des informations complémentaires.	Dict	Non
temperature	Contrôle le degré d'aléatoire et de diversité.	float	Non
top_p	Seuil de probabilité pour la méthode d'échantillonnage par noyau lors de la génération.	float	Non
top_k	Taille de l'ensemble des candidats pour l'échantillonnage lors de la génération.	integer	Non

Réponse

{
    "id": "asst_49079f4b-d1e8-4015-a12e-2dcdd1f18d84",
    "object": "assistant",
    "created_at": 1711713885724,
    "model": "qwen-max",
    "name": "Intelligent Assistant",
    "description": "This is an intelligent assistant.",
    "instructions": "You are an intelligent assistant. You can call different tools based on user needs to provide answers. Use tools as needed.",
    "tools": [
        {
            "type": "code_interpreter"
        }
    ],
    "metadata": {},
    "temperature": null,
    "top_p": null,
    "top_k": null,
    "max_tokens": null,
    "request_id": "b1778226-3865-9006-9e95-56329a710322"
}

Paramètres de la réponse

Un objet assistant.

SDK

Exemple de code

python

from dashscope import Assistants
import os
import dashscope
dashscope.base_http_api_url = 'https://dashscope-intl.aliyuncs.com/api/v1'
assistant = Assistants.create(
        # Set the environment variable. If you have not, replace the following line with your Model Studio API key: api_key="sk-xxx"
        api_key=os.getenv("DASHSCOPE_API_KEY"),
        # This example uses qwen-max. You can replace it with another model name as needed. For a list of models, see https://www.alibabacloud.com/help/en/model-studio/getting-started/models
        model='qwen-max',
        name='smart helper',
        description='A tool helper.',
        instructions='You are a helpful assistant. When asked a question, use tools wherever possible.',
        tools=[{
            'type': 'search'
        }, {
            'type': 'function',
            'function': {
                'name': 'big_add',
                'description': 'Add to number',
                'parameters': {
                    'type': 'object',
                    'properties': {
                        'left': {
                            'type': 'integer',
                            'description': 'The left operator'
                        },
                        'right': {
                            'type': 'integer',
                            'description': 'The right operator.'
                        }
                    },
                    'required': ['left', 'right']
                }
            }
        }],
)
print(assistant)

java

import com.alibaba.dashscope.assistants.Assistant;
import com.alibaba.dashscope.assistants.AssistantParam;
import com.alibaba.dashscope.assistants.Assistants;
import com.alibaba.dashscope.exception.ApiException;
import com.alibaba.dashscope.exception.InputRequiredException;
import com.alibaba.dashscope.exception.InvalidateParameter;
import com.alibaba.dashscope.exception.NoApiKeyException;
import java.lang.System;
import com.alibaba.dashscope.utils.JsonUtils;
import com.alibaba.dashscope.utils.Constants;

public class Main {
    static {
        Constants.baseHttpApiUrl="https://dashscope-intl.aliyuncs.com/api/v1";
    }
    public static void main(String[] args) throws ApiException, NoApiKeyException, InputRequiredException, InvalidateParameter, InterruptedException {
        Assistants assistants = new Assistants();
        // build assistant parameters
        AssistantParam param = AssistantParam.builder()
                // This example uses qwen-max. You can replace it with another model name as needed. For a list of models, see https://www.alibabacloud.com/help/en/model-studio/getting-started/models
                .model("qwen-max")
                .name("intelligent guide")
                .description("a smart guide")
                .instructions("You are a helpful assistant.")
                // Set the environment variable. If you have not, replace the following line with your Model Studio API key: api_key="sk-xxx"
                .apiKey(System.getenv("DASHSCOPE_API_KEY"))
                .build();
        Assistant assistant = assistants.create(param);
        System.out.println(JsonUtils.toJson(assistant));
        // use assistant

    }
}

Paramètres de la requête

Paramètre	Type	Valeur par défaut	Description
model	string	-	Modèle utilisé par l'agent.
name	string	-	Nom de l'agent.
description	string	-	Description de l'agent.
instructions	string	-	Spécifie les fonctionnalités de l'agent.
tools	array	[]	Outils utilisés par l'agent. Transmet les informations d'authentification pour un outil personnalisé. `{` `"type": "plugin_type", "auth": {"type": "user_http","user_token": "bearer-token", }` `}` Lorsque l'assistant sollicite un plugin, il place le bearer token dans `{"plugin_type":{"user_token": "bearer-token"}}` et l'ajoute à l'en-tête de l'appel du plugin.
metadata	object	None	Informations associées à l'agent.
workspace	string	None	ID de l'espace de travail Model Studio. Ce paramètre est requis uniquement si `api_key` correspond à une clé API de sous-espace de travail.
api_key	string	None	Pour la clé API Alibaba Cloud Model Studio, nous vous recommandons de la définir comme variable d'environnement (Cette rubrique sera supprimée et fusionnée dans 'Configurer la clé API').

Réponse

{
   "tools":[
      {
         "type":"search"
      },
      {
         "function":{
            "name":"big_add",
            "description":"Add to number",
            "parameters":{
               "type":"object",
               "properties":{
                  "left":{
                     "type":"integer",
                     "description":"The left operator"
                  },
                  "right":{
                     "type":"integer",
                     "description":"The right operator."
                  }
               },
               "required":[
                  "left",
                  "right"
               ]
            }
         },
         "type":"function"
      }
   ],
   "id":"asst_714cac72-81b2-49bf-a75d-c575b90a9398",
   "object":"assistant",
   "created_at":1726033638848,
   "model":"qwen-max",
   "name":"smart helper",
   "description":"A tool helper.",
   "instructions":"You are a helpful assistant. When asked a question, use tools wherever possible.",
   "file_ids":[

   ],
   "metadata":{

   },
   "temperature":"None",
   "top_p":"None",
   "top_k":"None",
   "max_tokens":"None",
   "request_id":"00f5962e-8d9f-92fd-9320-3173fa1525d6",
   "status_code":200
}

Paramètres de la réponse

Nom du champ	Type	Description
status_code	integer	Code d'état HTTP de l'appel. La valeur 200 indique un succès. Toute autre valeur signale une erreur.
name	string	Nom de l'agent.
id	string	ID de l'agent, sous forme de chaîne UUID.
model	string	Nom du modèle utilisé par l'agent.
description	string	Description de l'agent.
instructions	string	Permet de spécifier les fonctionnalités de l'agent.
metadata	object	Métadonnées de l'agent.
tools	array	Liste des outils disponibles pour l'agent.
created_at	integer	Horodatage UNIX de création de l'agent.
code	string	Indique l'échec de la requête. Il s'agit du code d'erreur. Ce paramètre est ignoré en cas de succès. Il n'est retourné que lors d'un échec d'appel depuis Python.
message	string	Indique l'échec de la requête. Ce paramètre fournit des détails sur l'erreur. Il est ignoré en cas de succès et n'est retourné que lors d'un échec d'appel depuis Python.

Lister les agents

Retourne une liste d'assistants.

HTTP

Exemple de code

curl --location 'https://dashscope-intl.aliyuncs.com/api/v1/assistants?limit=2&order=desc' \
--header 'Content-Type: application/json' \
--header "Authorization: Bearer $DASHSCOPE_API_KEY"

Paramètres de la requête

Nom du paramètre d'entrée	Description du paramètre d'entrée	Type	Obligatoire
limit	Nombre d'agents	int	Non
order	Ordre de tri par date de création.	str	Non (par défaut : `desc`)

Réponse

{
    "object": "list",
    "data": [
        {
            "id": "asst_0678aa33-43e2-4268-95e6-b0010f9f7937",
            "object": "assistant",
            "created_at": 1711435564909,
            "model": "qwen-max",
            "name": "Intelligent Assistant",
            "description": "This is an intelligent assistant.",
            "instructions": "You are an intelligent assistant. You can call different tools based on user needs to provide answers. Use tools as needed.",
            "tools": [
                {
                    "type": "search"
                },
                {
                    "type": "text_to_image"
                },
                {
                    "type": "code_interpreter"
                }
            ],
            "metadata": {}
        },
        {
            "id": "asst_7af23142-52bc-4218-aa98-dfdb1128f19c",
            "object": "assistant",
            "created_at": 1711422620443,
            "model": "qwen-max",
            "name": "helpful assistant",
            "description": "",
            "instructions": "You are a helpful assistant.",
            "tools": [
                {
                    "type": "text_to_image"
                }
            ],
            "file_ids": [],
            "metadata": {}
        }
    ],
    "first_id": "asst_0678aa33-43e2-4268-95e6-b0010f9f7937",
    "last_id": "asst_7af23142-52bc-4218-aa98-dfdb1128f19c",
    "has_more": true,
    "request_id": "bc257359-ce86-9547-98be-d804effba8d1"
}

Paramètres de la réponse

Une liste d'objets assistant.

SDK

Exemple de code

python

import dashscope
from dashscope import Assistants
import os

dashscope.base_http_api_url = 'https://dashscope-intl.aliyuncs.com/api/v1'
assistants = Assistants.list(
    # Set the environment variable. If you have not, replace the following line with your Model Studio API key: api_key="sk-xxx"
    api_key=os.getenv("DASHSCOPE_API_KEY"),
    limit=1,
    order='desc'
)

java

import com.alibaba.dashscope.assistants.Assistant;
import com.alibaba.dashscope.assistants.Assistants;
import com.alibaba.dashscope.common.GeneralListParam;
import com.alibaba.dashscope.common.ListResult;
import com.alibaba.dashscope.exception.ApiException;
import com.alibaba.dashscope.exception.InputRequiredException;
import com.alibaba.dashscope.exception.InvalidateParameter;
import com.alibaba.dashscope.exception.NoApiKeyException;
import com.alibaba.dashscope.utils.Constants;

public class Main {
    static {
        Constants.baseHttpApiUrl="https://dashscope-intl.aliyuncs.com/api/v1";
    }
    public static void main(String[] args) throws ApiException, NoApiKeyException, InputRequiredException, InvalidateParameter, InterruptedException {
      Assistants assistants = new Assistants();
      GeneralListParam listParam = GeneralListParam.builder()
                // Set the environment variable. If you have not, replace the following line with your Model Studio API key: api_key="sk-xxx"
                .apiKey(System.getenv("DASHSCOPE_API_KEY"))
                .limit(10l)
                .build();
      ListResult<Assistant> assistant = assistants.list(listParam);
    }
}

Paramètres de la requête

Paramètre	Type	Valeur par défaut	Description
limit	string	None	Nombre d'assistants à lister. Si ce paramètre n'est pas spécifié, la valeur par défaut du serveur s'applique.
order	string	None	Ordre de tri. Valeurs valides : `desc` (décroissant) et `asc` (croissant). Si ce paramètre n'est pas spécifié, la valeur par défaut du serveur s'applique.
workspace	string	None	ID de l'espace de travail Model Studio. Ce paramètre est requis uniquement si `api_key` correspond à une clé API de sous-espace de travail.
api_key	string	None	Pour la clé API Alibaba Cloud Model Studio, nous vous recommandons de la configurer dans une variable d'environnement.

Paramètres de la réponse

Nom du champ	Type	Description
has_more	boolean	Indique si des données supplémentaires sont disponibles.
last_id	string	ID du dernier assistant dans les données.
first_id	string	ID du premier assistant dans les données.
data	array	Liste d'objets agent.
object	string	Format des données, par exemple `"list"`.
request_id	string	ID de la requête.
status_code	integer	Code d'état de la requête.

Récupérer un agent

HTTP

Exemple de code

curl --location 'https://dashscope-intl.aliyuncs.com/api/v1/assistants/asst_0678aa33-43e2-4268-95e6-b0010f9f7937' \
--header 'Content-Type: application/json' \
--header "Authorization: Bearer $DASHSCOPE_API_KEY"

Paramètres de la requête

Nom du paramètre d'entrée	Description du paramètre d'entrée	Type	Obligatoire
assistant_id	ID de l'agent à récupérer.	str	Oui

Réponse

{
    "id": "asst_0678aa33-43e2-4268-95e6-b0010f9f7937",
    "object": "assistant",
    "created_at": 1711435564909,
    "model": "qwen-max",
    "name": "Intelligent Assistant",
    "description": "This is an intelligent assistant.",
    "instructions": "You are an intelligent assistant. You can call different tools based on user needs to provide answers. Use tools as needed.",
    "tools": [
        {
            "type": "search"
        },
        {
            "type": "text_to_image"
        },
        {
            "type": "code_interpreter"
        }
    ],
    "metadata": {},
    "request_id": "f0ec05b0-8813-984c-81b5-1166ae3478d1"
}

Paramètres de la réponse

L'objet assistant récupéré.

SDK

Exemple de code

python

from dashscope import Assistants
import dashscope
import os

dashscope.base_http_api_url = 'https://dashscope-intl.aliyuncs.com/api/v1'
assistant = Assistants.retrieve(
    assistant_id='your_assistant_id',
    # Set the environment variable. If you have not, replace the following line with your Model Studio API key: api_key="sk-xxx"
    api_key=os.getenv("DASHSCOPE_API_KEY")
)

print(assistant)

java

import com.alibaba.dashscope.assistants.Assistant;
import com.alibaba.dashscope.assistants.Assistants;
import com.alibaba.dashscope.exception.ApiException;
import com.alibaba.dashscope.exception.InputRequiredException;
import com.alibaba.dashscope.exception.InvalidateParameter;
import com.alibaba.dashscope.exception.NoApiKeyException;
import com.alibaba.dashscope.utils.Constants;

public class Main {
    static {
        Constants.baseHttpApiUrl="https://dashscope-intl.aliyuncs.com/api/v1";
    }
    public static void main(String[] args) throws ApiException, NoApiKeyException, InputRequiredException, InvalidateParameter, InterruptedException {
      Assistants assistants = new Assistants();
      // Set the environment variable. If you have not, replace the following line with your Model Studio API key: api_key="sk-xxx"
      String apiKey = System.getenv("DASHSCOPE_API_KEY");
      Assistant assistant = assistants.retrieve("assistant_id", apiKey);
    }
}

Paramètres de la requête

Paramètre	Type	Valeur par défaut	Description
assistant_id	string	-	ID de l'agent à récupérer.
workspace	string	None	ID de l'espace de travail Model Studio. Ce paramètre est requis uniquement si `api_key` correspond à une clé API de sous-espace de travail.
api_key	string	None	Clé API Model Studio. Pour plus d'informations, consultez Configurer la clé API comme variable d'environnement.

Paramètres de la réponse

Pour plus d'informations, consultez Objet Assistant.

Mettre à jour un agent

HTTP

Exemple de code

curl --location 'https://dashscope-intl.aliyuncs.com/api/v1/assistants/asst_0678aa33-43e2-4268-95e6-b0010f9f7937' \
--header 'Content-Type: application/json' \
--header "Authorization: Bearer $DASHSCOPE_API_KEY" \
--data '{
    "instructions": "You are a search assistant",
    "name": "New Application-assistantAPI",
    "description": "",
    "model": "qwen-max"
}'

Paramètres de la requête

Nom du paramètre d'entrée	Description du paramètre d'entrée	Type	Obligatoire
assistant_id	ID de l'agent à récupérer	str	Oui
*	Autres paramètres d'entrée facultatifs.	str	Non
model	ID du modèle utilisé par l'agent.	str	Oui
name	Nom de l'agent.	str	Non
description	Description de l'agent.	str	Non
instructions	Invite système pour le LLM de l'agent.	str	Non
tools	Liste des outils que l'agent peut appeler. Ces outils doivent être enregistrés dans Alibaba Cloud Model Studio.	Optional[List[Dict]]	Non (par défaut : [])
metadata	Stocke d'autres paramètres connexes pour l'agent.	Dict	Non

Réponse

{
    "id": "asst_0678aa33-43e2-4268-95e6-b0010f9f7937",
    "object": "assistant",
    "created_at": 1711435564909,
    "model": "qwen-max",
    "name": "New-Application-assistantAPI",
    "description": "",
    "instructions": "You are a search assistant.",
    "tools": [
        {
            "type": "search"
        },
        {
            "type": "text_to_image"
        },
        {
            "type": "code_interpreter"
        }
    ],
    "metadata": {},
    "request_id": "b0993831-a98b-9e71-b235-75174df9046e"
}

Paramètres de la réponse

L'objet assistant mis à jour.

SDK

Exemple de code

python

from dashscope import Assistants
import dashscope
import os

dashscope.base_http_api_url = 'https://dashscope-intl.aliyuncs.com/api/v1'
assistants = Assistants.update(
    'assistant_id',
    model='new_model_name',
    # Set the environment variable. If you have not, replace the following line with your Model Studio API key: api_key="sk-xxx"
    api_key=os.getenv("DASHSCOPE_API_KEY")
)

java

import com.alibaba.dashscope.assistants.Assistant;
import com.alibaba.dashscope.assistants.AssistantParam;
import com.alibaba.dashscope.assistants.Assistants;
import com.alibaba.dashscope.exception.ApiException;
import com.alibaba.dashscope.exception.InputRequiredException;
import com.alibaba.dashscope.exception.InvalidateParameter;
import com.alibaba.dashscope.exception.NoApiKeyException;
import com.alibaba.dashscope.utils.Constants;

public class Main {
    static {
        Constants.baseHttpApiUrl="https://dashscope-intl.aliyuncs.com/api/v1";
    }
    public static void main(String[] args) throws ApiException, NoApiKeyException, InputRequiredException, InvalidateParameter, InterruptedException {
        Assistants assistants = new Assistants();
        AssistantParam param = AssistantParam.builder()
                .model("qwen-max")
                .name("intelligent guide")
                .description("a smart guide")
                .instructions("You are a helpful assistant.  When asked a question, use tools wherever possible.")
                // Set the environment variable. If you have not, replace the following line with your Model Studio API key: api_key="sk-xxx"
                .apiKey(System.getenv("DASHSCOPE_API_KEY"))
                .build();

        Assistant assistant = assistants.update("assistant_id", param);
    }
}

Paramètres de la requête

Paramètre	Type	Valeur par défaut	Description
assistant_id	string	-	ID de l'assistant à mettre à jour.
model	string	-	Modèle utilisé par l'agent.
name	string	None	Nom de l'agent.
description	string	None	Description de l'agent.
instructions	string	None	Permet de spécifier les fonctionnalités de l'agent.
tools	array	[]	Outils utilisés par l'agent.
metadata	object	None	Informations associées à l'agent.
workspace	string	None	ID de l'espace de travail Model Studio. Ce paramètre est requis uniquement si `api_key` correspond à une clé API de sous-espace de travail.
api_key	string	None	Pour la clé API Alibaba Cloud Model Studio, nous vous recommandons de définir la clé API comme variable d'environnement.

Paramètres de la réponse

Pour plus d'informations, consultez Objet Assistant.

Supprimer un agent

HTTP

Exemple de code

curl --location --request DELETE 'https://dashscope-intl.aliyuncs.com/api/v1/assistants/asst_0678aa33-43e2-4268-95e6-b0010f9f7937' \
--header 'Content-Type: application/json' \
--header "Authorization: Bearer $DASHSCOPE_API_KEY"

Paramètres de la requête

Nom du paramètre d'entrée	Description	Type	Obligatoire
assistant_id	ID de l'agent à supprimer.	str	Oui

Réponse

{
    "id": "asst_0678aa33-43e2-4268-95e6-b0010f9f7937",
    "object": "assistant.deleted",
    "deleted": true,
    "request_id": "6af9320f-0430-9d01-b92f-d1beb6424dc5"
}

Paramètres de la réponse

Retourne l'état de l'agent supprimé.

SDK

Exemple de code

python

from dashscope import Assistants
import dashscope
import os

dashscope.base_http_api_url = 'https://dashscope-intl.aliyuncs.com/api/v1'
assistants = Assistants.delete(
    'assistant_id',
    # Set the environment variable. If you have not, replace the following line with your Model Studio API key: api_key="sk-xxx"
    api_key=os.getenv("DASHSCOPE_API_KEY")
)

java

import com.alibaba.dashscope.assistants.Assistants;
import com.alibaba.dashscope.common.DeletionStatus;
import com.alibaba.dashscope.exception.ApiException;
import com.alibaba.dashscope.exception.InputRequiredException;
import com.alibaba.dashscope.exception.InvalidateParameter;
import com.alibaba.dashscope.exception.NoApiKeyException;
import com.alibaba.dashscope.utils.Constants;

public class Main {
    static {
        Constants.baseHttpApiUrl="https://dashscope-intl.aliyuncs.com/api/v1";
    }
    public static void main(String[] args) throws ApiException, NoApiKeyException, InputRequiredException, InvalidateParameter, InterruptedException {
        Assistants assistants = new Assistants();
        // Set the environment variable. If you have not, replace the following line with your Model Studio API key: api_key="sk-xxx"
        String apiKey = System.getenv("DASHSCOPE_API_KEY");
        DeletionStatus assistant = assistants.delete("assistant_id", apiKey);
    }
}

Paramètres de la requête

Paramètre	Type	Valeur par défaut	Description
assistant_id	string	-	ID de l'agent à supprimer.
workspace	string	None	ID de l'espace de travail Model Studio. Ce paramètre est requis uniquement si `api_key` correspond à une clé API de sous-espace de travail.
api_key	string	None	Pour votre clé API Alibaba Cloud Model Studio, nous vous recommandons de la définir comme variable d'environnement (Cette rubrique sera supprimée et fusionnée dans 'Configurer la clé API').

Paramètres de la réponse

Nom du champ	Type	Description
id	string	ID de l'objet supprimé.
object	string	Cible de la requête. Exemple : `'assistant.deleted'`
deleted	boolean	Confirmation de la suppression
request_id	string	ID de la requête.
status_code	integer	Code d'état de la requête.

Objet Agent

Un objet Assistant capable d'appeler des modèles et d'utiliser des outils.

Exemple d'objet Agent

{
    "id": "asst_49079f4b-d1e8-4015-a12e-2dcdd1f18d84",
    "object": "assistant",
    "created_at": 1711713885724,
    "model": "qwen-max",
    "name": "Intelligent Assistant",
    "description": "This is an intelligent assistant.",
    "instructions": "You are an intelligent assistant. You can call different tools based on user needs to provide answers. Use tools as needed.",
    "tools": [
        {
            "type": "code_interpreter"
        }
    ],
    "metadata": {},
    "temperature": null,
    "top_p": null,
    "top_k": null,
    "max_tokens": null,
    "request_id": "b1778226-3865-9006-9e95-56329a710322"
}

Nom du paramètre	Type de données	Description
id	string	Identifiant unique de l'agent, correspondant à l'ID de l'assistant.
object	string	Type d'objet. Toujours `assistant`.
created_at	integer	Horodatage Unix à 13 chiffres, en millisecondes, indiquant la date de création de l'agent.
model	string	Nom du modèle utilisé par l'agent. Consultez la Présentation de l'API Assistant pour voir tous les modèles disponibles, ou référez-vous à la Liste des modèles pour plus de détails.
name	string	Nom de l'agent.
description	string	Description de l'agent.
instructions	string	Instructions système utilisées par l'agent.
tools	array	Liste des outils activés sur l'agent. L'outil peut être un plugin officiel (tel que `code_interpreter`, `quark_search` ou `text_to_image`), une génération augmentée par récupération (RAG) ou un appel de fonction.
metadata	dict	Informations supplémentaires sur l'objet agent, stockées dans un format structuré.
temperature	float	Température d'échantillonnage, comprise entre 0 et 2. Une valeur élevée, comme 1, rend la sortie plus aléatoire. Une valeur faible, comme 0,2, rend la sortie plus ciblée et déterministe.
top_p	float	Alternative à l'échantillonnage par température, appelée échantillonnage par noyau. Dans cette méthode, le LLM sélectionne les résultats de tokens dont la masse de probabilité cumulative atteint `top_p`. Une valeur de 0,1 signifie que seuls les tokens constituant les 10 % supérieurs de la masse de probabilité sont pris en compte. Ajustez ce paramètre ou `temperature`, mais pas les deux simultanément.
top_k	integer	Similaire à `top_p`, mais l'échantillon est sélectionné parmi les k tokens ayant la probabilité la plus élevée, indépendamment de leur masse de probabilité cumulative. N'ajustez pas ce paramètre en même temps que `temperature` ou `top_p`.
max_tokens	integer	Nombre maximal de tokens que l'agent peut générer en une seule fois.
request_id	string	Identifiant unique de l'appel associé à l'agent.

Codes d'erreur

Si un appel de modèle échoue et renvoie un message d'erreur, consultez les Codes d'erreur pour obtenir des informations de dépannage.