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.
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.
- 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
- SDK
| 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é. | 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 |
Lister les agents
Retourne une liste d'assistants.
- HTTP
- SDK
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 : |
Récupérer un agent
- HTTP
- SDK
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 |
Mettre à jour un agent
- HTTP
- SDK
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 |
Supprimer un agent
- HTTP
- SDK
Nom du paramètre d'entrée | Description | Type | Obligatoire |
assistant_id | ID de l'agent à supprimer. | str | Oui |
Objet Agent
Un objet Assistant capable d'appeler des modèles et d'utiliser des outils.
Exemple d'objet Agent
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 |
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 |
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 Ajustez ce paramètre ou |
top_k | integer | Similaire à N'ajustez pas ce paramètre en même temps que |
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. |