Agente de IA#

El bloque «Agente de IA» pasa la conversación a un modelo de IA. El agente responde al contacto por sí mismo siguiendo tus instrucciones, recuerda el diálogo y, cuando la conversación llega a un resultado, envía al contacto más adelante en el flujo.

El bloque se necesita donde una rama con botones no basta: una consulta, respuestas a preguntas frecuentes, averiguar qué necesita la persona antes de pasarla a un operador.

Qué necesitas#

• Una suscripción Pro, para que el bot responda a las personas en las apps de mensajería. Lo que está disponible sin ella se explica en la página Qué está disponible sin Pro.
• «Saldo de IA» recargado. El bloque no está incluido en la suscripción: cada respuesta del agente se paga con el «Saldo de IA» al precio del modelo elegido. Los precios de los modelos están en la página Precios de los servicios adicionales.
• Un modelo elegido en la configuración del bloque. Sin él, el bloque no envía nada.

El coste de cada respuesta se muestra en la sección «Registros»: se anota allí con el tipo «Agente de IA».

Nota

Cuando haces pruebas con «Probar el bot», el agente también llama al modelo, y las respuestas se pagan con el «Saldo de IA».

En qué se diferencia de los bloques de mensajes#

• El texto de la respuesta lo escribe el modelo. No indicas un mensaje, sino una instrucción: el «Prompt del sistema».
• El contacto se queda en el bloque y conversa con el agente. Cada nuevo mensaje del contacto recibe una nueva respuesta del agente, hasta que el agente elige una transición o el contacto sale del bloque por su cuenta.
• El bloque no tiene botones. Las transiciones del bloque no son botones para el contacto, sino ramas del flujo que elige el agente.
• La respuesta no es instantánea. Mientras el modelo piensa, el flujo no se detiene: el contacto puede seguir la salida «Continuar» y, cuando la respuesta está lista, vuelve al bloque y la recibe.
• Cada bloque tiene su propia memoria. El historial de la conversación se guarda por separado para cada contacto y cada bloque «Agente de IA»: un segundo agente del mismo bot no sabe de qué habló el contacto con el primero.

Configuración#

«Prompt del sistema»#

La instrucción para el agente: quién es, de qué habla, qué debe averiguar y por qué señales debe elegir una transición. Hasta 10 000 caracteres.

Un bloque nuevo ya trae un borrador de prompt con un rol, unas reglas y una lista de transiciones: sustitúyelo por el tuyo.

En el prompt funcionan las plantillas: el nombre, las etiquetas y las variables del contacto se insertan de nuevo antes de cada respuesta. Solo están disponibles las funciones simples; cuáles exactamente se explica en la página Dónde funcionan las plantillas.

Consejo

Describe en el prompt los límites del tema y qué hacer con una pregunta que no tiene que ver. Un agente sin límites responderá a cualquier cosa, en nombre de tu empresa.

«Modelo»#

El modelo que responde al contacto. En la lista, los modelos están agrupados por proveedor, con el precio de los tokens de entrada y de salida junto a cada uno.

Cuando se elige un modelo, aparece el campo «Razonamiento»: cuánto piensa el modelo antes de responder. El conjunto de niveles depende del modelo; el valor «Desactivado» siempre está. Si el modelo no sabe razonar, la lista no tiene otros valores.

«Herramientas»#

Lo que el agente puede hacer además de responder con texto. En un bloque nuevo todas las herramientas están desactivadas.

• «Hora actual»: el agente puede saber la fecha y la hora actuales.
• «Búsqueda web»: el agente busca información en internet. Cada búsqueda se paga aparte con el «Saldo de IA», además de los tokens del modelo.
• «Lectura de páginas web»: el agente abre una página por un enlace y lee su texto.
• «Búsqueda en la base de conocimiento»: el agente busca la respuesta en tus documentos. Cuando el interruptor está activado, debajo aparece el campo «Base de conocimiento»: elige en él una de las bases de conocimiento del proyecto. Mientras no se elija una base, la búsqueda no funciona.
• «Búsqueda en el centro de ayuda»: el agente busca la respuesta en el centro de ayuda de Watbot y da enlaces a sus secciones. Es útil para un bot que ayuda a tus clientes a orientarse en Watbot, por ejemplo, si creas bots para otros.
• «Etiquetas del contacto»: el agente asigna y quita etiquetas del contacto durante la conversación. Describe en el prompt qué etiquetas poner y cuándo.
• «Variables del contacto»: el agente escribe y elimina variables del contacto. Describe en el prompt qué variables rellenar. El agente solo trabaja con variables de texto: no cambia las variables que contienen archivos, imágenes, audios ni videos.
• «Creación de archivos»: el agente crea documentos PDF y Word, hojas de cálculo de Excel, archivos CSV y de texto, los envía al contacto y edita los archivos que envió antes. Describe en el prompt cuándo y qué archivos crear.

Historial de la conversación#

• «Tamaño del historial de mensajes»: cuántos de los últimos mensajes del diálogo ve el agente al preparar una respuesta. Se cuentan tanto los mensajes del contacto como las respuestas del agente. De 1 a 1000; 10 de forma predeterminada. Cuanto más largo es el historial, mejor recuerda el agente la conversación y más cuesta cada respuesta.
• «Vigencia del historial de mensajes (días)»: el agente ignora los mensajes más antiguos que ese plazo. 0: sin límite de tiempo.
• «Restablecer historial»: el historial se borra antes de cada respuesta. El agente solo ve el último mensaje del contacto y no recuerda los anteriores.

«Transmitir la respuesta»#

La respuesta aparece en el chat a medida que el modelo la escribe. Mientras el modelo no escribe (por ejemplo, mientras busca en la base de conocimiento), el contacto ve «Pensando…».

La opción funciona en los chats privados de Telegram y en el chat del sitio web. En los demás canales no tiene efecto: la respuesta llega completa cuando está lista.

«Transiciones»#

Las ramas del flujo por las que el agente puede enviar al contacto. El botón «Añadir transición» añade una rama; su nombre se convierte en una salida del bloque en el esquema.

El agente ve los nombres de las transiciones y elige una cuando el resultado de la conversación encaja claramente con una rama. Si no encaja ninguna transición, el agente no elige nada y el contacto se queda en el bloque. El contacto recibe la respuesta del agente en cualquier caso: primero la respuesta y después la transición.

Pon nombres claros a las transiciones («Portátiles», «Operador») y describe en el prompt cuándo elegir cada una.

Advertencia

Si el contacto escribe un texto que coincide con el nombre de una transición, sigue esa transición de inmediato, sin respuesta del agente.

«Avanzado»#

Dos interruptores de esta sección cambian el comportamiento del agente:

• «Responder con números»: activado de forma predeterminada. Cuando el contacto envía un número, se interpreta como el número de una transición: «2» envía al contacto por la segunda transición sin respuesta del agente. Si el agente hace preguntas que se responden con un número («¿cuántas personas?», «¿qué talla?»), desactiva esta opción.
• «Guardar la respuesta en una variable del usuario»: cada mensaje del contacto en este bloque se guarda en la variable indicada, cada uno nuevo encima del anterior.

Salidas#

• Transiciones: salidas con los nombres que indicaste en la sección «Transiciones». Se activa la que eligió el agente, justo después de su respuesta.
• «Cualquier otra frase»: se activa cuando el contacto escribe cualquier texto en el bloque. Deja esta salida sin conectar: así el mensaje va al agente. Si la conectas a otro bloque, el siguiente mensaje del contacto irá allí y no habrá conversación con el agente.
• «Error de IA»: se activa cuando no habrá respuesta:
  • el modelo no está disponible o ha devuelto un error;
  • no hay fondos en el «Saldo de IA»;
  • los fondos se agotaron mientras el agente preparaba la respuesta: el trabajo ya hecho se paga y la respuesta no se envía;
  • el contacto superó el límite de mensajes al agente (consulta Límites).
• «Continuar»: se activa de inmediato, en cuanto el bloque recibe un mensaje y empieza a preparar una respuesta. No espera a la respuesta. Cuando la respuesta está lista, el contacto vuelve al bloque «Agente de IA» y la recibe. Si la salida no está conectada, el contacto simplemente espera la respuesta en el bloque.

Importante

Conecta «Error de IA» a un mensaje normal (por ejemplo, «Ahora no puedo responder, escríbeme más tarde») o a un paso a un operador. Sin conexión, el contacto no recibe nada cuando se produce un error.

El motivo del error se escribe en el «Registro de ejecución» del bloque: «No se pudo obtener una respuesta del modelo», «Saldo de IA insuficiente» o «Se alcanzó el límite de generaciones para este contacto».

Si en el bloque no hay ningún modelo elegido o el modelo ya no está conectado en el proyecto, también se activa «Error de IA», y en el registro aparece la entrada «No se ha indicado el modelo» o «Modelo no encontrado». Si la salida «Error de IA» no está conectada a nada, el bloque no envía nada y el contacto sigue «Continuar», si esa salida está conectada.

Archivos e imágenes del contacto#

El agente no solo procesa texto.

• Imágenes, si el modelo elegido acepta imágenes. Si no las acepta, el agente no responde y el contacto recibe un mensaje en el que se le pide que describa su pregunta con texto.
• Documentos: el agente lee su contenido.
• Mensajes de voz y audios de hasta 5 minutos: el agente los reconoce y responde a lo que se dijo. La transcripción aparece bajo el mensaje de voz en la sección «Mensajes». El reconocimiento no se cobra del saldo de IA. Si la grabación dura más de 5 minutos, se pide al contacto que grabe una más corta o escriba el mensaje. El agente no procesa videos.

En un mensaje se tienen en cuenta hasta 10 adjuntos. Las imágenes de más de 5 MB y los documentos de más de 50 MB se omiten.

Límites#

• Una respuesta a la vez. Mientras el agente prepara una respuesta, no procesa ni recuerda los nuevos mensajes de este contacto. Mientras tanto, el contacto sigue la salida «Continuar», si está conectada.
• Límite por contacto. Un contacto puede recibir como máximo 20 respuestas del agente en 10 minutos y 200 al día entre todos los bloques «Agente de IA» del bot. Por encima del límite, se activa la salida «Error de IA». El límite protege tu «Saldo de IA»: tú pagas las respuestas, y cualquiera puede escribir al bot. Cuando haces pruebas con «Probar el bot», el límite no se aplica.
• Archivos. El agente crea como máximo 3 archivos por respuesta y 30 archivos al día para un mismo contacto.
• Conexiones. Las salidas del bloque no se pueden conectar a otro bloque «Agente de IA» ni a los bloques «Menú global», «Bot inline de Telegram» y «Webhook entrante».

Diferencias entre canales#

El modelo da formato a la respuesta con marcado. Donde un canal no lo admite, el contacto recibe el mismo texto sin formato y sin caracteres de servicio.

Los archivos creados por el agente llegan al contacto como documentos justo después de la respuesta.