Descripción de los prompts
¿Qué son los prompts?
Los prompts en REDA AI son instrucciones de texto almacenadas en registros de Prompt personalizado que están vinculados a Definiciones de agente. A diferencia del campo Persona (que es un único prompt de sistema inicial), los Prompts personalizados aportan capas adicionales de instrucción que refinan el comportamiento del agente.
Piensa en los prompts como un conjunto de reglas, pautas y contexto que el agente de IA consulta al procesar las solicitudes de los usuarios. Cada prompt cumple un propósito específico, y varios prompts pueden trabajar en conjunto para determinar el comportamiento general del agente.
Los cinco tipos de prompt
| Tipo de prompt | Valor del campo | Propósito |
|---|---|---|
| Anulación de personalidad | Persona_Override | Establece o refina la identidad, el rol, el tono y la personalidad del agente. Puede anular o ampliar el campo Persona base de la Definición de agente. |
| Instrucciones personalizadas | Custom_Instructions | Reglas de comportamiento específicas. Ejemplos: «Usa siempre viñetas», «Habla únicamente de temas de bienes raíces», «Mantén las respuestas por debajo de las 100 palabras». |
| Esquema | Schema | Describe las estructuras de datos de Salesforce (significado de los campos, valores de las listas de selección, relaciones). Reduce la necesidad de llamadas a herramientas para describir los objetos. |
| Acción | Action | Instrucciones sobre cómo realizar acciones específicas. Ejemplos: «Al crear una tarea, establece siempre la prioridad en Alta», «Los correos deben usar esta plantilla de firma». |
| Medida de protección | Guardrail | Restricciones y reglas de seguridad. Ejemplos: «Nunca hables de precios con clientes del plan gratuito», «Escala las preguntas sobre salarios a Recursos Humanos». |
Anulación de personalidad frente al campo Persona
Existe una distinción entre:
- El campo Persona en la Definición de agente: el prompt de sistema base que define la identidad y el rol centrales del agente.
- El Prompt personalizado de tipo Persona_Override: prompts adicionales que pueden refinar o anular aspectos de la personalidad base. Útil para hacer ajustes sin modificar el campo Persona original.
En la mayoría de los casos, usarás el campo Persona para la personalidad base y reservarás los prompts Persona_Override para refinamientos o anulaciones específicas del contexto.
Cómo se ensamblan los prompts
Cuando el agente de IA procesa el mensaje de un usuario, REDA AI ensambla el prompt del sistema así:
- Persona base: el campo Persona de la Definición de agente va primero.
- Prompts personalizados, por Orden de clasificación: todos los prompts aplicables siguen en una única secuencia ordenada por el Orden de clasificación (el más bajo primero), independientemente del tipo de prompt. El tipo describe para qué sirve un prompt; no controla su posición. Para poner una medida de protección antes de una instrucción, asígnale un Orden de clasificación más bajo.
- Mensaje del usuario: el mensaje real del usuario se procesa después de todos los prompts.
"Aplicable" significa que el prompt pasa todos estos filtros en el momento del ensamblado:
- Activo: la casilla Activo está marcada.
- Coincidencia de agente: el prompt está vinculado a este agente, o su campo Definición de agente está en blanco, lo que lo convierte en un prompt universal que se carga para todos los agentes (las directivas de idioma integradas vienen así).
- Coincidencia de canal: la selección de Canal del prompt incluye el canal en el que se ejecuta la conversación.
- Coincidencia de contexto: si el prompt especifica Objetos de contexto, el objeto del registro actual debe coincidir.
- No excluido: el prompt no está en la lista de exclusiones de este agente (configurada con Editar carga en la Vista previa de ejecución del agente).
- No es un prompt exclusivo: un prompt con Prompt exclusivo marcado se salta toda esta lista. Es invisible para la coincidencia por agente, canal y contexto, y solo llega a un agente cuando un registro de Prompt exclusivo se lo asigna.
- Cabe en el presupuesto de tokens: cada prompt lleva una estimación de tokens (su Estimación de complejidad, o 200 si está en blanco). Un prompt que empuje el total acumulado por encima del Prompt Complexity Budget del agente se omite en ese turno; prompts posteriores más pequeños aún pueden cargarse.
Estructura y contenido del prompt
| Campo | Tipo | Descripción |
|---|---|---|
| Tipo de prompt | Lista de selección | Uno de los cinco tipos: Persona_Override, Custom_Instructions, Schema, Action o Guardrail. |
| Contenido | Área de texto largo | El texto real del prompt. Es lo que se envía a la IA. Puede ser muy largo (miles de caracteres). |
| Activo | Casilla de verificación | Solo los prompts activos se ensamblan y se envían a la IA. Desactivar un prompt lo deshabilita sin eliminarlo. |
| Orden de clasificación | Número | Controla la posición del prompt en la secuencia ensamblada — entre todos los tipos de prompt. Los números más bajos van primero. |
| Definición de agente | Búsqueda a Definición de agente | A qué agente pertenece este prompt. Déjalo en blanco para hacer el prompt universal: se cargará para todos los agentes de la organización. |
| Canal | Lista de selección múltiple | En qué canales se carga el prompt (Interno, Widget externo, Comunidad, API). Un prompt seleccionado para Interno y Widget externo se carga en ambos. |
| Objetos de contexto | Texto | Lista opcional de nombres de API de objetos. Si se establece, el prompt solo se carga cuando la conversación se ejecuta en el contexto de uno de esos objetos. |
| Estimación de complejidad | Número | El tamaño estimado del prompt en tokens, usado para hacer cumplir el Prompt Complexity Budget del agente durante el ensamblado. En blanco cuenta como 200. |
Variables de contexto en los prompts
Los prompts pueden incluir variables de contexto que se reemplazan dinámicamente por valores reales en tiempo de ejecución. Variables comunes:
- {USER_NAME}: el nombre y los apellidos del usuario de Salesforce
- {USER_FIRST_NAME}: solo el nombre
- {USER_EMAIL}: el correo electrónico del usuario
- {TODAY_DATE}: la fecha de hoy en la configuración regional de la organización
- {AGENT_NAME}: el Nombre visible del agente
- {USER_LANGUAGE}: la configuración regional de idioma de Salesforce del usuario
Ejemplo: «Saluda al usuario como {USER_FIRST_NAME}. La fecha de hoy es {TODAY_DATE}.» se convierte en «Saluda al usuario como John. La fecha de hoy es 5 de marzo de 2026.»
Ejemplos comunes de prompts
Ejemplo de prompt de esquema
Tienes acceso a los siguientes objetos de Salesforce:
Opportunity:
- StageName (lista de selección): Prospecting, Qualification, Needs Analysis, Value Proposition, Decision Makers, Perception Analysis, Proposal/Price Quote, Negotiation/Review, Closed Won, Closed Lost
- Amount (moneda): valor total de la operación
- ExpectedRevenue (moneda): ingresos previstos
- CloseDate (fecha): fecha de cierre prevista
Account:
- Industry (lista de selección): Technology, Healthcare, Finance, Manufacturing, etc.
- AnnualRevenue (moneda): ingresos anuales totales
- NumberOfEmployees (número): número de empleados
Ejemplo de prompt de instrucciones personalizadas
Sigue estas pautas de comportamiento:
1. Da siempre formato a las listas con viñetas, no con números
2. Mantén las respuestas concisas: máximo 3 o 4 oraciones
3. Usa un lenguaje amable y conversacional
4. Nunca inventes información sobre los registros; siempre consulta para verificar
5. Ofrece ayuda con el siguiente paso del flujo de trabajo
Ejemplo de prompt de medida de protección
NO hables de los siguientes temas:
- Remuneración de los empleados o detalles salariales
- Información confidencial sobre precios
- Información personal de salud o médica
- Credenciales o contraseñas
Si te preguntan sobre estos temas, declina cortésmente y ofrece escalar la consulta al departamento correspondiente.
Varios prompts del mismo tipo
Puedes crear varios prompts del mismo tipo y asignárselos todos a un agente. Se concatenan en la secuencia del Sort_Order. Esto es útil para:
- Modularidad: divide instrucciones complejas en varios prompts específicos.
- Reutilización: usa el mismo prompt en varios agentes sin duplicación.
- Patrones de herencia: crea un prompt base que se aplique a todos los agentes y, después, anulaciones específicas para cada agente.
- Control dinámico: deshabilita o habilita prompts sin eliminarlos, o reordénalos cambiando el Sort_Order.
Por ejemplo, podrías tener:
- Custom_Instructions (Sort_Order 1): reglas generales de tono y formato
- Custom_Instructions (Sort_Order 2): reglas específicas del dominio para Ventas
- Custom_Instructions (Sort_Order 3): políticas específicas de la empresa
Desactivar frente a eliminar prompts
Desactivar (desmarca Activo): el prompt permanece en la base de datos, pero no se envía a la IA. Usa esta opción para deshabilitar temporalmente un prompt mientras pruebas cambios.
Eliminar: el registro del prompt se elimina de forma permanente. Usa esta opción solo cuando estés seguro de que el prompt no volverá a necesitarse.
Práctica recomendada: desactiva en lugar de eliminar, para poder reactivar rápidamente si es necesario.
Configurar instrucciones reutilizables
Los Prompts exclusivos permiten asignar instrucciones reutilizables a agentes seleccionados. Revise Prompt exclusivo y Resumen en Prompt personalizado, y Definición de agente, Prompt personalizado, Activo y Modo de carga en la asignación. El modo Bajo demanda requiere la herramienta de prompts de contexto en el agente. Los corchetes de tipo de registro comparten reglas de alcance, también en las vistas previas. El orden de prompts y herramientas es determinista; la vista previa admite un ID de registro. Las instrucciones de idioma siguen el mensaje en canales API/externos; los marcadores de usuario solo se aplican en los contextos previstos. Preserve los prompts propios al combinar los valores actuales.
Preguntas frecuentes
Sí. Deja en blanco el campo Definición de agente del prompt y se convertirá en un prompt universal que se carga para todos los agentes de la organización — las directivas de idioma integradas vienen así. Para compartir un prompt solo con algunos agentes, duplícalo por agente, o hazlo universal y exclúyelo en los agentes que no deban usarlo (Editar carga en la Vista previa de ejecución del agente).
La IA intentará seguir ambas instrucciones. Sin embargo, las contradicciones pueden provocar un comportamiento impredecible. Mantén los prompts coherentes y pruébalos con cuidado. Si encuentras contradicciones, usa el Sort_Order para priorizar uno sobre otro, o consolídalos en un solo prompt.
Los prompts son texto sin formato, no HTML. Puedes usar formato estilo markdown (*, -, # para listas y encabezados) si la IA lo interpreta, pero lo más seguro es usar texto sin formato. La IA se encargará del formato de su respuesta de forma independiente.
El campo Contenido del prompt es un Área de texto largo que admite hasta 20 000 caracteres. En la práctica, mantén cada prompt por debajo de los 10 000 caracteres para mayor claridad y para evitar un consumo excesivo de tokens. Si necesitas ofrecer indicaciones extensas, divídelas en varios prompts.
Próximos pasos
Aprende a crear y editar prompts para tus agentes, o explora las prácticas recomendadas de prompts para optimizar las respuestas de tu agente.