# El agente: prompt, conocimiento y derivación

> Cómo pasar el canvas aprobado a un agente avanzado: prompt en secciones con #, conocimiento del negocio, motivos de derivación y límites, y cómo vincularlo a la implementación.

Con la definición aprobada, toca construir. Para las implementaciones recomendamos el **modo avanzado** (plan Escala): escribes el prompt, das herramientas propias y publicas versiones probadas. Mira [Agentes avanzados](/avanzados/introduccion) para el detalle de cada pantalla.

## 1. Crea el agente y vincúlalo

Pídeselo a tu asistente por MCP (*"Crea un agente en modo avanzado llamado … con este prompt"*) o créalo en **Agentes IA → Nuevo agente → Avanzado**.

Después vincúlalo a la implementación: en el encabezado de la implementación, elige el agente. Sin agente vinculado, la pestaña **Calidad** no muestra tests ni sugerencias, y las tareas de construcción no se completan solas.

## 2. El prompt en secciones

El prompt se escribe en secciones con títulos `#`. Cada sección sale de una o más cajas del canvas:

| Sección del prompt | Sale de |
| --- | --- |
| `# Identidad y objetivo` | **Objetivo**, **A quién atiende** |
| `# Tono` | **Tono y estilo** |
| `# Qué resuelve` | **Qué hace** |
| `# Reglas` / `# Lo que nunca hace` | **Qué no hace** |
| `# Derivación` | **Cuándo deriva a una persona** |
| `# Herramientas` | **Herramientas** y el flujo esperado |
| `# Datos del negocio` | Horarios, dirección, medios de pago |

Ejemplo corto, para un cliente que pidió voseo (el prompt va en el tono del cliente):

```markdown
# Identidad y objetivo
Sos {agente}, de {negocio}. Atendés por {canal} consultas de stock y turnos.

# Tono
- Voseo, cercano. Mensajes de 2 o 3 líneas. Un emoji como máximo.
- Una sola pregunta por mensaje.

# Lo que nunca hace
- No inventás precios ni modelos: si la herramienta no lo encuentra, lo decís.
- No das diagnósticos ni consejos médicos.
- No hablás de temas que no sean del negocio.

# Herramientas
- Para stock y precio usá consultar_stock. Nunca respondas un precio sin consultarlo.

# Derivación
- Reclamos por trabajos o demoras: derivá con el motivo "Reclamo".
```

Recomendaciones:

- **Nombra las herramientas** como las ve el agente. No hace falta describir sus entradas.
- **Escribe ejemplos** de una buena y una mala respuesta para lo delicado.
- **No copies el prompt de otro cliente.** Parte de la plantilla y del canvas de este cliente.
- Usa las [variables](/avanzados/prompt#variables) (`{negocio}`, `{fecha}`, `{contacto.nombre}`) en lugar de escribir datos que cambian.

## 3. Conocimiento

Lo que el agente tiene que saber del negocio va como conocimiento, no en el prompt: la web, el catálogo (feed de productos), PDFs de políticas y textos de preguntas frecuentes. Mira [Conocimiento](/guias/agentes/conocimiento).

- Empieza por la web del negocio y el catálogo.
- Suma las preguntas frecuentes que salieron de las conversaciones reales del discovery.
- Comprueba lo que encuentra con preguntas reales antes de seguir.
- La tarea **Cargar conocimiento** se completa sola cuando hay al menos una fuente lista.

<Note>
  Los datos que cambian todo el tiempo (stock, precios, turnos libres, estado de un pedido) no van como conocimiento: van con una [herramienta](/partners/metodologia/herramientas) que consulta el sistema en el momento.
</Note>

## 4. Derivación y límites

En **Derivación y límites** cargas los **motivos de derivación**, uno por cada caso de **Cuándo deriva a una persona**: nombre, cuándo aplica, a quién se asigna y qué le dice al cliente. Mira [Derivación](/avanzados/derivacion).

- Cada motivo tiene que ser accionable: a quién le llega y qué tiene que hacer esa persona.
- El mensaje al cliente dice qué va a pasar y cuándo (*"Te escribe un asesor de lunes a viernes de 9 a 18"*).
- Escribe en el prompt lo que **no** se deriva, para que no derive de más.

En la misma pestaña configuras los [límites](/avanzados/limites): de qué puede hablar, qué temas no toca nunca y tus reglas propias, con qué hacer si una respuesta las rompe.

## Checklist del agente

- [ ] El agente está en modo avanzado y vinculado a la implementación.
- [ ] El prompt tiene secciones con `#` y cubre todo el canvas.
- [ ] **Qué no hace** está en el prompt como reglas concretas.
- [ ] El conocimiento está cargado y lo probé con preguntas reales.
- [ ] Hay un motivo de derivación por cada caso del canvas, con su mensaje al cliente.
- [ ] Los límites están configurados.
- [ ] Revisé todo lo que escribió el asistente: nada inventado.