En esta guía aprenderás a utilizar el Buscador de variables con Buk IA, una herramienta diseñada para ayudarte a encontrar la etiqueta correcta directamente desde el editor de plantillas utilizando un lenguaje natural y cotidiano. Con esta nueva funcionalidad, ya no será necesario que conozcas o memorices el nombre exacto de las variables Liquid (como, por ejemplo, {{empleado.nombre}}), resolviendo así un problema común que solía generar dudas frecuentes y errores al momento de crear o modificar documentos.
Al utilizar esta función, simplemente podrás escribir lo que necesitas (por ejemplo: "Necesito una variable que muestre el nombre del colaborador") y el asistente virtual se encargará de entregarte la variable correcta junto con su descripción. Ten en consideración que este buscador se encuentra disponible para las plantillas del tipo Carta de Oferta y se irá activando de forma progresiva según el plan de despliegue del sistema.
Paso a paso
Paso 1: Ingresa al editor de plantillas
Para comenzar, dirígete al módulo de documentos para abrir tu editor. Puedes realizar esta acción ya sea en el momento que estés creando una plantilla completamente nueva, o bien, cuando decidas editar una plantilla que ya exista en tu plataforma.
RUTA: Documentos y Firma → Editor de plantillas
Paso 2: Despliega el menú de variables
Una vez allí, y con la pantalla de edición abierta, ubica y presiona el botón de variables, el cual podrás identificar fácilmente por el símbolo { }. Al hacer esto, el sistema desplegará en tu pantalla un listado completo con todas las variables que se encuentran disponibles para tu uso.
Paso 3: Activa la asistencia de Buk IA
Luego, dentro de ese mismo menú que acabas de abrir, busca y selecciona la opción que indica "No encuentro la variable...". Tras seleccionarla, notarás que se desplegará automáticamente un panel lateral (aside) de Buk IA en el lado derecho de tu pantalla, el cual estará listo para ayudarte con tu búsqueda.
Paso 4: Realiza tu consulta en lenguaje natural
A continuación, dirígete a este nuevo panel lateral. En este espacio, podrás escribir con tus propias palabras exactamente lo que estás buscando. Por ejemplo, puedes ingresar una frase sencilla como: "Quiero mostrar la fecha de ingreso del colaborador".
Paso 5: Copia y aplica la variable sugerida
Finalmente, luego de enviar tu consulta, Buk IA procesará tu solicitud y te responderá indicándote cuál es la variable más adecuada para lo que necesitas (en este ejemplo, te entregará {{empleado.fecha_ingreso}}), acompañándola además de una descripción para que comprendas su función. Con esto, solo te quedará copiar la variable que te entregó el asistente y pegarla directamente en la sección del editor donde deseas colocarla.
Resultado esperado
Si realizaste el procedimiento correctamente, habrás logrado insertar la variable Liquid exacta dentro de tu documento sin necesidad de haber conocido su nombre técnico de antemano. Esto permitirá que la plataforma reemplace dicha variable por los datos reales del colaborador de forma automática al momento de generar el documento final.
Consideraciones adicionales
Para asegurar una mejor experiencia, te recomendamos tener en cuenta los siguientes consejos útiles sobre el funcionamiento de esta herramienta:
Contexto de búsqueda: Buk IA está entrenado especialmente para responderte únicamente sobre aquellas variables que correspondan al tipo de plantilla que estés editando en ese momento (por ejemplo, si estás en Contratos, Liquidaciones, Cartas de Oferta, etc., las respuestas se basarán en ese contexto).
Reformulación de consultas: Si en algún momento notas que la variable sugerida por el asistente no es del todo precisa, te sugerimos reformular tu pregunta utilizando otras palabras para que la IA pueda entregarte una mejor respuesta.
Descripciones enriquecidas: Recuerda revisar siempre las descripciones de las variables en el listado general. Para facilitar su comprensión, estas descripciones ahora se generan automáticamente utilizando Inteligencia Artificial.
Mejora continua: ¡Ten en cuenta que esta es una de las primeras integraciones entre el módulo de Documentos y Buk AI! El sistema se seguirá desarrollando y mejorando constantemente gracias a tu feedback y experiencia de uso.