Variables nominales en plantillas de WhatsApp: mensajes más claros y fáciles de configurar

Las plantillas de WhatsApp integradas con wolkvox ahora admiten variables en formato de parámetros nominales. Esto permite identificar cada dato mediante un nombre descriptivo, por ejemplo:

{{nombre_cliente}}
{{documento}}
{{fecha_entrevista}}
{{hora_entrevista}}

Este formato se suma al esquema posicional tradicional, en el que las variables se identifican únicamente por su orden:

{{1}}
{{2}}
{{3}}

Con los parámetros nominales, cada valor queda asociado de forma explícita con la información que debe reemplazar. Así, al momento de utilizar la plantilla desde wolkvox Agent, el agente puede reconocer fácilmente qué dato debe ingresar en cada variable, sin depender de memorizar su posición dentro del mensaje. Por ejemplo, una plantilla puede incluir el siguiente contenido:

Hola, {{nombre_candidato}}:
Te saluda {{nombre_reclutador}}, del equipo de Selección de {{nombre_empresa}}.
Te invitamos a una entrevista el {{fecha_entrevista}} a las {{hora_entrevista}}, por {{medio_entrevista}}.

Esta funcionalidad es compatible con los diferentes tipos de plantillas admitidos por los conectores de WhatsApp integrados con wolkvox Manager, incluidas las plantillas de texto y las que contienen elementos multimedia, como imágenes, videos o documentos.

Beneficios

• Mayor claridad al completar las plantillas: Los nombres de las variables indican directamente qué información debe ingresar el agente. Por ejemplo, {{nombre_cliente}} resulta más fácil de interpretar que {{1}}.
• Menos errores en el reemplazo de datos: La asociación explícita entre la variable y su contenido reduce el riesgo de ingresar valores en el orden incorrecto o dejar información pendiente.
• Plantillas más fáciles de administrar: Los equipos pueden revisar y mantener mensajes con múltiples variables sin tener que consultar constantemente el orden definido para cada parámetro.
• Mejor escalabilidad: El formato nominal facilita la construcción de plantillas extensas para procesos como ventas, cobranzas, servicio al cliente, confirmaciones, selección de personal y notificaciones transaccionales.
• Compatibilidad con distintos formatos: Las variables nominales pueden utilizarse en plantillas compatibles con la integración de WhatsApp, incluidas aquellas con encabezados multimedia, enlaces y otros componentes admitidos.

Cómo crear y utilizar una plantilla con variables nominales

Ingresa al Administrador de WhatsApp de Meta y dirígete a la sección de administración de plantillas. Inicia el proceso para crear una nueva plantilla y completa su configuración general. 

1. En la sección “Contenido”, localiza el campo “Tipo de variable” y selecciona la opción “Nombre”. 
   • Esta selección define que las variables de la plantilla se identificarán mediante nombres descriptivos y no por una numeración consecutiva. 
2. En el campo “Texto”, redacta el mensaje que será enviado al cliente.
   • Cada vez que necesites agregar un dato dinámico, haz clic en “Añadir variable”. Meta insertará una estructura vacía: {{}}
   • Dentro de las llaves, escribe el nombre que identificará la información. Por ejemplo: {{nombre_cliente}}
     {{tipo_de_presentacion}}
3. La vista previa ubicada a la derecha mostrará cómo quedará estructurada la plantilla.

• Ingresa valores de ejemplo para que Meta pueda validar el contenido y revisar correctamente la plantilla antes de su aprobación.
• Los nombres definidos deben conservarse de manera consistente para que cada valor se relacione con la variable correspondiente.
• Una vez configurado el contenido, envía la plantilla a revisión desde Meta y espera a que sea aprobada para poder utilizarla en la operación.
• Después de crear, modificar o aprobar una plantilla en Meta, debes ejecutar la sincronización de plantillas desde wolkvox Manager.
  • Este paso es necesario para que la versión actualizada aparezca disponible en wolkvox Agent y en los flujos de routing point que utilicen plantillas de WhatsApp.

Cuando un agente necesite enviar un mensaje de WhatsApp mediante plantilla:

• Selecciona la plantilla correspondiente.
• Revisa su contenido y los elementos multimedia, cuando aplique.
• Ingresa un valor por cada variable nominal en la sección “Línea por variable”.
• Completa los enlaces o componentes adicionales incluidos en la plantilla.
• Haz clic en “Enviar mensaje”.

Los valores deben ingresarse respetando el orden en que aparecen las variables dentro de la plantilla. Sin embargo, gracias a sus nombres descriptivos, el agente puede reconocer con mayor facilidad qué información corresponde a cada línea.

Activa alertas visuales de SLA para priorizar chats sin atención

wolkvox Manager incorpora una nueva configuración que permite habilitar alertas visuales de SLA de respuesta para las conversaciones de chat gestionadas por los agentes.

Al activar esta funcionalidad, el sistema muestra un semáforo con temporizador en la bandeja de conversaciones de wolkvox Agent. Este indicador permite reconocer rápidamente cuánto tiempo lleva un chat sin atención y ayuda a priorizar las conversaciones que requieren una respuesta más urgente.

Las alertas utilizan tres estados visuales:

• Verde: de 0 a 2 minutos.
• Amarillo: de 2 a 5 minutos.
• Rojo: más de 5 minutos.

Esta configuración se realiza de manera general desde el apartado de Chat WEB y se refleja automáticamente en el inbox de los agentes.

Beneficios

• Priorización de conversaciones: Permite identificar de inmediato los chats que llevan más tiempo esperando una respuesta, facilitando que los agentes atiendan primero las conversaciones más críticas.
• Mayor control sobre los SLA: Brinda una referencia visual del tiempo transcurrido sin atención y ayuda a la operación a cumplir sus objetivos de respuesta.
• Supervisión preventiva: Reduce el riesgo de que una conversación permanezca olvidada o supere los tiempos esperados de atención.
• Mejor experiencia para el cliente: Favorece respuestas más oportunas y disminuye los tiempos de espera en los canales de chat.
• Configuración centralizada: El administrador puede activar o desactivar la funcionalidad desde wolkvox Manager sin realizar cambios individuales en cada agente.

Cómo activar las alertas de SLA de respuesta

1. Ingresa a wolkvox Manager. Haz clic en el botón “Configuración”, identificado con el ícono de engranaje en la parte superior derecha.
2. Entra en la pestaña “Omni Channel”.
3. Selecciona la subpestaña “Chat WEB”.
4. En la parte superior derecha de esta sección, haz clic en el botón con el ícono de tres puntos verticales para abrir la configuración general de chats.

• Desplázate dentro de la ventana hasta encontrar la sección “ALERTAS DE SLA DE RESPUESTA”. 
• Activa el interruptor correspondiente. Al habilitarlo, el sistema mostrará el semáforo visual en el inbox de wolkvox Agent.
• Haz clic en “Save” para guardar la configuración.

Una vez guardado el cambio, los agentes podrán visualizar las etiquetas de tiempo y color junto a las conversaciones activas.

Usa el mismo SSO para acceder a varias operaciones alojadas en un mismo servidor

wolkvox Manager incorpora una mejora en la administración del inicio de sesión único o Single Sign-On (SSO): ahora es posible asociar el mismo identificador SSO a un usuario en diferentes operaciones que se encuentren alojadas dentro del mismo servidor.

Anteriormente, cuando una organización administraba varias operaciones en un mismo servidor, un colaborador debía registrar una dirección de correo diferente para cada operación. Esto generaba cuentas duplicadas, mayor complejidad administrativa y una experiencia de acceso fragmentada.

Con esta actualización, el usuario puede utilizar las mismas credenciales corporativas para ingresar a todas las operaciones en las que tenga una cuenta habilitada. El administrador solo debe registrar el mismo correo en el campo SSO al crear el usuario en cada operación correspondiente.

Además, la tabla de usuarios incorpora la columna SSO, desde la cual es posible consultar rápidamente el identificador asociado a cada cuenta.

Esta funcionalidad unifica el acceso únicamente entre operaciones alojadas en el mismo servidor.

Beneficios

• Gestión de identidades simplificada: Evita la creación de múltiples correos o identidades para un mismo colaborador que necesita acceder a diferentes operaciones.
• Administración centralizada: Facilita las altas, bajas y modificaciones de usuarios, ya que el equipo de TI puede mantener un único identificador corporativo para el acceso mediante SSO.
• Menos solicitudes de soporte: Reduce los inconvenientes asociados con cuentas duplicadas, credenciales olvidadas, bloqueos y restablecimientos de acceso.
• Experiencia de acceso unificada: El usuario puede utilizar la misma identidad corporativa en todas las operaciones habilitadas dentro del servidor, sin administrar credenciales diferentes para cada una.
• Mayor visibilidad para el administrador: La nueva columna SSO permite comprobar desde el listado de usuarios qué correo o identificador se encuentra asociado a cada cuenta.

Nuevo Componente Centinela para automatizar tareas programadas en wolkvox Studio

wolkvox Studio incorpora el nuevo Componente Centinela, también denominado Sentinel Cron, una herramienta que permite programar y ejecutar tareas recurrentes de forma automática dentro de un Routing Point.

A diferencia de los flujos que comienzan a partir de una acción del usuario, como una llamada, un chat o una interacción entrante, el Componente Centinela funciona como un temporizador interno. Una vez configurado, inicia automáticamente la ruta conectada al componente de acuerdo con el intervalo, los días, el horario y la zona horaria definidos por el administrador.

Esta funcionalidad permite incorporar varios componentes Centinela dentro de un mismo Routing Point y configurar cada uno con una programación independiente. De esta manera, es posible ejecutar múltiples flujos temporizados en paralelo sin crear estructuras separadas para procesos que comparten un mismo contexto o lógica de negocio.

El Componente Centinela está disponible exclusivamente en los Routing Points de tipo Agentic Engine.

Beneficios

• Automatización concurrente: Permite centralizar diferentes procesos programados en un único Routing Point y ejecutarlos en paralelo mediante varios componentes Centinela.
• Flexibilidad de planificación: Ofrece distintos intervalos de ejecución, desde cada cinco minutos hasta cada 24 horas, para adaptar la automatización a la frecuencia requerida por cada proceso.
• Control sobre días y horarios: La sección Ventana Activa permite restringir la ejecución a días y franjas horarias específicas, evitando que el flujo se active fuera del periodo autorizado.
• Precisión por zona horaria: Permite seleccionar explícitamente la zona horaria utilizada para calcular las ejecuciones, lo que facilita la administración de operaciones distribuidas en distintos países.
• Menos configuraciones dispersas: Reduce la necesidad de crear múltiples Routing Points independientes para tareas programadas relacionadas, facilitando la organización y el mantenimiento de los flujos.
• Mayor autonomía operativa: Los administradores pueden configurar automatizaciones periódicas directamente desde wolkvox Studio, sin depender de que un usuario inicie una interacción para activar el proceso.

¿Para qué puede utilizarse el Componente Centinela?

El componente puede utilizarse para iniciar automáticamente diferentes procesos operativos, por ejemplo:

• Consultar periódicamente información en sistemas externos.
• Sincronizar datos entre plataformas mediante integraciones o conectores MCP.
• Ejecutar seguimientos automáticos sobre registros, solicitudes o clientes.
• Validar condiciones de negocio en intervalos determinados.
• Generar alertas o notificaciones programadas.
• Iniciar procesos recurrentes de actualización, clasificación o análisis de información.
• Ejecutar acciones únicamente durante el horario laboral de una operación.
• Programar distintos procesos dentro del mismo Routing Point, cada uno con su propia frecuencia y ventana activa.

El alcance final de cada automatización dependerá de los componentes conectados después del Componente Centinela y de la lógica diseñada en el flujo.

Cómo configurar el Componente Centinela

1. Ubica el ícono del Componente Centinela en la barra de herramientas superior y agrégalo al lienzo de diseño.
2. Al dar doble clic izquierdo sobre el componente, se abrirá su panel de configuración en el costado derecho de la interfaz.
3. Configura los siguientes campos: 
   • En el campo “Zona Horaria”, selecciona la ubicación que se utilizará como referencia para ejecutar el flujo. Esta selección determina la hora local utilizada para evaluar el intervalo y la ventana activa. Las opciones disponibles son:
     • -5 America/Bogota
     • -4 America/Caracas
     • -3 America/Argentina/Buenos_Aires
     • -2 Atlantic/South_Georgia
     • -1 Atlantic/Cape_Verde
     • 0 UTC
     • +1 Europe/Madrid
     • +2 Europe/Helsinki
     • +3 Europe/Moscow
     • +4 Asia/Dubai
     • +5 Asia/Karachi
     • +6 Asia/Dhaka
     • +7 Asia/Bangkok
     • +8 Asia/Shanghai
     • +9 Asia/Tokyo
     • +10 Australia/Brisbane
     • +11 Pacific/Noumea
     • +12 Pacific/Tarawa
   • En la sección “Intervalo”, utiliza el campo “Ejecutar Cada” para establecer la frecuencia con la que se iniciará el flujo. Por ejemplo, al seleccionar 1 hour, el componente intentará ejecutar el flujo una vez cada hora, siempre que se encuentre dentro de los días y horarios autorizados. Puedes seleccionar:
     • 5 minutes
     • 10 minutes
     • 15 minutes
     • 30 minutes
     • 1 hour
     • 2 hours
     • 3 hours
     • 4 hours
     • 6 hours
     • 8 hours
     • 12 hours
     • 24 hours
   • En la sección “Ventana Activa”, utiliza los botones del campo “Días Activos” para seleccionar uno o varios días de ejecución. Los días seleccionados quedarán habilitados para la ejecución del componente:
     • S: domingo.
     • M: lunes.
     • T: martes.
     • W: miércoles.
     • T: jueves.
     • F: viernes.
     • S: sábado.
   • En “Horario Activo” (Aunque el intervalo indique una ejecución periódica, el Componente Centinela solo iniciará la ruta cuando la hora se encuentre dentro de esta ventana.), configura los siguientes campos:
     • Hora Inicio: momento a partir del cual se permite ejecutar el flujo.
     • Hora Fin: momento hasta el cual se permite ejecutarlo.

Nuevo componente Investigación Profunda para análisis autónomos en wolkvox Studio

wolkvox Studio incorpora el nuevo componente Investigación Profunda, también denominado Agentic Deep Research, un módulo de inteligencia artificial agéntica diseñado para realizar búsquedas, rastreos y análisis exhaustivos a partir de las instrucciones definidas por el diseñador del flujo.

A diferencia de una consulta convencional, este componente puede interpretar un objetivo complejo, seguir directrices específicas, evaluar la información recopilada y consolidar los hallazgos en una respuesta estructurada. De esta manera, permite incorporar capacidades avanzadas de investigación dentro de un Routing Point sin tener que construir manualmente múltiples pasos de consulta, validación y organización de datos.

El resultado generado se almacena automáticamente en la variable predeterminada $ResDeepR, desde donde puede ser utilizado por otros componentes del flujo para continuar la automatización, tomar decisiones, presentar la información al usuario o ejecutar nuevas acciones.

El componente está disponible en los siguientes tipos de Routing Point:

• Voice Flow
• Chat Flow
• Interaction Flow
• Agentic Engine

El componente Investigación Profunda no está disponible en Agent Scripting.

Beneficios

• Análisis contextual autónomo: Ejecuta investigaciones amplias a partir de directrices detalladas, interpretando el objetivo y aplicando las reglas definidas por el administrador.
• Menos complejidad en el diseño: Reduce la necesidad de crear múltiples conexiones y condiciones para consultar, validar, organizar y consolidar información dentro del Routing Point.
• Directrices adaptadas al negocio: Permite definir el rol de la IA, el objetivo de la investigación, los datos esperados, las restricciones, las fuentes aceptadas y el formato de respuesta.
• Persistencia entre investigaciones: La opción Habilitar Memoria de Sesión permite conservar los hallazgos de ejecuciones anteriores para mantener el contexto durante investigaciones consecutivas.
• Integración con otros componentes: El resultado se almacena en $ResDeepR, lo que permite reutilizarlo en componentes de texto, TTS, condiciones, bases de datos, integraciones, agentes autónomos u otras acciones del flujo.
• Validación antes de producción: El botón Probar Agente permite revisar el comportamiento del componente y ajustar las instrucciones antes de conectarlo al resto del proceso.

¿Para qué puede utilizarse el componente Investigación Profunda?

El componente puede apoyar procesos en los que se requiera recopilar, evaluar y organizar información de distintas fuentes. Algunos ejemplos son:

• Prospectar empresas o clientes potenciales según criterios comerciales.
• Investigar mercados, sectores, competidores o tendencias.
• Recopilar información pública de organizaciones y contactos.
• Comparar productos, servicios, precios o condiciones.
• Preparar resúmenes ejecutivos para agentes o áreas internas.
• Analizar antecedentes antes de una gestión de ventas, soporte o cobranzas.
• Identificar oportunidades y riesgos a partir de reglas definidas por el negocio.
• Obtener información estructurada para almacenarla en un CRM o una base de datos.
• Preparar contexto para que otro agente autónomo continúe el proceso.
• Validar si la información encontrada cumple requisitos obligatorios antes de avanzar en el flujo.

Por ejemplo, el diseñador puede configurar al componente como un analista de prospección comercial y solicitarle que identifique restaurantes de una ciudad, entregue sus datos de contacto, explique por qué podrían ser clientes potenciales y adjunte la fuente exacta utilizada.

Cómo configurar el componente Investigación Profunda

1. En la barra lateral de componentes, entra en la pestaña “Cognitivos” y busca la sección “Agentes”.
2. Arrastra el componente hacia la parte del flujo donde lo necesites.
3. Al hacer clic izquierdo sobre el componente se abrirá el panel de configuración en el costado derecho.

En la pestaña “Nombre”, escribe una identificación clara para el componente. El nombre debe facilitar su ubicación dentro del flujo, especialmente cuando se utilicen varios agentes o procesos de investigación. Algunos ejemplos pueden ser:

• Prospección de restaurantes.
• Investigación de clientes.
• Análisis de competencia.
• Validación de proveedores.

Cambia a la pestaña “Descripción” e ingresa información complementaria sobre el propósito del componente. Este campo puede utilizarse para documentar qué investiga, en qué parte del proceso se ejecuta o qué resultado se espera obtener.

En el campo “Directrices de investigación”, escribe el contexto general que orientará el comportamiento del agente. Estas instrucciones pueden incluir:

• El rol que debe asumir.
• El objetivo general.
• Los campos que debe devolver.
• Las reglas obligatorias.
• Las fuentes aceptadas.
• Los criterios para descartar resultados.
• El número máximo de registros.
• El idioma y formato de la respuesta.

Ejemplo: 

# Rol

Eres un analista de prospección comercial especializado en identificar empresas potenciales.

# Objetivo

Identifica restaurantes que puedan ser clientes para la distribución de bebidas naturales.

# Campos requeridos

- Empresa
- Ciudad
- Teléfono
- Correo electrónico
- Dirección
- Notas
- Fuente

# Reglas

- Devuelve un máximo de 20 resultados.
- No inventes información faltante.
- Prioriza fuentes oficiales.
- Evita registros duplicados.
- Responde únicamente en español.

Las directrices funcionan como el marco permanente de la investigación y deben ser lo suficientemente claras para establecer cómo debe razonar y responder el agente.

En el campo “Solicitud de investigación”, especifica la tarea concreta que debe ejecutarse. Por ejemplo:

Buscar oportunidades comerciales para restaurantes ubicados en Medellín.

Mientras las directrices establecen el comportamiento general del agente, la solicitud indica qué debe investigar en esa ejecución específica.

Haz clic en “Probar Agente” para ejecutar una validación de la configuración.

El sistema procesa las directrices y la solicitud ingresadas y genera un archivo HTML local con el resultado de la prueba. Este archivo se abre de forma automática en su navegador web predeterminado una vez termine de cargar la prueba. La ruta puede tener una estructura similar a la siguiente:

C:/ipdialbox/download/wolkvox_deepresearch_test_20260723_165400.html

Dentro del archivo podrás consultar:

• Las directrices o prompt utilizado.
• La solicitud de investigación.
• El resultado generado.
• El estado de la memoria de sesión.
• La fecha y hora de la ejecución.
• El identificador del componente probado.

Esta prueba permite revisar si el agente interpreta correctamente las reglas, si encuentra la información esperada y si el formato de salida es adecuado.

Activa el checkbox “Habilitar Memoria de Sesión” cuando necesites que las investigaciones consecutivas conserven el contexto y los hallazgos anteriores.

• Activada: el componente puede utilizar información obtenida en ejecuciones previas de la misma sesión.
• Desactivada: cada investigación comienza sin tener en cuenta los resultados anteriores.

Esta opción resulta útil para investigaciones progresivas, refinamientos o ciclos en los que cada nueva solicitud depende de lo encontrado previamente.

En Variable resultado de investigación se muestra la variable predeterminada:

$ResDeepR

En esta variable se almacena la respuesta completa producida por el componente.

El nombre de la variable es fijo y no puede modificarse.

Puedes utilizar $ResDeepR en los siguientes componentes del flujo para:

• Mostrar el resultado al usuario.
• Convertirlo en audio mediante TTS.
• Evaluarlo en una condición.
• Guardarlo en una base de datos.
• Enviarlo a un sistema externo.
• Entregarlo como contexto a otro agente.
• Continuar una automatización según los hallazgos.

Haz clic en “Guardar” para aplicar la configuración del componente.

Nuevo componente Agentic BD para gestionar bases de datos MySQL con IA en wolkvox Studio

wolkvox Studio incorpora el nuevo componente Agentic BD, también denominado Base de Datos Agéntica o Agentic MySQL BD, un módulo de inteligencia artificial diseñado para interactuar directamente con bases de datos MySQL mediante instrucciones en lenguaje natural.

El componente permite que un flujo consulte, inserte, actualice o elimine información y, cuando las directrices lo autoricen, ejecute acciones más avanzadas, como la creación de tablas. De esta manera, el diseñador puede automatizar operaciones de datos sin construir consultas SQL extensas ni desarrollar una API intermedia para cada acción.

Su comportamiento se controla desde el panel de configuración mediante directrices que establecen qué debe hacer el agente, sobre qué información puede trabajar y cuáles son sus restricciones. La solicitud específica puede escribirse directamente o recibirse desde una variable generada por otro componente del flujo.

El resultado de cada ejecución se almacena automáticamente en la variable predeterminada $ResDBAgentic, para que pueda ser utilizada por componentes posteriores del Routing Point.

Agentic BD está disponible en los siguientes tipos de Routing Point:

• Voice Flow
• Chat Flow
• Interaction Flow
• Agentic Engine

El componente no está disponible en Agent Scripting.

Beneficios

• Operaciones de base de datos en lenguaje natural: Permite ejecutar acciones sobre MySQL sin escribir manualmente consultas SQL complejas para cada escenario del flujo.
• Automatización dinámica: El agente puede interpretar el contexto recibido y determinar la operación necesaria según las directrices configuradas, como consultar un registro, insertar información o actualizar datos existentes.
• Integración directa con los flujos: El componente puede recibir información generada durante una llamada, un chat, una interacción o un proceso autónomo, y utilizarla para ejecutar acciones en la base de datos.
• Control mediante directrices: El administrador puede limitar el comportamiento del agente indicando las tablas, campos, operaciones y reglas permitidas. Esto ayuda a evitar acciones que no correspondan al objetivo definido.
• Persistencia de resultados: La respuesta o confirmación producida por el componente queda almacenada en $ResDBAgentic, facilitando su uso en condiciones, mensajes, consultas posteriores o integraciones externas.
• Validación antes de la implementación: La opción Probar Agente permite ejecutar una prueba y revisar en un archivo HTML los datos de conexión utilizados, el prompt, la solicitud enviada y el resultado obtenido.

¿Para qué puede utilizarse Agentic BD?

El componente puede incorporarse en procesos que necesiten consultar o modificar información de forma automática. Algunos ejemplos son:

• Consultar el estado de una solicitud, pedido, cuenta o servicio.
• Buscar información de un cliente a partir de su documento o número telefónico.
• Registrar leads obtenidos durante una conversación.
• Insertar resultados generados por un componente de investigación.
• Actualizar datos de contacto o preferencias del usuario.
• Cambiar el estado de un caso, ticket o gestión.
• Crear registros de auditoría o seguimiento.
• Validar si un cliente cumple determinadas condiciones.
• Consultar inventarios, saldos, disponibilidad o historial.
• Eliminar o depurar registros cuando las reglas del proceso lo autoricen.
• Crear tablas o estructuras necesarias para un proceso controlado.
• Entregar datos de la base a otro componente del Routing Point.

Por ejemplo, un flujo puede ejecutar primero el componente Investigación Profunda, almacenar sus hallazgos en $ResDeepR y enviar posteriormente esa variable a Agentic BD para estructurar e insertar la información en una tabla MySQL.

Configuración del componente

1. En la barra lateral, selecciona la pestaña “Cognitivos”. Dentro de la sección Agentes, ubica el componente Agentic BD.
2. Arrástralo al lienzo de diseño.
3. Haz doble clic izquierdo sobre el componente para abrir su panel de configuración en el costado derecho.

En la pestaña “Nombre”, escribe una identificación que permita reconocer fácilmente la función del componente dentro del flujo.

Algunos ejemplos son:

• Consultar cliente.
• Registrar prospecto.
• Actualizar estado de solicitud.
• Guardar resultado de investigación.
• Validar saldo.

Selecciona la pestaña “Descripción” e ingresa información complementaria sobre el objetivo del componente.

Puedes indicar qué base de datos utiliza, qué operación ejecuta o en qué momento del flujo debe activarse.

Completa los campos de conexión:

• Usuario BD: nombre del usuario autorizado para acceder a la base de datos.
• Password DB: contraseña correspondiente al usuario configurado.
• Servidor IP: dirección IP del servidor donde se encuentra alojada la base de datos MySQL.
• Nombre Base de datos: nombre exacto de la base de datos sobre la cual trabajará el agente.

Verifica que la información sea correcta antes de realizar la prueba del componente.

En el campo “Directrices del BD Agentico”, escribe el contexto general, el objetivo y las reglas que debe cumplir el agente al trabajar con la base de datos.

Las directrices pueden especificar:

• El rol que debe asumir el agente.
• La tabla sobre la cual puede operar.
• Los campos que debe consultar o modificar.
• El formato esperado de los datos.
• Las operaciones permitidas.
• Las acciones que no debe ejecutar.
• La forma de tratar datos ausentes.
• Las condiciones necesarias para insertar o actualizar información.

Ejemplo:

# Rol y objetivo

Eres un agente especializado en extracción de datos y administración de bases de datos.

Debes analizar la información recibida, identificar los datos del prospecto e insertarlos en la tabla `prospectos`.

# Campos

- empresa
- ciudad
- telefono
- correo
- direccion
- notas
- fuente

# Reglas

- No inventes información.
- Cuando un dato no esté disponible, utiliza `null`.
- No elimines registros.
- No modifiques tablas diferentes a `prospectos`.
- Antes de insertar, valida que el registro no esté duplicado.

Las directrices deben establecer con claridad el alcance del agente. El componente utilizará estas instrucciones como referencia para interpretar cada solicitud.

En “Solicitud de BD”, escribe la tarea específica que debe ejecutar el agente.

La solicitud puede contener texto directo:

Consulta el cliente con documento 123456789 y devuelve su nombre, estado y saldo.

También puede utilizar una variable del flujo:

$ResDeepR

En este caso, Agentic BD recibe el contenido almacenado en la variable y lo procesa según las directrices configuradas. Esto permite conectar el componente con resultados de Investigación Profunda, mensajes del cliente, formularios, consultas anteriores u otros componentes.

Haz clic en “Probar Agente” para validar la configuración antes de incorporarla al flujo productivo.

El sistema genera un archivo HTML local en una ruta similar a:

C:/ipdialbox/download/wolkvox_agentic_mysql_test_20260724_132420.html

El reporte de prueba incluye información como:

• Fecha y hora de generación.
• Identificador del componente.
• Estado de la memoria de sesión.
• Servidor o host configurado.
• Usuario de la base de datos.
• Nombre de la base de datos.
• Directrices enviadas al agente.
• Solicitud procesada.
• Resultado de la ejecución.

El campo Result permite comprobar si la operación se realizó correctamente o conocer por qué no pudo completarse. Por ejemplo, puede indicar que faltaron datos obligatorios, que la solicitud no contenía información suficiente o que la operación solicitada no pudo ejecutarse en la base de datos.

Activa el checkbox “Habilitar Memoria de Sesión” cuando necesites que el componente conserve el contexto de ejecuciones anteriores durante la misma sesión.

• Activada: el agente puede considerar solicitudes y resultados anteriores.
• Desactivada: cada ejecución se procesa de manera independiente.

Esta opción puede utilizarse en procesos consecutivos, como consultar primero un registro y después actualizarlo utilizando el contexto ya obtenido.

En Variable resultado DB Agentico se muestra la variable predeterminada:

$ResDBAgentic

El nombre de esta variable es fijo y no puede modificarse.

En ella se almacena la respuesta generada por Agentic BD, que puede incluir:

• Los registros encontrados.
• La confirmación de una inserción.
• El resultado de una actualización.
• La cantidad de registros afectados.
• Un mensaje de validación.
• La explicación de un error o de una operación no ejecutada.

Posteriormente, $ResDBAgentic puede utilizarse para mostrar una respuesta al cliente, evaluar una condición, alimentar otro agente, guardar un registro adicional o continuar la automatización.

Haz clic en “Guardar” para aplicar los cambios realizados.