Les étapes d'exécution décrivent les actions qu'un agent effectue lors d'une exécution, y compris les appels de modèle et d'outils.
Lister les étapes d'exécution
Renvoie la liste de toutes les étapes d'une tâche d'exécution.
Exemple de requête
- HTTP
- SDK
Corps de la requête
Nom du paramètre | Type | Obligatoire | Valeur par défaut | Description |
|---|---|---|---|---|
run_id | string | Oui | ID de l'exécution dont vous souhaitez lister les étapes. | |
thread_id | string | Oui | ID du thread. | |
limit | integer | Non | None | Nombre d'étapes d'exécution à récupérer. La valeur par défaut est None. Une valeur None applique la valeur par défaut du serveur. |
order | string | Non | None | Ordre de tri des résultats basé sur le champ created_at. Définissez ce paramètre sur asc (croissant) ou desc (décroissant). La valeur par défaut est None, ce qui applique le tri par défaut du serveur. |
after | string | Non | None | ID de l'étape d'exécution à utiliser comme curseur pour la pagination. Si fourni, renvoie la page de résultats située immédiatement après cette étape. |
before | string | Non | None | ID de l'étape d'exécution à utiliser comme curseur pour la pagination. Si fourni, renvoie la page de résultats située immédiatement avant cette étape. |
workspace | string | Oui | None | L'ID de l'espace de travail pour Alibaba Cloud Model Studio est requis uniquement si la |
api_key | string | Oui | None | L'API Key de Model Studio. Nous vous recommandons de configurer l'API Key en tant que variable d'environnement. |
Exemple de réponse
Corps de la réponse
Une liste d'objets d'étape d'exécution
Récupérer une étape d'exécution
Exemple de requête
- HTTP
- SDK
Corps de la requête
Nom du paramètre | Type | Obligatoire | Valeur par défaut | Description |
|---|---|---|---|---|
step_id | string | Oui | ID de l'étape d'exécution (RunStep) à récupérer. | |
thread_id | string | Oui | ID du thread. | |
run_id | string | Oui | ID de l'exécution. | |
workspace | string | Oui | None | L'ID de l'espace de travail pour Alibaba Cloud Model Studio est requis uniquement si vous utilisez une API Key de sous-espace de travail. |
api_key | string | Oui | None | L'API Key de Model Studio. Nous vous recommandons de configurer l'API Key en tant que variable d'environnement. |
Exemple de réponse
Corps de la réponse
L'objet d'étape d'exécution correspondant à l'ID spécifié.
Objet d'étape d'exécution
Représente une étape du processus d'exécution d'une tâche.
Exemple d'objet
Attributs de l'objet
Nom du paramètre | Type | Description |
|---|---|---|
id | string | Identifiant unique de l'étape d'exécution, pouvant être référencé dans les endpoints d'API. |
assistant_id | string | ID de l'assistant associé à cette étape d'exécution. |
cancelled_at | integer | Horodatage UNIX à 13 chiffres (en millisecondes) indiquant l'annulation de l'étape d'exécution. |
completed_at | integer | Horodatage UNIX à 13 chiffres (en millisecondes) indiquant la fin de l'étape d'exécution. |
created_at | integer | Horodatage UNIX à 13 chiffres (en millisecondes) indiquant la création de l'étape d'exécution. |
expired_at | integer | Horodatage UNIX à 13 chiffres (en millisecondes) indiquant l'expiration de l'étape d'exécution. Si l'exécution parente a expiré, l'étape est également considérée comme expirée. |
failed_at | integer | Horodatage UNIX à 13 chiffres (en millisecondes) indiquant l'échec de l'étape d'exécution. |
last_error | object | Dernière erreur associée à cette étape d'exécution. Ce paramètre est null si aucune erreur ne s'est produite. |
metadata | map | Ensemble de 16 paires clé-valeur maximum pouvant être attachées à l'objet. Permet de stocker des informations supplémentaires structurées sur l'objet. La longueur maximale d'une clé est de 64 caractères et celle d'une valeur est de 512 caractères. |
object | string | Type d'objet, toujours thread.run.step. |
run_id | string | ID de l'exécution à laquelle appartient cette étape. |
status | string | Statut de l'étape d'exécution. Valeurs valides : in_progress, cancelled, failed, completed ou expired. |
step_details | object | Détails de l'étape d'exécution. |
thread_id | string | ID du thread en cours d'exécution. |
type | string | Type de l'étape d'exécution. Valeurs valides : message_creation ou tool_calls. |
usage | object | Statistiques d'utilisation des ressources. |
status_code | integer | Code de statut HTTP. Remarque : Ce paramètre sert au traitement interne. Dans la plupart des cas, vous pouvez l'ignorer. |