# Resumen del agente y prompt

> Edita el prompt de tu agente en la pestaña Resumen de Agentclic, mejóralo con IA, elige el modelo y completa la información general del agente.

URL: https://agentclic.com/docs/agentes/resumen-y-prompt
Última revisión: 2026-11-02

La pestaña **Resumen** de cada agente reúne sus instrucciones (el **prompt de sistema**), el modelo con el que responde y su información general. El prompt define cómo razona el agente y se usa en cada conversación junto con su conocimiento, sus flujos y sus herramientas. Puedes editarlo a mano, pedir a la IA que corrija un problema concreto o regenerarlo desde cero.

## Las partes de la pestaña Resumen

| Bloque | Qué contiene |
|---|---|
| **Cerebro del agente** | El prompt de sistema, los indicadores de contexto y de riesgo de alucinación, las variables y el modelo activo. |
| **Información general** | Nombres, descripción, sector, tareas, cliente, tiempo de espera y zona horaria. |
| **Disponibilidad de respuesta** | Si contesta siempre o solo en un horario. Ver [Horario de respuesta del agente](https://agentclic.com/docs/agentes/horario-de-respuesta). |
| **Personalidad** | Tono, idiomas y estado. Ver [Personalidad y estado del agente](https://agentclic.com/docs/agentes/personalidad-y-estado). |

> **Importante:** Los cambios no se aplican hasta que pulsas **«Guardar»**. Si tienes cambios pendientes, verás la etiqueta **«Cambios sin guardar»** y el botón cambia a **«Guardar cambios»**.

## Editar el prompt

1. En **Cerebro del agente**, escribe en el cuadro **Prompt de sistema**.
2. Si el texto es largo, usa el botón de **pantalla completa** («Editar en pantalla completa»). Los cambios se reflejan en el formulario principal.
3. Con el botón de copiar («Copiar prompt») lo llevas al portapapeles.
4. Pulsa **«Guardar»** en Información general.

El asistente de creación ya te deja un prompt hecho: ver [Crea tu primer agente](https://agentclic.com/docs/primeros-pasos/crear-tu-primer-agente).

## Mejorar el prompt con IA

Si el agente responde mal en algo concreto, pulsa **«¿Has detectado un problema?»**.

1. Describe lo que falla, por ejemplo: «cuando preguntan por precios responde de forma vaga».
2. Pulsa **«Analizar»**.
3. Si la IA necesita más datos, verás **«Necesitamos algo más de contexto»**: responde al menos a una pregunta y pulsa **«Enviar respuestas»**.
4. Revisa la propuesta lado a lado: en rojo lo que se elimina y en verde lo que se añade.
5. Pulsa **«Aplicar cambios»** o **«Descartar»**.
6. Pulsa **«Guardar»** para que el cambio quede guardado.

## Regenerar el prompt

**«Regenerar»** redacta un prompt nuevo desde cero a partir de la información general, la personalidad, el conocimiento y los flujos del agente. Igual que al mejorarlo, ves los cambios propuestos y decides si los aplicas.

> **Nota:** Mejorar y regenerar el prompt consumen [créditos](https://agentclic.com/docs/primeros-pasos/planes-y-creditos#creditos): el botón muestra el coste. Si no te quedan, verás **«Comprar créditos»** (o **«Activa tu cuenta para más créditos»** durante la prueba).

## Indicadores del prompt

Debajo del prompt hay dos medidores. Pulsa **«Ver más detalles»** en cada uno.

- **Uso de la ventana de contexto**: cuánto ocupa el prompt del espacio que tiene el modelo. Si se acerca al límite, te avisa: un prompt muy largo deja poco espacio para la conversación.
- **Riesgo de alucinación**: una orientación de cuánto margen tiene el agente para inventarse cosas. Revisa cinco aspectos:
  - que el prompt sea suficientemente detallado;
  - que diga qué hacer si el agente no sabe algo;
  - que haya un modelo activo;
  - que el modelo no sea una variante ligera;
  - que haya fuentes de [conocimiento](https://agentclic.com/docs/agentes/conocimiento) y espacio libre en el contexto.

El riesgo es una estimación a partir de tu configuración; no mide respuestas reales.

> **Consejo:** Para bajar el riesgo, incluye en el prompt frases como «si no sabes algo, no te lo inventes y deriva a una persona», y añade conocimiento propio del negocio.

## Variables en el prompt

Puedes citar flujos y fuentes de conocimiento dentro del prompt. Pulsa sobre ellos en los recuadros que hay debajo del prompt y la variable se inserta donde esté el cursor. Para los flujos también puedes escribir `{{` y elegir de la lista.

| Variable | Para qué sirve |
|---|---|
| `{{flow:nombre-del-flujo}}` | **Variables de entorno — llamar a flujos.** Indica al agente cuándo usar un flujo, por ejemplo «para reservar usa `{{flow:reservar-cita}}`». |
| `{{knowledge:nombre-de-la-fuente}}` | **Variables de conocimiento — consultar fuentes.** Indica cuándo usar una fuente concreta, por ejemplo «usa `{{knowledge:faq}}` cuando pregunten por envíos». |
| `{{now}}` | Fecha y hora actuales en la zona horaria del agente. |

El editor colorea las variables de flujo:

- **Rojo**: el flujo existe pero está desactivado.
- **Rojo tachado**: el flujo ya no existe.
- **Ámbar**: el flujo arranca solo (webhook, programado o lead de Meta), así que el agente no lo usará en la conversación.

Ver [Qué son los flujos](https://agentclic.com/docs/flujos/que-son-los-flujos#como-usa-el-agente-los-flujos-en-una-conversacion) y [Variables en los flujos](https://agentclic.com/docs/flujos/variables).

## Modelo LLM activo

En **Modelo LLM activo** ves con qué modelo responde el agente:

- **Modelo gestionado por la plataforma**: responde con el modelo de Agentclic y cada respuesta consume créditos. No necesitas ninguna clave.
- **Tu propia clave LLM**: eliges entre los modelos que hayas conectado y no se consumen créditos. Se configura en la pestaña Herramientas: ver [Herramientas y API del agente](https://agentclic.com/docs/agentes/herramientas-y-api#cerebro-del-agente-modelo-de-la-plataforma-o-clave-propia).

El enlace **«Usar mi propia clave LLM»** lleva a esa pestaña. Si tu plan no lo incluye, aparece con una corona.

## Información general

| Campo | Para qué sirve |
|---|---|
| **Nombre público del agente** | El nombre con el que se presenta a quien le escribe. |
| **Nombre interno** | Solo lo ves tú, para distinguirlo en tu panel. |
| **Descripción del agente** | Quién es y de qué se encarga, en pocas líneas (máximo 2.000 caracteres). Las instrucciones detalladas van en el prompt. |
| **Sector** | El sector del negocio. |
| **Tareas principales** | Qué debe hacer: atender clientes, responder preguntas, tomar reservas, captar leads… |
| **Cliente** | El [cliente](https://agentclic.com/docs/clientes/alta-de-clientes) al que pertenece el agente, para organizarlo por negocio. |
| **Tiempo de buffer de respuesta (segundos)** | Cuánto espera antes de responder. Si la persona envía varios mensajes seguidos en ese tiempo, los responde juntos. De 0 a 300; con 0 responde al instante. |
| **Zona horaria (sede)** | La zona del negocio. La usan `{{now}}`, el horario de respuesta y las reservas. Debajo ves la hora actual en esa zona. |

Al cambiar el nombre público, el sector o las tareas, el prompt se actualiza solo en las líneas que los mencionan.

**Detalles técnicos**
- El prompt se completa en cada conversación con la identidad del agente (nombre, descripción, sector, tareas, tono e idioma), la lista de flujos disponibles y el contenido de las fuentes de conocimiento.
- Las líneas del prompt que citan un flujo desactivado se quitan al responder; el prompt guardado no cambia.
- El nombre de la variable de un flujo se forma con su nombre en minúsculas, sin tildes y con guiones: «Reservar cita» → `{{flow:reservar-cita}}`.


## Problemas frecuentes

### He cambiado el prompt y el agente sigue respondiendo igual

Comprueba que has pulsado **«Guardar»**: aplicar una propuesta de la IA solo cambia el texto del formulario («Prompt actualizado. Recuerda guardar los cambios.»). Después prueba de nuevo en [Probar el agente](https://agentclic.com/docs/agentes/probar-el-agente) con **«Reiniciar»**.

### Los botones «¿Has detectado un problema?» y «Regenerar» están desactivados

Te has quedado sin créditos. Compra más o, durante la prueba, activa tu cuenta. Ver [Planes y créditos](https://agentclic.com/docs/primeros-pasos/planes-y-creditos#que-pasa-si-te-quedas-sin-creditos).

### «La descripción del agente es demasiado larga»

La descripción admite un máximo de 2.000 caracteres. Acórtala y pasa las instrucciones detalladas al prompt.

### Una variable de flujo aparece tachada en rojo

El flujo al que apunta se ha borrado o renombrado. Cámbiala por la variable nueva o bórrala.
