> ## Documentation Index
> Fetch the complete documentation index at: https://docs.famulor.io/llms.txt
> Use this file to discover all available pages before exploring further.
# Redacción de prompts
> Estructura, ajusta e itera sobre el prompt que sigue tu asistente en cada llamada
Tanto si tu asistente funciona con un único prompt del sistema como con un [Flow](/es/flow-builder/overview) construido a partir de nodos de agente, se aplica el mismo oficio: el modelo solo sabe lo que le dices. Un prompt claro y bien estructurado es una de las palancas más importantes que tienes sobre la calidad de la llamada, a menudo más que el modelo o la voz que elijas.
Esta página trata sobre cómo *escribir* buenas instrucciones. Para saber dónde vive el prompt del sistema y cuándo recurrir a un Flow en lugar de un único prompt, consulta [Prompt de sistema frente al generador de Flow](/es/assistants/overview).
## Estructura tu prompt en secciones con nombre
No escribas un único párrafo largo. Divide el prompt en secciones etiquetadas, cada una con una única función. Es más fácil de escribir, más fácil de actualizar más adelante sin romper otra cosa, y más fácil de seguir para el modelo:
```text theme={null}
## Identity
Who the assistant is, which company it represents, what it specializes in.
## Style
Tone, formality, sentence length, how it handles humor or empathy.
## Knowledge
The facts it needs on hand — products, prices, policies, hours.
## Guidelines
Rules it must always follow (verify identity before sharing account
details, never promise a delivery date, one question at a time).
## Response patterns
Step-by-step handling for specific situations — pricing questions,
objections, what to say while a tool call is running.
## Limits
What it must never do, and what to say instead.
```
Las secciones se pueden reutilizar entre distintos asistentes y editarse de forma independiente sin tocar el resto del prompt.
## Sé específico, no vago
"Sé útil y profesional" no le da al modelo nada sobre lo que actuar. Acompaña cada regla con un ejemplo concreto:
| Vago | Específico |
| ---------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------- |
| "Ayuda a los clientes con preguntas de facturación." | "Cuando quien llama mencione una pregunta de facturación, pide su número de factura (formato INV-XXXXX) y luego busca su cuenta." |
| "Sé amigable." | "Reconoce lo que dijo quien llama antes de responder: no saltes directamente a la siguiente pregunta." |
| "Gestiona objeciones." | "Si quien llama dice que no está interesado, pregunta qué tendría que cambiar para que tuviera sentido: no repitas el discurso." |
Evita también el fallo opuesto. Guionizar cada frase posible elimina la fluidez natural que hace que hablar con un asistente de voz sea agradable: da reglas y ejemplos, no una transcripción para recitar.
## Gestionar lo que no anticipaste
Todo prompt acaba encontrándose con una pregunta que no cubre. Decide de antemano cómo debe reaccionar el asistente: elige un patrón (o combínalos):
* **Valor por defecto y luego transferir.** "Si no sabes la respuesta, dilo con claridad y ofrece conectar a quien llama con alguien que sí la sepa", y luego apóyate en la [transferencia de llamada](/es/assistants/built-in-tools#transferencias).
* **Haz una pregunta aclaratoria.** "Si la solicitud no es clara, haz una pregunta de seguimiento breve antes de decidir cómo enrutarla."
* **Consulta primero la base de conocimientos.** Si has conectado una, indica al asistente que la busque antes de recurrir a una transferencia; consulta [Bases de conocimientos](/es/assistants/knowledge-base).
## Escribe condiciones claras para herramientas y transferencias
Cada [herramienta integrada](/es/assistants/built-in-tools) y cada borde de [Flow](/es/flow-builder/nodes) es tan fiable como el texto de la condición que describe cuándo debe activarse. Las condiciones vagas producen un comportamiento vago.
Dos niveles de detalle válidos para una condición de finalización de llamada, según cuánto control quieras:
* **Simple:** "Finaliza la llamada una vez que se han respondido todas las preguntas y quien llama ya no necesita ayuda."
* **Detallado:** "Finaliza también la llamada tras una reserva exitosa, una despedida explícita, o cuando la conversación esté claramente terminada, pero nunca mientras quien llama sigue hablando."
La misma precisión se aplica a una condición de transferencia: describe exactamente qué dice o necesita quien llama, no solo "cuando sea apropiado".
Luego, di lo mismo otra vez en el propio prompt. Una sección breve que nombre cada herramienta y el momento en que se aplica le da al asistente una referencia ordenada: vale la pena las pocas líneas extra siempre que más de una herramienta pudiera activarse de forma plausible:
```text theme={null}
## Tools
- check_availability — before offering any appointment time.
- book_appointment — only once the caller confirms a slot, with their
name and email.
- Transfer to Sales — when the caller asks for a quote or pricing.
```
[Milian](/es/assistants/milian-copilot) puede ayudarte a redactar y ajustar este tipo de texto de condición a partir de una descripción sencilla de tu proceso: describe lo que debería ocurrir y pide una instrucción breve, en forma de checklist, que puedas pegar directamente en el campo.
## ¿Qué extensión debería tener un prompt?
* **Corto (aproximadamente 50–200 palabras)** — asistentes simples y de un único propósito.
* **Medio (aproximadamente 200–500 palabras)** — varios escenarios, cada uno con una regla clara.
* **Largo (500+ palabras)** — ralentiza al modelo y aumenta la probabilidad de que pierda de vista una instrucción anterior.
Si te encuentras pegando un catálogo de productos, una FAQ larga o políticas detalladas, muévelo a una [base de conocimientos](/es/assistants/knowledge-base) en su lugar. Las bases de conocimientos son buscables, no aumentan la longitud del prompt en cada llamada, y se pueden actualizar sin tocar el asistente.
## Errores comunes al redactar prompts
| Error | Solución |
| ------------------------------------------------- | ------------------------------------------------------------------------------------ |
| Demasiado vago ("sé útil") | Añade reglas concretas y frases de ejemplo |
| Demasiado rígido: cada línea guionizada | Da directrices y ejemplos, no una transcripción |
| Sobrecarga de información | Mueve el material de referencia a una base de conocimientos |
| Instrucciones contradictorias | Relee el prompt en orden: una regla posterior nunca debería contradecir una anterior |
| Ninguna regla para preguntas inesperadas | Añade uno de los patrones de respaldo anteriores |
| Disparadores de herramienta o transferencia vagos | Nombra la situación exacta, no "cuando sea apropiado" |
## Lanzamiento e iteración
Ningún prompt está terminado en el lanzamiento: trátalo como un documento vivo.
Escribe instrucciones claras para tus escenarios más frecuentes antes de perseguir cada caso límite. Un prompt que gestiona bien la mayoría de las llamadas reales es mejor que uno que gestiona a medias todo.
Usa el botón **Test** del editor para una comprobación rápida de voz o chat, o configura [Simulaciones](/es/assistants/simulations) para ejecutar automáticamente escenarios comunes, casos límite y una o dos personas que llaman difíciles antes de que el prompt se enfrente a una real.
Revisa de cerca las transcripciones de las llamadas nuevas justo después del lanzamiento: muestran exactamente dónde dudó el asistente, adivinó, o gestionó algo de forma incorrecta.
Añade el ejemplo, la regla o el respaldo concreto que habría corregido cada fallo. Las ediciones pequeñas y específicas superan a reescribir todo el prompt.
Algunos síntomas comunes y su solución habitual:
| Síntoma | Solución probable |
| ------------------------------------------------------------- | ---------------------------------------------------------------------- |
| Respuestas genéricas y de talla única | Añade ejemplos específicos y escenarios con nombre |
| La información obligatoria se sigue pasando por alto | Enumera exactamente qué recopilar y en qué orden |
| Las transferencias ocurren demasiado pronto o demasiado tarde | Ajusta la redacción de la condición de transferencia |
| Afirma algo que no es cierto | Añade una regla explícita de "di que no lo sabes en lugar de adivinar" |
Cubrir por completo cada llamada posible no es un objetivo realista: el lenguaje es demasiado variado para eso. Apunta a reducir la brecha de forma constante, y apóyate en las [barreras de protección y una transferencia a una persona](/es/assistants/conversation-quality#barreras-de-protección) como red de seguridad para lo que quede.
Consulta [Prompts para el habla](/es/assistants/prompting-for-speech) para conseguir que los números de teléfono, las fechas y otros detalles hablados suenen bien, y [Prompts de ejemplo](/es/assistants/example-prompts/overview) para puntos de partida listos para adaptar.