Evaluación de feedback del agente

Permite al personal de desarrollo y operaciones inspeccionar y evaluar la calidad del contenido generado por el agente, para analizar la eficacia de las respuestas y orientar la optimización posterior.

Método de solicitud

POST

Endpoint

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

Autenticación

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/message/quality' \ -H 'Authorization: Bearer ${API Key}' \ -H 'Content-Type: application/json' \ -d '{ "answer_id": "123456789", "quality": "FULLY_RESOLVED" }'

                      
                      curl -X POST 'https://api-${endpoint}.gptbots.ai/v1/message/quality' \
-H 'Authorization: Bearer ${API Key}' \
-H 'Content-Type: application/json' \
-d '{
        "answer_id": "123456789",
        "quality": "FULLY_RESOLVED"
}'

Este bloque de código en una ventana flotante

Cabeceras de la solicitud

Encabezado	Tipo	Descripción
Authorization	Bearer ${API Key}	Para autenticación, se utiliza el encabezado `Authorization: Bearer ${API Key}`. La clave de API se obtiene en la página «API Key».
Content-Type	application/json	Tipo de datos; el valor debe ser `application/json`.

Parámetros de la solicitud

Campo	Tipo	Obligatorio	Descripción
answer_id	string	Sí	ID de la respuesta generada por el agente.
quality	string	Sí	Evaluación de control de calidad de la respuesta del agente. Valores posibles: - NONE: Sin feedback - UNRESOLVED: Sin resolver - PARTIALLY_RESOLVED: Resuelto parcialmente - FULLY_RESOLVED: Resuelto totalmente

Respuesta

Ejemplo de respuesta

{ "affectCount": 2 }

                      
                      {
    "affectCount": 2
}

Este bloque de código en una ventana flotante

Respuesta correcta

Campo	Tipo	Descripción
affectCount	long	Número de evaluaciones correctas en esta solicitud. Un valor de 2 indica que se han registrado correctamente 2 evaluaciones.

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	Parámetro no válido
40127	Error de autenticación del desarrollador
20059	El agente ha sido eliminado