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.

La herramienta history otorga a los modelos memoria a largo plazo que persiste entre sesiones. Cuando está habilitada, cada par de solicitud-respuesta se almacena e indexa automáticamente. El modelo puede luego buscar semánticamente en interacciones pasadas para recordar información de conversaciones anteriores.

Cómo funciona

  1. Agrega { type: "history" } al array tools en tu solicitud
  2. El modelo recibe una función history que puede llamar con una consulta de búsqueda
  3. Las conversaciones pasadas se buscan usando incrustaciones vectoriales para similitud semántica
  4. Después de cada respuesta, el mensaje del usuario y la respuesta del asistente se almacenan automáticamente en segundo plano
La memoria está delimitada por usuario final — cada ID de usuario X-On-Behalf-Of obtiene un historial aislado. Diferentes usuarios finales no pueden ver el historial de otros.

Habilitar la herramienta de historial

mka1 llm responses create \
  --model meetkai:functionary-es-mini \
  --body '{
    "input": "Recuerda esto: mi color favorito es azul.",
    "tools": [{ "type": "history" }],
    "store": true
  }' \
  -H 'X-On-Behalf-Of: <end-user-id>'
Establece store: true para que la conversación se persista y esté disponible para futuras consultas.

Recordar información de una sesión anterior

En una solicitud posterior — incluso minutos, horas o días después — el modelo puede buscar en su historial para encontrar interacciones pasadas relevantes. El modelo decide cuándo llamar a la herramienta de historial según la pregunta del usuario.
mka1 llm responses create \
  --model meetkai:functionary-es-mini \
  --body '{
    "input": "¿Cuál es mi color favorito?",
    "tools": [{ "type": "history" }],
    "store": true
  }'

Ejemplo completo: almacenar y recuperar entre sesiones

Este ejemplo muestra el flujo completo — almacenar información en una solicitud y recuperarla en una solicitud separada.
# Sesión 1: Dile al modelo algo para recordar
mka1 llm responses create \
  --model meetkai:functionary-es-mini \
  --body '{
    "input": "Recuerda esto: la fecha límite del proyecto es el 15 de marzo y el presupuesto es de $50,000.",
    "tools": [{ "type": "history" }],
    "store": true
  }'

# Sesión 2: Pregunta sobre ello después
mka1 llm responses create \
  --model meetkai:functionary-es-mini \
  --body '{
    "input": "¿Cuál es la fecha límite del proyecto y el presupuesto?",
    "tools": [{ "type": "history" }],
    "store": true
  }'

Detalles del comportamiento

AspectoDetalle
AlmacenamientoAutomático — cada par solicitud/respuesta se indexa después de la respuesta
BúsquedaSemántica — usa incrustaciones vectoriales, no coincidencia por palabras clave
AlcancePor usuario final — aislado por el encabezado X-On-Behalf-Of
IndexaciónEn segundo plano — no añade latencia a la respuesta
ResultadosHasta 10 interacciones pasadas más relevantes devueltas por búsqueda
Tamaño de entradaEl texto se trunca a 7,500 caracteres por entrada para incrustación

Cuándo usar la herramienta de historial

  • Personalización: Recordar preferencias del usuario, nombres o contexto entre sesiones
  • Continuidad de proyectos: Recordar decisiones, fechas límite o requisitos discutidos previamente
  • Flujos de soporte: Mantener contexto sobre el historial de incidencias de un usuario
  • Asistentes: Construir asistentes que aprendan y se adapten a usuarios individuales con el tiempo

Próximos pasos