Versiones del Prompt

Cada escritura o edición del prompt crea una nueva versión en el historial del agente. Estos endpoints permiten inspeccionarlo — útil para auditoría o para restaurar versiones anteriores (haciendo un POST /prompt con el contenido devuelto).

Listar Versiones del Prompt

GET https://api.platica.mx/v1/agents/{agentId}/prompt/versions

Parámetros de URL

Parámetro	Tipo	Descripción	Requerido
`agentId`	string	Identificador único del agente	✓

Parámetros de query

Parámetro	Tipo	Descripción	Default
`limit`	integer	Máximo de versiones a devolver (1-200)	`50`

Respuesta

{
  "versions": [
    {
      "id": "8Xdjb0VjgIq35mzmt1wu",
      "operation": "edit",
      "details": "Exact match replacement",
      "owners": ["wnuHhEC1dWgpCYAi3sKsjd81kwW2"],
      "createdAt": "2026-05-28T06:14:21.000Z",
      "updatedAt": "2026-05-28T06:14:21.000Z"
    },
    {
      "id": "id45iLWReNWPfEGkAbFv",
      "operation": "write",
      "details": "Rewrite tras lanzamiento del producto X",
      "owners": ["wnuHhEC1dWgpCYAi3sKsjd81kwW2"],
      "createdAt": "2026-05-28T06:10:01.000Z",
      "updatedAt": "2026-05-28T06:10:01.000Z"
    }
  ]
}

Las versiones se devuelven en orden descendente por createdAt (la más reciente primero). El id de la versión más reciente coincide con activePromptId del agente.

Campos de la respuesta

Campo	Descripción
`id`	ID de la versión (coincide con `activePromptId` para la activa)
`operation`	Tipo de operación que creó la versión: `"create"`, `"write"`, `"edit"`, o `"modify"`
`details`	Nota descriptiva del cambio
`owners`	UID del usuario o API key que creó la versión
`createdAt`	Fecha de creación en formato ISO 8601
`updatedAt`	Fecha de actualización en formato ISO 8601

Obtener Versión del Prompt

Devuelve una versión específica incluyendo el contenido completo del prompt en ese punto.

GET https://api.platica.mx/v1/agents/{agentId}/prompt/versions/{versionId}

Parámetros de URL

Parámetro	Tipo	Descripción	Requerido
`agentId`	string	Identificador único del agente	✓
`versionId`	string	Identificador de la versión	✓

Respuesta

{
  "id": "id45iLWReNWPfEGkAbFv",
  "prompt": "Eres un asistente de soporte experto en electrónica de consumo...",
  "operation": "write",
  "details": "Rewrite tras lanzamiento del producto X",
  "owners": ["wnuHhEC1dWgpCYAi3sKsjd81kwW2"],
  "createdAt": "2026-05-28T06:10:01.000Z",
  "updatedAt": "2026-05-28T06:10:01.000Z"
}

A diferencia del listado, esta respuesta incluye el campo prompt con el contenido completo del system prompt tal como estaba en esa versión.

Anterior System Prompt del Agente Siguiente Sub-agentes