Saltar al contenido principal

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.

Utiliza el recurso de Conversaciones cuando quieras que la API de MKA1 mantenga el estado de la conversación entre solicitudes de Respuestas. Esto es útil para chats de varios turnos, hilos de soporte y flujos de trabajo donde quieras recuperar o editar el historial guardado más adelante.

​
Crear una conversación

Crea primero una conversación. Puedes adjuntar metadatos para mantener tu propio contexto de sesión o enrutamiento. 
mka1 llm conversations create \
  -H 'X-On-Behalf-Of: <end-user-id>' \
  --body '{
    "metadata": {
      "session_id": "web-42",
      "channel": "support"
    }
  }'
Si tu solicitud no está asociada a un usuario final específico, omite X-On-Behalf-Of. Consulta la guía de autenticación para ver el patrón completo.

​
Agregar elementos a la conversación

Agrega uno o más elementos con POST /api/v1/llm/conversations/{conversation_id}/items. 
mka1 llm conversations create-items \
  --conversation-id conv_abc123 \
  --body '{
    "items": [
      {
        "type": "message",
        "role": "user",
        "content": "Summarize the latest support ticket."
      }
    ]
  }'
Utiliza este endpoint cuando quieras escribir el historial explícitamente antes de llamar al recurso de Respuestas.

​
Continuar el flujo con el recurso de Respuestas

Pasa el ID de la conversación en tu siguiente solicitud de Respuestas. Esto permite que la API de MKA1 utilice el estado de conversación guardado. 
mka1 llm responses create \
  --model meetkai:functionary-es-mini \
  --conversation conv_abc123 \
  --input '"Turn that summary into a customer-ready reply."'
También puedes seguir agregando elementos a la misma conversación a medida que crece el intercambio.

​
Leer, actualizar o limpiar una conversación

Utiliza los endpoints de Conversaciones para:
  • Listar conversaciones para la cuenta actual o usuario final (GET /api/v1/llm/conversations).
  • Filtrar listas con after, limit, order, metadata y search.
  • Obtener una conversación por ID (GET /api/v1/llm/conversations/{conversation_id}).
  • Actualizar los metadatos de la conversación (POST /api/v1/llm/conversations/{conversation_id}).
  • Listar elementos en una conversación (GET /api/v1/llm/conversations/{conversation_id}/items).
  • Obtener un solo elemento (GET /api/v1/llm/conversations/{conversation_id}/items/{item_id}).
  • Eliminar elementos (uno o varios) mediante:
    • DELETE /api/v1/llm/conversations/{conversation_id}/items/{item_id}
    • DELETE /api/v1/llm/conversations/{conversation_id}/items con { "item_ids": ["item_..."] }
  • Eliminar la conversación (DELETE /api/v1/llm/conversations/{conversation_id}).
Nota: eliminar una conversación no elimina sus elementos. Utiliza la pestaña de Referencia de API para ver la forma exacta de las solicitudes y respuestas de cada operación.

​
Cuándo usar conversaciones vs previous_response_id

Utiliza una conversación cuando:
  • Quieres un contenedor reutilizable para muchos turnos.
  • Necesitas listar o gestionar los elementos guardados más tarde.
  • Quieres adjuntar metadatos al hilo en curso.
Utiliza previous_response_id cuando:
  • Solo necesitas continuar desde una respuesta anterior.
  • No necesitas un recurso de conversación almacenado por separado.
Para el patrón del lado de la respuesta, consulta generar una respuesta.