Skip to main content

Threads (Deprecated)

Cette rubrique décrit la classe Thread de l'API Assistant, ainsi que les méthodes pour créer, récupérer, modifier et supprimer des threads.

L'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 sur plusieurs tours.
Vue d'ensemble : Pour plus d'informations sur les fonctionnalités et l'utilisation de base de l'API Assistant, reportez-vous à la Vue d'ensemble de l'API Assistant .
Durée de conservation : Toutes les instances Thread sont stockées sur le serveur Alibaba Cloud Model Studio et n'expirent pas. Utilisez l'ID du thread pour récupérer les informations de contexte.


Nom de la fonction


Type


create


Crée une classe Thread.


retrieve


Récupère une classe Thread.


update


Modifie une classe Thread.


delete


Supprime une classe Thread.

Créer un thread

  • HTTP
  • SDK
Exemple de code
curl --location 'https://dashscope-intl.aliyuncs.com/api/v1/threads' \
--header 'Content-Type: application/json' \
--header "Authorization: Bearer $DASHSCOPE_API_KEY" \
--data '{
    "messages": [
        {
            "role": "user",
            "content": "hello"
        }
    ]
}'
Paramètres de la requête


Nom du paramètre d'entrée


Description du paramètre d'entrée


Type


Obligatoire


messages


Messages transmis au thread.


Classe Message


Non


metadata


Nom du thread


object


Non

Réponse
{
    "id": "thread_e99a9fe7-0433-426f-98ad-a5139c36579c",
    "object": "thread",
    "created_at": 1711448377850,
    "metadata": {},
    "request_id": "dd9489ec-dbdb-95d4-9ff8-cfe29b61db27"
}
Paramètres de la réponseLa réponse renvoie un objet thread contenant les champs supplémentaires suivants :
  • id : ID du thread.
  • request_id : ID de la requête.

Récupérer un thread

  • HTTP
  • SDK
Exemple de code
curl --location 'https://dashscope-intl.aliyuncs.com/api/v1/threads/thread_c7ebb0ca-2e4f-43e5-b223-6e1f8c6fccc7' \
--header 'Content-Type: application/json' \
--header "Authorization: Bearer $DASHSCOPE_API_KEY"
Paramètres de la requête


Nom du paramètre


Description du paramètre


Type


Obligatoire


thread_id


ID du thread à récupérer.


str


Oui

Résultat
{
    "id": "thread_c7ebb0ca-2e4f-43e5-b223-6e1f8c6fccc7",
    "object": "thread",
    "created_at": 1711507920700,
    "metadata": {},
    "request_id": "4d4e73ad-15fb-96ac-9262-0643a0fdb5ca"
}
Paramètres de la réponseLa réponse contient l'objet thread récupéré, qui inclut les champs supplémentaires suivants :
  • ID : ID du thread
  • request_id : ID de la requête.

Modifier un thread

  • HTTP
  • SDK
Exemple de code
curl --location 'https://dashscope-intl.aliyuncs.com/api/v1/threads/thread_c7ebb0ca-2e4f-43e5-b223-6e1f8c6fccc7' \
--header 'Content-Type: application/json' \
--header "Authorization: Bearer $DASHSCOPE_API_KEY" \
--data '{
    "metadata": {
        "modified": "true",
        "user": "abc123"
    }
}'
Paramètres de la requête


Nom du paramètre d'entrée


Description du paramètre d'entrée


Type


Obligatoire


thread_id


ID du thread à modifier.


str


Oui


metadata


Nom du thread


dict


Non

Résultat
{
    "id": "thread_c7ebb0ca-2e4f-43e5-b223-6e1f8c6fccc7",
    "object": "thread",
    "created_at": 1711507920700,
    "metadata": {
        "modified": "true",
        "user": "abc123"
    },
    "request_id": "a9ad63fa-b884-94be-9ec6-5000882de3c4"
}
Paramètres de la réponseLa sortie contient la classe thread récupérée ainsi que des champs supplémentaires non spécifiés dans les paramètres fournis par l'utilisateur :
  • id : thread_id
  • request_id : ID de la requête.

Supprimer un thread

  • HTTP
  • SDK
Exemple de code
curl --location --request DELETE 'https://dashscope-intl.aliyuncs.com/api/v1/threads/thread_c7ebb0ca-2e4f-43e5-b223-6e1f8c6fccc7' \
--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


id


ID du thread à supprimer


str


Oui

Réponse
{
    "id": "thread_c7ebb0ca-2e4f-43e5-b223-6e1f8c6fccc7",
    "object": "thread.deleted",
    "deleted": true,
    "request_id": "b4edb7b8-5855-9787-b5c3-0374ee2b3b2c"
}
Paramètres de la réponseÉtat du thread après suppression.

Codes d'erreur

Si un appel de modèle échoue et qu'un message d'erreur est retourné, consultez la rubrique Codes d'erreur pour le dépannage.