Créer un ID de conversation

Utilisé pour demander la création et obtenir un conversation_id, qui est l'identifiant de la conversation entre l'utilisateur et l'Agent. Les attributs utilisateur, la mémoire à long terme et la mémoire à court terme sont tous associés au conversation_id.

Nom de l'ID	Description
conversation_id	Un identifiant de conversation généré conjointement par `agent_id` et `user_id`, utilisé pour effectuer une conversation multi-tours entre l'utilisateur et l'Agent. Un seul `conversation_id` contient généralement plusieurs `message_id`.
message_id	Un identifiant de message généré conjointement par les `messages envoyés par l'utilisateur` et les `messages de réponse de l'Agent`, représentant un tour de conversation entre l'utilisateur et l'Agent. Le `message_id` doit appartenir à un `conversation_id`.

Méthode de requête

POST

URL de la requête

https://api-${endpoint}.gptbots.ai/v1/conversation

Authentification de la requête

Consultez Présentation de l'API pour les instructions d'authentification.

Requête

Exemple de requête

curl -X POST 'https://api-${endpoint}.gptbots.ai/v1/conversation' \ -H 'Authorization: Bearer ${API Key}' \ -H 'Content-Type: application/json' \ -d '{ "user_id": "your_user_id" }'

                      
                      curl -X POST 'https://api-${endpoint}.gptbots.ai/v1/conversation' \
  -H 'Authorization: Bearer ${API Key}' \
  -H 'Content-Type: application/json' \
  -d '{
        "user_id": "your_user_id"
}'

Ce bloc de code dans la fenêtre flottante

En-têtes de la requête

Champ	Type	Description
Authorization	Bearer ${API Key}	Utilisez Authorization: Bearer ${API Key} pour l'authentification. Obtenez la clé API depuis la page Clé API.
Content-Type	application/json	Type de données, à définir sur application/json.

Paramètres de la requête

Champ	Type	Obligatoire	Description
user_id	string	Oui	ID utilisateur défini par le développeur pour identifier de façon unique un utilisateur dans l'Agent. Longueur maximale de 32 caractères.

Réponse

Exemple de réponse

{ "conversation_id": "657303a8a764d47094874bbe" }

                      
                      {
  "conversation_id": "657303a8a764d47094874bbe" 
}

Ce bloc de code dans la fenêtre flottante

Réponse réussie

Champ	Type	Description
conversation_id	string	Identifiant de conversation.

Réponse en cas d'échec

Champ	Type	Description
code	int	Code d'erreur.
message	string	Détails de l'erreur.

Codes d'erreur

Code	Message
40000	Erreur de paramètre
40127	Échec de l'authentification du développeur
40378	Agent supprimé