Saltar al contenido principal
POST
/
api
/
v1
/
llm
/
feedback
/
responses
Python (SDK)
from mka1 import SDK


with SDK(
    bearer_auth="<YOUR_BEARER_TOKEN_HERE>",
) as sdk:

    res = sdk.llm.feedback.create_response_feedback(id="resp-xyz789", rating="thumbs_down", description="The response missed key details.")

    # Handle response
    print(res)
{
  "id": "resp-xyz789",
  "rating": "thumbs_down",
  "description": "The response missed key details.",
  "createdAt": "2024-01-15T10:30:00Z",
  "updatedAt": "2024-01-15T10:30:00Z"
}

Autorizaciones

​
Authorization
string
header
requerido

Gateway auth: send Authorization: Bearer <mka1-api-key>. For multi-user server-side integrations, you can also send X-On-Behalf-Of: <external-user-id>.

Encabezados

​
X-On-Behalf-Of
string

Optional external end-user identifier forwarded by the API gateway.

Cuerpo

application/json

Parámetros de solicitud para crear comentarios. Permite a los usuarios calificar y comentar sobre las salidas del modelo.

​
id
string
requerido

ID de solicitud para asociar este feedback. Utilice el ID de solicitud de completación de chat o el ID de respuesta.

​
rating
enum<string>

Calificación de retroalimentación opcional. Puede ser 'pulgar_arriba' para retroalimentación positiva o 'pulgar_abajo' para retroalimentación negativa.

Opciones disponibles:
thumbs_up,
thumbs_down
​
description
string

Descripción detallada de comentarios opcionales. Utiliza esto para proporcionar comentarios específicos, sugerencias o explicar la calificación (máx. 2000 caracteres).

Maximum string length: 2000

Respuesta

201 - application/json

Está bien

Respuesta que contiene la entrada de retroalimentación creada con ID generado y marcas de tiempo.

​
id
string
requerido

El ID de solicitud con el que se asocia este comentario.

​
rating
enum<string>

La calificación de retroalimentación que indica la satisfacción del usuario.

Opciones disponibles:
thumbs_up,
thumbs_down
​
description
string

Descripción detallada opcional de comentarios que proporciona contexto o explicación adicional (máx. 2000 caracteres)

Maximum string length: 2000
​
createdAt
string<date-time>

Marca de tiempo cuando se creó la retroalimentación

​
updatedAt
string<date-time>

Marca de tiempo cuando se actualizó por última vez la retroalimentación