Crear el ID de conversación

Se utiliza para solicitar la creación de un conversation_id y obtenerlo, que es el identificador de la conversación entre el usuario y el Agent. Los atributos del usuario, la memoria a largo plazo y la memoria a corto plazo están asociados al conversation_id.

Nombre del ID	Descripción
conversation_id	Identificador de conversación generado a partir de `agent_id` y `user_id`, utilizado para llevar a cabo una conversación de varios turnos entre el usuario y el Agent. Un único `conversation_id` suele contener varios `message_id`s.
message_id	Identificador de mensaje generado a partir de los mensajes enviados por el usuario y de las respuestas del Agent, que representa una única ronda de conversación entre el usuario y el Agent. El `message_id` debe pertenecer a un `conversation_id`.

Método de solicitud

POST

URL de solicitud

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

Autenticación de la solicitud

Consulte Visión general de la API para obtener instrucciones de autenticación.

Solicitud

Ejemplo de solicitud

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"
}'

Este bloque de código en una ventana flotante

Cabeceras de la solicitud

Campo	Tipo	Descripción
Authorization	string	Para autenticación, se usa `Authorization: Bearer ${API Key}`. La clave de API se obtiene en la página «API Key».
Content-Type	application/json	Tipo de datos; se establece en `application/json`.

Parámetros de la solicitud

Campo	Tipo	Obligatorio	Descripción
user_id	string	Sí	ID de usuario definido por el desarrollador para identificar de forma única a un usuario en el Agent. Longitud máxima: 32 caracteres.

Respuesta

Ejemplo de respuesta

{ "conversation_id": "657303a8a764d47094874bbe" }

                      
                      {
  "conversation_id": "657303a8a764d47094874bbe" 
}

Este bloque de código en una ventana flotante

Respuesta de éxito

Campo	Tipo	Descripción
conversation_id	string	Identificador de conversación.

Respuesta de error

Campo	Tipo	Descripción
code	int	Código de error.
message	string	Detalles del error.

Códigos de error

Código	Mensaje
40000	Error de parámetro
40127	Error de autenticación del desarrollador
40378	Agente eliminado