Saltar al contenido principal
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.

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.

Listar prompts

Recupera una lista paginada de todos los prompts. Usa after para paginación basada en cursor.

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.

Crear una nueva versión

Cada cambio en la plantilla crea una nueva versión. La nueva versión se activa automáticamente.

Ver historial de versiones

Lista todas las versiones de un prompt para ver su historial completo de cambios.

Recuperar una versión específica

Obtén una versión concreta por su número de versión.

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.

Eliminar un prompt

Eliminar un prompt lo elimina a él y a todas sus versiones de forma permanente.

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.

Detalles de comportamiento

Próximos pasos