Pular para o conteúdo principal
POST
/
api
/
v1
/
llm
/
feedback
/
completions
Python (SDK)
from mka1 import SDK


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

    res = sdk.llm.feedback.create_completion_feedback(id="chatcmpl-abc123def456", rating="thumbs_up", description="The response was accurate and helpful.")

    # Handle response
    print(res)
{
  "id": "chatcmpl-abc123def456",
  "rating": "thumbs_up",
  "description": "The response was accurate and helpful.",
  "createdAt": "2024-01-15T10:30:00Z",
  "updatedAt": "2024-01-15T10:30:00Z"
}

Documentation Index

Fetch the complete documentation index at: https://docs.mka1.com/llms.txt

Use this file to discover all available pages before exploring further.

Autorizações

​
Authorization
string
header
obrigatório

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>.

Cabeçalhos

​
X-On-Behalf-Of
string

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

Corpo

application/json

Parâmetros de solicitação para criar feedback. Permite que os usuários avaliem e comentem sobre as saídas do modelo.

​
id
string
obrigatório

ID de solicitação para associar este feedback. Use o ID da solicitação de conclusão do chat ou o ID da resposta.

​
rating
enum<string>

Classificação de feedback opcional. Pode ser 'positivo' para feedback positivo ou 'negativo' para feedback negativo.

Opções disponíveis:
thumbs_up,
thumbs_down
​
description
string

Descrição detalhada de feedback opcional. Use isso para fornecer comentários específicos, sugestões ou explicar a avaliação (máx. 2000 caracteres).

Maximum string length: 2000

Resposta

201 - application/json

OK

Resposta contendo a entrada de feedback criada com ID gerado e timestamps.

​
id
string
obrigatório

O ID do pedido com o qual este feedback está associado.

​
rating
enum<string>

A classificação de feedback indicando a satisfação do usuário

Opções disponíveis:
thumbs_up,
thumbs_down
​
description
string

Descrição detalhada de feedback opcional, fornecendo contexto ou explicação adicional (máx. 2000 caracteres)

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

Carimbo de data/hora quando o feedback foi criado

​
updatedAt
string<date-time>

Timestamp quando o feedback foi atualizado pela última vez