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 API de Prompts te permite almacenar, versionar y gestionar plantillas de prompts de forma centralizada. Cada cambio en la plantilla crea una versión inmutable, dándote un historial completo de cambios con la capacidad de revertir a cualquier versión anterior en cualquier momento. Las plantillas admiten marcadores de posición {{variable}} que se renderizan del lado del servidor cuando recuperas un prompt, por lo que puedes reutilizar la misma plantilla en diferentes contextos.

​
Crear un prompt

Crea un prompt con un nombre y una plantilla. La primera versión se crea automáticamente. 
mka1 llm prompts create \
  --body '{
    "name": "greeting",
    "description": "Una plantilla de saludo simple",
    "template": "Hello, {{name}}! Welcome to {{company}}.",
    "metadata": { "team": "onboarding" }
  }' \
  -H 'X-On-Behalf-Of: <end-user-id>'

​
Recuperar un prompt con variables renderizadas

Pasa variables como parámetro de consulta para renderizar la plantilla con tus valores. Los marcadores de posición no coincidentes se dejan tal cual. 
mka1 llm prompts get \
  --id prompt_abc123 \
  --variables '{"name":"Alice","company":"Acme"}'

​
Listar prompts

Recupera una lista paginada de todos los prompts. Usa after para paginación basada en cursor. 
mka1 llm prompts list --limit 10 --order desc

​
Actualizar metadatos del prompt

Actualiza el nombre, la descripción o los metadatos de un prompt. Para cambiar la plantilla, crea una nueva versión en su lugar. 
mka1 llm prompts update \
  --id prompt_abc123 \
  --body '{
    "name": "welcome-greeting",
    "description": "Saludo actualizado para el flujo de bienvenida",
    "metadata": { "team": "onboarding", "reviewed": true }
  }'

​
Crear una nueva versión

Cada cambio en la plantilla crea una nueva versión. La nueva versión se activa automáticamente. 
mka1 llm prompts create-version \
  --id prompt_abc123 \
  --body '{
    "template": "Hi {{name}}! Welcome aboard at {{company}}. Your onboarding starts {{date}}."
  }'

​
Ver historial de versiones

Lista todas las versiones de un prompt para ver su historial completo de cambios. 
mka1 llm prompts list-versions --id prompt_abc123 --order desc

​
Recuperar una versión específica

Obtén una versión concreta por su número de versión. 
mka1 llm prompts get-version --id prompt_abc123 --version-param 1

​
Revertir a una versión anterior

La reversión establece una versión anterior como la versión activa. Todas las versiones se conservan — la reversión no elimina las versiones más recientes, por lo que siempre puedes volver a avanzar. 
# Actualmente en la versión 2, volver a la versión 1
mka1 llm prompts rollback --id prompt_abc123 --version-param 1

​
Eliminar un prompt

Eliminar un prompt lo elimina a él y a todas sus versiones de forma permanente. 
mka1 llm prompts delete --id prompt_abc123

​
Ejemplo completo: flujo de trabajo de versionado y reversión

Este ejemplo demuestra el ciclo de vida completo — crear un prompt, iterar sobre la plantilla, revisar el historial y revertir. 
# 1. Crear un prompt con la plantilla inicial
mka1 llm prompts create \
  --body '{
    "name": "support-reply",
    "template": "Hi {{customer}}, thanks for contacting us about {{issue}}."
  }'
# → { "id": "prompt_abc123", "active_version": 1, ... }

# 2. Publicar v2 con un tono más amigable
mka1 llm prompts create-version \
  --id prompt_abc123 \
  --body '{
    "template": "Hey {{customer}}! We got your message about {{issue}} and are on it."
  }'

# 3. Recuperar el prompt con variables renderizadas
mka1 llm prompts get \
  --id prompt_abc123 \
  --variables '{"customer":"Alice","issue":"billing"}'

# 4. Revisar el historial de versiones
mka1 llm prompts list-versions --id prompt_abc123 --order asc

# 5. Revertir a v1
mka1 llm prompts rollback --id prompt_abc123 --version-param 1

# 6. Limpiar
mka1 llm prompts delete --id prompt_abc123

​
Detalles de comportamiento

AspectoDetalle
VersionadoInmutable — cada cambio en la plantilla crea una nueva versión que no puede ser modificada
Versión activaLas nuevas versiones se activan automáticamente; usa la reversión para cambiar a otra versión
ReversiónNo destructiva — establece active_version sin eliminar versiones más recientes
PaginaciónBasada en cursor para listar prompts — usa el parámetro after con first_id/last_id de la respuesta
Renderizado de plantillasDel lado del servidor — pasa el parámetro de consulta variables; los marcadores no coincidentes se conservan
PropiedadPor clave de API — los prompts están aislados por contexto de autenticación
ConcurrenciaDetección de conflictos — la creación concurrente de versiones devuelve 409

​
Próximos pasos