- Selecciona el nodo AI Agent en tu flujo
- Abre la sección TOOLS en la configuración del nodo
- Haz clic en el botón ”+ Agregar tools”
- En el campo “Selecciona un Tool”, verás la lista de todas las tools disponibles, incluyendo las nativas (marcadas con el texto “(Nativa)”)

Búsqueda de productos
Busca productos en el catálogo disponible para recomendar al usuario. Utiliza un motor de búsqueda para encontrar coincidencias basadas en el nombre del producto o términos relacionados. Parámetros:
“Si el usuario pregunta por la disponibilidad de algún artículo o modelo específico, DEBES usar la herramienta search_products para consultar el catálogo antes de responder.”
Ejemplo de Argumentos:
- Requiere que el canal tenga un catálogo de productos configurado y accesible.
Transferir a asesor
Transfiere la conversación actual del usuario a un agente humano o a una cola de atención. Permite especificar estrategias de enrutamiento y prioridades. Parámetros:
“Cuando el usuario exprese frustración o solicite hablar explícitamente con una persona real, ejecuta la función transfer_to_agent inmediatamente.”
Ejemplo de Argumentos:
Caso: Transferencia directa automática (más común)
- Puede finalizar el flujo de IA inmediatamente.
- Cuando se usa
assignment_type: "queue"conassignment_by: "general", se crea un ticket en la cola general de atención. - Importante: No se deben inventar IDs de equipos u operadores; se deben usar los configurados explícitamente.
Mensajes interactivos
Mensajes interactivos agrupa en un solo lugar los mensajes con botones que el agente puede enviar: Botones y lista, Webview y Call to Action. Cada mensaje tiene su propio toggle, así que activas solo los que el agente necesita. El agente decide cuándo enviar cada uno a partir del criterio que le das. La fila Mensajes interactivos aparece en la pestaña Tools del nodo AI Agent y muestra cuántos mensajes tienes activos (por ejemplo,2/3). Haz clic en ella para abrir el panel de configuración.
Configuración general: Botones y lista
Botones y lista activa la tool nativa Botones y lista. Con ella, el agente elige el formato (botones o lista) y el contenido del mensaje en cada conversación. Se configura una sola vez para el agente. Al activarla, puedes ajustar su Descripción: es el texto que el modelo lee para decidir cuándo usarla.Mensajes personalizados: Webview y Call to Action
Los mensajes personalizados te permiten definir de antemano qué envía el agente y en qué situación.Activa el mensaje
Ponle un nombre
Agendar cita o Formulario de registro. No puede ser igual ni muy parecido al nombre del otro mensaje personalizado.Define cuándo debe usarlo el agente
Completa los campos del mensaje
Campos de Webview
Campos de Call to Action
Canales compatibles
Los mensajes personalizados están disponibles en estos canales:Botones y lista
Sin el catálogo de Mensajes interactivos, esta tool aparece en el panel como Enviar mensajes interactivos. Envía un mensaje estructurado o interactivo al usuario. El formato exacto depende del canal (WhatsApp, Web, etc.), pero generalmente incluye botones o listas de opciones. Parámetros:options (Array de objetos):
title(string, obligatorio): Texto de la opción/botón. Máximo 20 caracteres. No se permiten títulos duplicados.description(string, opcional): Descripción adicional de la opción. Máximo 72 caracteres.
“Si el usuario pregunta qué servicios ofrecemos DEBES usar send_interactive_message para mostrar un menú con las opciones disponibles.”
Ejemplo de Argumentos (Botones - 3 o menos opciones):
caption se usa como texto del botón que abre la lista (en el ejemplo anterior, “Ver opciones”)."Message sent successfully." si el envío fue exitoso o un mensaje de error en caso contrario.
Notas:
- Envía un mensaje real al usuario.
- El tipo de mensaje se adapta automáticamente según el canal y la cantidad de opciones.
Enviar Call to Action (CTA) (Legacy)
Reemplazada por Mensajes interactivos. Envía un botón de llamada a la acción que abre una URL externa. Puede configurarse como WebView para formularios o pagos que requieren esperar una respuesta del usuario. Parámetros:“Cuando el usuario confirme que desea realizar el pago, usaEjemplo de Argumentos (CTA simple):send_call_to_actionconis_webview=truepara enviar el enlace de pago y esperar la confirmación.”
- CTA normal:
"Call-to-action message sent successfully." - WebView:
"WebView message sent. Waiting for user action."
- Disponible solo para los proveedores de WhatsApp que soportan este tipo de mensajes.
- Cuando
is_webview=true, el flujo se pausa hasta que el WebView devuelve un callback o expira el tiempo. - El valor de
inputse convierte a parámetros de URL query string. - La respuesta del callback se guarda en la variable especificada en
response_variable.
Responder con notas de voz
Esta herramienta convierte las respuestas del agente en notas de voz, en lugar de texto. Se activa como cualquier otra herramienta nativa desde la pestaña Herramientas del nodo AI Agent.
Abre el nodo AI Agent
Activa la herramienta
Ajusta la descripción (opcional)
Guarda el nodo
- El turno del agente termina al enviar la nota de voz. La herramienta siempre pausa; no es configurable.
- La voz la elige la plataforma. No hay un campo para seleccionarla.
- Solo puedes editar la descripción de la herramienta; no tiene parámetros ni la sección de comportamiento.
Responder con reacción
Esta herramienta permite que el agente reaccione con un emoji sobre el mensaje del usuario en lugar de responder con texto. Sirve para los mensajes que no necesitan respuesta, como un “gracias”, un “ok” o una confirmación: el usuario ve que el agente lo leyó y la conversación no se llena de textos como “¡Con gusto!”.
Herramienta Responder con reacción activada en la pestaña Herramientas del nodo AI Agent
Abre el nodo AI Agent
Activa la herramienta
Escribe la instrucción
Elige el emoji (opcional)
Guarda el nodo

Configuración de Responder con reacción con el aviso de ahorro, la instrucción sugerida y el emoji por defecto
Instrucción
La instrucción le dice al agente en qué casos reacciona en vez de escribir. Es obligatoria: si la dejas vacía, el campo muestra un error, la fila de la herramienta indica que falta la instrucción y el nodo se marca con error en el canvas.Disponibilidad por canal
La pestaña Herramientas revisa el canal del flujo y, en WhatsApp, el proveedor de cada canal de WhatsApp activo del proyecto:Comportamiento
- Reaccionar termina el turno sin texto. Cuando el agente reacciona, no envía ningún mensaje en ese turno.
- El emoji es siempre el que configuraste. El agente no elige otro por su cuenta.
- Primero las otras herramientas. Si en el mismo paso el agente también usa otra herramienta, la reacción espera a que esa herramienta responda. Así el agente no reacciona a un pedido que después falla.
- Mensajes seguidos. Si el usuario envía varios mensajes seguidos y el canal los agrupa, el agente reacciona a cada uno.
- Si la reacción no se puede entregar, el agente envía un mensaje de texto corto con ✅ en su lugar, para que el usuario no se quede sin respuesta.
- Memoria del agente. El agente recuerda que reaccionó y que no envió texto, así que en los siguientes turnos mantiene el contexto.
- Visible en la plataforma. La reacción aparece sobre el mensaje del usuario en la Bandeja de entrada, en los registros y en Probar de Brain Studio.
Fecha y hora actual
Obtiene la fecha y hora actual. Permite especificar una zona horaria para obtener la hora local correcta. Parámetros:
“Antes de procesar cualquier solicitud que dependa de la hora (como ‘buenos días’ o citas para ‘hoy’), llama a get_current_date_time para saber la hora exacta.”
Ejemplo de Argumentos:
"Monday, December 08, 2025 10:30 AM".
Notas:
- No tiene efectos secundarios visibles para el usuario.
- Es puramente informativa para el modelo.
Día de la semana
Calcula y retorna el día de la semana correspondiente a una fecha específica proporcionada. Parámetros:
“Si el usuario quiere agendar para una fecha específica, verifica primero qué día de la semana es usando get_weekday_of_a_date para asegurar que sea un día hábil.”
Ejemplo de Argumentos:
"Wednesday".
Notas:
- Útil para validar citas o agendas.
Gestión de memoria
Las siguientes tools se activan desde la sección Gestión de memoria de la pestaña Contexto del nodo AI Agent. Dan al agente memoria de trabajo, acceso al CRM de la bandeja de entrada, variables del contexto del flujo e información de plataforma. Consulta la sección Gestión de memoria del nodo AI Agent para ver cómo activarlas y configurar sus permisos.Memoria interna
Permite al agente guardar, recordar y eliminar información de la conversación para reutilizarla más adelante. Es memoria de trabajo por usuario, con vigencia limitada: recuerda datos del mismo usuario entre conversaciones, pero no es un almacén permanente. Operaciones:- Incluye un campo opcional Espacio de memoria para aislar o agrupar los guardados, evitando que distintos contextos se mezclen.
- Cada operación admite configurar sus parámetros en modo IA, variable o estático, y un comportamiento post-ejecución (Continuar, Terminar o Pausar).
CRM de bandeja de entrada
Lee, define y actualiza datos del contacto del CRM (nombre, teléfono, etiquetas, notas y más) directamente desde la bandeja de entrada. Operaciones:- Los permisos se administran por grupo (datos del contacto / etiquetas) con lectura y escritura separadas. Puedes restringir a qué etiquetas puede acceder el agente.
- Requiere al menos un canal conectado para que existan contactos sobre los cuales operar.
$context
Lee y escribe variables del contexto del flujo para compartir datos entre nodos. Operaciones:- En la lista de tools aparece como $context para distinguirla de la pestaña Contexto.
- Las variables escritas quedan disponibles para nodos posteriores del flujo, por ejemplo
{{$context.mi_variable}}.
Información de plataforma
Bloques de contexto de solo lectura que inyectan datos de plataforma en el prompt del agente. No consumen una llamada de tool: la información se agrega automáticamente como contexto cuando la fuente está activa.- Las tres fuentes son de solo lectura; el agente no puede modificarlas.
- Se inyectan como bloques de contexto, por lo que no cuentan como una invocación de herramienta.
Bases de datos
Conexión nativa a Bases de datos (Datum v2) desde la pestaña Tools del nodo AI Agent. Permite que el agente busque, cree, actualice y elimine registros en tus colecciones sin encadenar nodos auxiliares. Operaciones: buscar, crear, actualizar y eliminar registros sobre las colecciones que habilites.- El agente solo puede operar sobre las colecciones de la misma compañía que habilites explícitamente en el popover Configurar.
- Las operaciones de escritura persisten de inmediato.
- El comportamiento post-ejecución (Continuar, Terminar o Pausar) se configura por operación.
AI Routing
Envía la solicitud del usuario al workflow que puede atenderla, cuando pide algo que este agente no puede hacer. Usa el AI Routing del proyecto para elegir el destino, por lo que el proyecto debe tener AI Routing habilitado. Parámetros:ai_router no necesita que le indiques cuándo usarla: al activarla se agregan automáticamente las reglas de derivación a las instrucciones del agente. Lo único que tienes que definir es el alcance del agente, porque todo lo que quede fuera de ahí es lo que se deriva.
“Atiendes únicamente consultas de facturación: estados de cuenta, fechas de pago y detalle de cargos.”Ejemplo de Argumentos: Caso: el usuario pregunta algo fuera del alcance del agente (más común)
search y en direct sin coincidencia, retorna los destinos disponibles y no deriva nada.
Notas:
- Una derivación exitosa termina el turno del agente: la respuesta al usuario llega desde el workflow de destino. El agente no debe responder también.
- Si no hay coincidencia o la derivación falla, el agente sigue a cargo de la conversación y debe continuar atendiendo al usuario.
- Requiere que el proyecto tenga AI Routing habilitado y workflows con nombre y descripción configurados. El comportamiento posterior a la ejecución es fijo: la derivación siempre termina el turno del agente.
- El agente solo puede derivar a workflows del mismo proyecto.
Documentos de conocimiento: búsqueda por archivo
Cuando cargas archivos en la pestaña Contexto del nodo AI Agent, el agente recibe automáticamente la funciónsearch para consultarlos. Con la búsqueda por archivo activada, esa misma función busca mejor. No aparecen funciones ni parámetros nuevos:
- Detecta cuándo la pregunta se refiere a un documento y busca solo en ese documento.
- Busca en todos los documentos del agente, no solo en los del primer proyecto.
- Responde anclada a los documentos: si no encuentra nada relevante, lo dice.
knowledgeSettings.fileSearch). Viene desactivada: sin esa configuración, el agente funciona exactamente como antes. Para activarla, abre la pestaña Contexto del nodo AI Agent y activa Buscar por nombre de documento. El interruptor aparece cuando el nodo tiene archivos de conocimiento.Cómo detecta el documento
El agente compara la pregunta con los nombres de los documentos cargados en el nodo:- Se ignoran mayúsculas, tildes, guiones y la extensión, y se toleran errores de escritura pequeños: “tarifario 2026”, “TARIFARIO” y “Tarifario_2026.pdf” encuentran el mismo archivo.
- Un documento se detecta cuando la pregunta incluye su nombre completo (“¿cuánto cuesta el plan básico del tarifario 2026?”) o lo menciona después de una palabra como “en”, “según”, “busca”, “revisa”, “consulta”, “dice”, “documento” o “archivo” (“según las políticas de envío…”).
- Palabras genéricas como “manual”, “guía”, “política” o “documento” no bastan por sí solas para elegir un archivo.
Respuestas ancladas a los documentos
Con la búsqueda por archivo activada, el resultado desearch le indica al agente que responda solo con lo que devolvieron los documentos. Cuando no encuentra nada relevante, el agente no recibe una lista vacía: recibe un aviso explícito de que no hay resultados relevantes y de que no debe responder con conocimiento general.
En nuestras pruebas con preguntas que los documentos no pueden responder, este cambio redujo las respuestas inventadas de 11 de cada 15 a 1 de cada 15, sin modificar las instrucciones del agente.