System Prompt

Cada mutación del prompt crea una nueva versión en el historial y actualiza systemPrompt + activePromptId del agente de forma atómica. Esto permite auditar cambios y restaurar versiones anteriores.

Consejo

Llamar a PATCH /v1/agents/{agentId} con un campo systemPrompt también crea una versión automáticamente — el prompt siempre se versiona.

Obtener Prompt Activo

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

Parámetros de URL

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

Respuesta

{
  "systemPrompt": "Eres un asistente de soporte experto...",
  "activePromptId": "j8sl3KdQF1IBpRtoSWtR",
  "lastUpdate": "2026-05-28T06:14:21.000Z"
}

Campos de la respuesta

Campo	Descripción
`systemPrompt`	Texto del prompt activo
`activePromptId`	ID de la versión activa en el historial
`lastUpdate`	Fecha de la última actualización en formato ISO 8601

Escribir Prompt

Sobrescribe el prompt con content y crea una nueva versión en el historial.

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

Parámetros de URL

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

Cuerpo de la solicitud

{
  "content": "Eres un asistente de soporte para una tienda de electrónica...",
  "details": "Rewrite tras lanzamiento del producto X"
}

Parámetro	Tipo	Descripción	Requerido
`content`	string	Contenido completo del system prompt	✓
`details`	string	Nota descriptiva del cambio que se guarda en la versión (≤ 1000 chars)	—

Respuesta

{
  "status": "success",
  "message": "Agent system prompt written successfully",
  "data": {
    "activePromptId": "id45iLWReNWPfEGkAbFv",
    "systemPrompt": "Eres un asistente de soporte...",
    "contentLength": 4321
  }
}

Editar Prompt

Reemplaza un fragmento del prompt actual. Por defecto intenta match exacto, luego fuzzy (espacios normalizados). Si useRegex es true, oldText se interpreta como expresión regular.

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

Parámetros de URL

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

Cuerpo de la solicitud

{
  "oldText": "tono formal",
  "newText": "tono cercano y conversacional",
  "useRegex": false
}

Parámetro	Tipo	Descripción	Requerido	Default
`oldText`	string	Texto a buscar (debe ser único, salvo `useRegex: true`)	✓	—
`newText`	string	Texto de reemplazo (puede ser vacío para eliminar)	✓	—
`useRegex`	boolean	Si es `true`, `oldText` se interpreta como expresión regular	—	`false`

Respuesta

{
  "status": "success",
  "message": "Agent system prompt edited successfully",
  "data": {
    "activePromptId": "8Xdjb0VjgIq35mzmt1wu",
    "systemPrompt": "Eres un asistente de soporte...",
    "matchesFound": 1,
    "replacementsMade": 1,
    "editType": "exact"
  }
}

editType puede ser "exact", "fuzzy" o "regex" según cómo se haya resuelto el match.

Errores comunes

Status	Causa
`400 Multiple matches`	El `oldText` aparece varias veces; sé más específico o usa `useRegex: true`
`400 No match found`	Ni el match exacto ni el fuzzy encontraron el texto
`400`	El agente no tiene un `systemPrompt` previo para editar

Notas

El historial completo de versiones se consulta vía /v1/agents/{agentId}/prompt/versions .
details es opcional pero recomendado: se guarda en cada versión como nota descriptiva del cambio y aparece en el listado de versiones.
Para gestionar el prompt de un sub-agente conectado, usa /v1/agents/{agentId}/subagents/{subagentId}/prompt — valida primero que la conexión exista.

Anterior Eliminar Agente Siguiente Versiones del Prompt