> ## Documentation Index
> Fetch the complete documentation index at: https://help.chateea.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Introducción a las indicaciones para IA

> Cómo escribir instrucciones que hacen la diferencia entre un bot genérico y uno que vende.

La indicación (el prompt) es el conjunto de instrucciones que le das a tu bot de IA conversacional. Con una indicación simple, el bot funciona. Con una bien escrita, potencia a tu equipo, cuida la relación con tus clientes e impulsa tus ventas.

La diferencia está en cuánta información le das y en qué tan clara es la redacción.

## Los tres elementos de una indicación

Toda indicación efectiva tiene estas tres partes. Úsalas para guiar al modelo con mucha más precisión.

| Elemento | Qué define |
| - | - |
| **Rol** | La personalidad, el contexto y el flujo de interacción. Es la base de la coherencia |
| **Tarea** | La instrucción concreta que quieres que ejecute. Una tarea vaga produce resultados vagos |
| **Directrices** | Los límites que el bot debe respetar. Funcionan como hoja de ruta hacia el resultado deseado |

## Rol: interacción y flujo

Es la personalidad y el contexto que orientan al modelo. Definirlo bien es lo que hace que las respuestas sean coherentes y relevantes.

> **Peor**
>
> ```text theme={null}
> Eres vendedor de {{ai.business_name}},
> debes atender a los clientes y ayudarles
> a reservar citas. Compórtate como un ser
> humano. Estás hablando con {{contact.name}}.
> ```

> **Mejor**
>
> ```text theme={null}
> - Trabajas para {{ai.business_name}}. Tu objetivo
> es ayudar a los clientes, calificarlos según sus
> respuestas a las preguntas del guion y, si
> califican, ayudarlos a reservar una cita.
>
> - Mantén siempre la apariencia de un asistente
> humano. No reveles ni insinúes que eres un
> asistente de IA a menos que te lo pregunten.
> Usa lenguaje coloquial y frases como "Genial",
> "Entendido" o "Perfecto" en lugar de disculpas
> formales.
>
> - Reconoce la información del usuario repitiéndola
> al principio para mayor claridad. Después usa
> transiciones variadas, sin repetir sus palabras
> exactas.
>
> - Mantén una actitud profesional pero informal.
> Usa puntos en lugar de signos de exclamación.
>
> - Estás hablando con {{contact.name}}. Usa su
> nombre solo al principio y al final, para evitar
> redundancia.
> ```

> [!TIP]
>
> Fíjate en la diferencia real: la versión mejor no es más larga por gusto. Cada línea elimina una decisión que el modelo tendría que tomar por su cuenta.

## Tarea: instrucciones y objetivos

Es lo que quieres que haga, paso a paso. Una indicación ambigua hace que el bot se desvíe o produzca algo que no esperabas.

> **Peor**
>
> ```text theme={null}
> Debes calificar a los clientes haciéndoles
> preguntas y luego pedirles que reserven una
> cita. Si no están interesados, recopila sus
> datos.
> ```

> **Mejor**
>
> ```text theme={null}
> Guion de conversación:
>
> - Empieza preguntando algo como "¿Qué tipo de
> solución buscas?". Si no está interesado, pídele
> amablemente su correo y ofrécele mantenerte en
> contacto para futuras oportunidades.
>
> - Si responde positivamente, pregunta por su
> situación actual.
>
> - Cuando haya respondido positivamente a todas
> las preguntas, propón agendar una llamada con
> el equipo.
>
> - Antes de sugerir la cita, pídele su correo si
> aún no lo tienes.
>
> - Ayúdalo a agendar. Una vez agendada, agradécele
> y cierra la conversación de forma positiva.
> ```

## Directrices: los límites

Son las reglas que el bot no debe cruzar. También puedes incluirlas dentro del rol o de las instrucciones.

> **Peor**
>
> ```text theme={null}
> Responde de forma concisa. Haz todas las
> preguntas del guion y luego pídeles que
> reserven una cita.
> ```

> **Mejor**
>
> ```text theme={null}
> - Responde de forma breve y directa, con un
> límite de 20 palabras.
>
> - Espera siempre la respuesta del usuario antes
> de hacer la siguiente pregunta del guion.
>
> - Solo permite que reserven una cita si
> respondieron afirmativamente a las preguntas
> del guion.
> ```

## Tres prácticas que mejoran cualquier indicación

### 1. Repetición

Reiterar las partes cruciales guía al modelo a responder de forma más consistente. Es especialmente efectivo para reforzar el cumplimiento de las reglas esenciales.

Si quieres que tu bot siga un guion de ventas, menciónalo en varios lugares:

En el **rol**:

```text theme={null}
Tu objetivo es calificarlos según las respuestas
que den a las preguntas del guion.
```

En las **directrices**:

```text theme={null}
- Espera siempre la respuesta antes de hacer la
siguiente pregunta del guion.
- Solo permite reservar si responden positivamente
a las preguntas del guion.
```

### 2. Ejemplos

A veces describir una tarea es más difícil que simplemente mostrarla. Los ejemplos mejoran muchísimo la comprensión del modelo, sobre todo cuando quieres replicar un estilo o un tono que cuesta explicar con palabras.

```text theme={null}
EJEMPLOS DE QUÉ DECIR Y QUÉ NO DECIR:

- Evitar: No entendí tu respuesta.
- Usar: Perdón, ¿me lo repites?

- Evitar: Pido disculpas por la confusión.
- Usar: Disculpa si no me expliqué bien.

- Evitar: Entiendo su preocupación, pero le aseguro
  que nuestro equipo está altamente capacitado.
- Usar: Sí, es normal que te preocupe. Créeme que
  el equipo sabe muy bien lo que hace.
```

### 3. Mejora iterativa

Escribir buenas indicaciones es, sobre todo, un proceso de prueba y ajuste. Antes de poner tu bot frente a clientes reales, pruébalo, ajústalo y refínalo.

> [!WARNING]
>
> Cuidado con las muestras pequeñas. Tres conversaciones buenas no prueban que un cambio funcionó: pueden ser casualidad. Prueba lo suficiente antes de concluir que una modificación mejoró algo.

Cuantas más vueltas des a este ciclo, mejor será tu bot y mejor serás tú escribiendo indicaciones.

## Indicaciones avanzadas

### Información estática

Puedes incluir contexto sobre tu negocio, tus ofertas y tus servicios dentro de la propia indicación, para que el bot lo tenga disponible siempre.

> [!WARNING]
>
> **Mantén el contexto entre 100 y 200 palabras.**
>
> Si crece demasiado frente al resto de la indicación, las instrucciones pierden peso: la atención del modelo se va al contexto y deja de seguir tus reglas.

### Delimitadores

Son caracteres especiales que separan y enfatizan partes del texto, para que el modelo distinga el contexto de las instrucciones.

| Uso | Caracteres |
| - | - |
| **Énfasis** | `#` · `>` · `<` |
| **Delimitación** | `""` · `'''` · `<> </>` |

Ejemplo, agregando información de tu oferta:

> **Peor**
>
> El texto de la oferta pegado directamente, sin separación. El modelo no distingue dónde termina tu instrucción y dónde empieza el material de referencia.

> **Mejor**
>
> ```text theme={null}
> # Oferta:
> <oferta>
> [aquí el texto de tu oferta]
> </oferta>
> ```

### Contexto de la conversación

Para casos específicos, explica **por qué** y **en qué situación** el bot está hablando con esa persona. Contextualizar mejora mucho la precisión de las respuestas.

> **Peor**
>
> ```text theme={null}
> Debes asumir el rol de un chatbot de
> atención al cliente.
> ```

> **Mejor**
>
> ```text theme={null}
> Un cliente se está comunicando con nosotros
> porque algo salió mal con su pedido.
>
> Debes actuar como un agente amable, encargado
> de entender con claridad qué ocurrió. Pregúntale.
> ```

### Estilos de escritura

Elige el que corresponda a tu negocio:

Analítico · Conversacional · Creativo · Descriptivo · Informativo · Instructivo · Persuasivo · Técnico

### Tono

Autoritario · Clínico · Seguro · Empático · Formal · Amigable · Humorístico · Informal · Optimista · Juguetón · Serio · Comprensivo · Cálido

> [!TIP]
>
> Combina uno de cada lista y sé explícito. "Conversacional y cálido" produce un bot muy distinto de "técnico y clínico", aunque el resto de la indicación sea idéntico.

## Prueba antes de publicar

Usa el modo de prueba del bot para iterar tus indicaciones hasta que se comporte exactamente como quieres, **antes** de ponerlo frente a clientes reales.

> **[El agente conversacional](https://help.chateea.com/docs/ia/agente-conversacional.md)**
>
> Configuración, base de conocimiento y entrega a humano.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.