Introducción

El componente Agentic Key de wolkvox Studio permite crear procesos autónomos en los que un agente de inteligencia artificial actúa como orquestador central, analiza un objetivo, mantiene el contexto de la ejecución, toma decisiones y coordina otros subagentes o herramientas para completar una tarea.

A diferencia de una automatización tradicional, en la que cada paso debe conectarse de forma estrictamente secuencial, Agentic Key puede determinar qué herramienta necesita utilizar, evaluar el resultado obtenido y continuar con la siguiente acción o replantear el proceso cuando sea necesario. Puede percibir, mantener el contexto, razonar, actuar y validar el resultado de las tareas, incluso realizando nuevos ciclos cuando una acción no obtiene inicialmente el resultado esperado.

Por ejemplo, un Agentic Key puede recibir como objetivo procesar solicitudes de cotización y, a partir de este objetivo, coordinar un subagente para consultar correos, otro para buscar productos en una base de datos, otro para responder al cliente y otro para registrar la gestión realizada. 

El componente se encuentra dentro del grupo Cognitivos de wolkvox Studio y está disponible para routing points de tipo Agentic Engine.

¿Para qué puedes usar Agentic Key?

Algunos escenarios en los que puedes utilizar este componente son:

• Automatizar procesos comerciales que requieran consultar diferentes fuentes antes de ejecutar una acción.
• Procesar solicitudes recibidas por correo y responderlas automáticamente.
• Consultar información de productos, inventarios, clientes u otras bases de datos.
• Coordinar varios subagentes especializados dentro de un mismo proceso.
• Crear cotizaciones o propuestas a partir de información recibida en lenguaje natural.
• Registrar automáticamente el resultado de una gestión en una base de datos.
• Ejecutar procesos que requieren verificar si una tarea rea lmente fue completada antes de continuar.
• Diseñar automatizaciones que puedan reaccionar ante errores o resultados incompletos sin depender únicamente de un flujo lineal.

¿Cómo configurar y usar el componente Agentic Key?

Abre la configuración del componente

1. Ingresa al routing point de tipo Agentic Engine que deseas configurar. Dentro del panel de componentes, selecciona el grupo “Cognitivos”, ubica el componente “Agentic Key” y arrástralo hasta el lienzo del flujo. Conecta el componente según la lógica que necesites implementar. Haz doble clic izquierdo sobre “Agentic Key” para abrir su panel de configuración.
2. Desde este panel puedes definir el modelo de inteligencia artificial que utilizará, las herramientas disponibles, los subagentes que podrá coordinar, su objetivo, las intenciones y variables que necesites obtener y la variable donde se almacenará su respuesta.

Selecciona el Modelo IA

En “Modelo IA” selecciona el modelo que utilizará Agentic Key para analizar el contexto, razonar y determinar las acciones que debe ejecutar.

Las opciones disponibles son:

• Rápido: prioriza la velocidad y es apropiado para procesos sencillos que requieren menor tiempo de respuesta.
• Inteligente: prioriza una mayor precisión en la comprensión del contexto y en la toma de decisiones.
• Razonador: utiliza mayores capacidades de razonamiento para escenarios con más condiciones o procesos complejos.
• Automático: permite que wolkvox seleccione dinámicamente el modelo más apropiado según la complejidad de cada situación.

Configura las herramientas disponibles

La sección Herramientas permite establecer las fuentes, funciones y subagentes que Agentic Key podrá utilizar para cumplir el objetivo definido.

wvx Copilot

En la pestaña “wvx copilot” puedes seleccionar un dominio de conocimiento previamente configurado.

Si seleccionas un dominio, Agentic Key puede utilizar ese conocimiento como contexto adicional durante la ejecución.

Si seleccionas “none”, no se utilizará conocimiento proveniente de wvx Copilot.

wvx search

Ingresa a la pestaña “wvx search” para proporcionar URLs que puedan utilizarse como fuentes adicionales de información.

Agrega una URL por línea.

Estas URLs deben ser públicas y no deben requerir autenticación. La calidad de la información obtenida dependerá del contenido disponible en las páginas registradas.

Funciones

La pestaña “Funciones” contiene una tabla con las columnas:

• Name
• Description
• Variables

Desde esta sección puedes consultar las funciones disponibles previamente creadas con el componente “Funciones (Con IA)”.

Subagents

La pestaña “Subagents” es una de las configuraciones principales de Agentic Key.

Aquí se muestran los subagentes disponibles junto con su descripción. Activa mediante el checkbox aquellos que deseas poner a disposición del Agentic Key.

Cada subagente debe tener una responsabilidad concreta. Agentic Key utilizará estos agentes como herramientas especializadas y decidirá cuándo debe delegarles una tarea de acuerdo con el objetivo y las instrucciones configuradas.

En el ejemplo suministrado se utilizan cuatro subagentes:

• Uno encargado de consultar y leer correos.
• Uno encargado de consultar información de productos en una base de datos.
• Uno encargado de responder el correo con una cotización.
• Uno encargado de registrar el resultado de la gestión en una base de datos.

Las instrucciones del ejemplo establecen además qué responsabilidad tiene cada subagente y el orden lógico del proceso.

Agentic Key no se limita simplemente a ejecutar esos agentes como una secuencia fija. Puede comprobar sus resultados y realizar nuevos ciclos cuando necesita completar o corregir una tarea. En la demostración, por ejemplo, se explica que el agente puede volver sobre una acción cuando no está seguro de que haya finalizado correctamente.

Define el objetivo y las reglas del Agentic Key

Ingresa a la pestaña “Objetivo, tono de la conversación”.

Este campo contiene las instrucciones principales que Agentic Key utilizará para saber qué debe conseguir y cómo debe actuar para conseguirlo.

Aquí puedes establecer, entre otros aspectos:

• El rol que tendrá el agente.
• Su objetivo principal.
• Las tareas que debe completar.
• Los subagentes disponibles.
• Para qué sirve cada subagente.
• En qué orden lógico deben utilizarse cuando el proceso así lo requiera.
• Las validaciones que debe realizar.
• Las reglas que no debe incumplir.
• El comportamiento esperado ante errores.
• Las condiciones para considerar finalizada una tarea.
• El tono y estilo de las respuestas, cuando el proceso implique comunicación con un cliente.

Recomendación

El prompt debe definir con claridad:

Rol → objetivo → herramientas disponibles → responsabilidades → reglas → validaciones → manejo de errores → condición de finalización.

No es necesario convertir cada paso en un bloque independiente dentro del lienzo. Precisamente una de las ventajas de Agentic Key es que puede concentrar gran parte de esa lógica dentro de su configuración y delegarla posteriormente a los subagentes correspondientes.

Define el orden para el Agente Clave

Debajo del campo de objetivo se encuentra “Order para el Agente Clave”.

Utiliza este espacio cuando necesites proporcionar instrucciones adicionales relacionadas con el orden, prioridad o comportamiento que debe seguir el Agentic Key durante la ejecución.

Este campo puede complementar las instrucciones generales definidas anteriormente cuando el proceso requiera establecer una secuencia o prioridad concreta.

Configura intenciones y extracción de variables

Ingresa a la pestaña “Intenciones y extracción de variables”.

Esta sección permite identificar determinadas intenciones y almacenar información obtenida durante la ejecución en variables que posteriormente puedan utilizarse dentro del flujo.

La tabla contiene:

• Intention: intención configurada.
• words: palabras relacionadas con esa intención.
• Variables: variables asociadas.

Haz clic en el botón “+” para crear una nueva intención.

Configura la intención

Define:

Intención: establece el nombre que permitirá identificarla.

Palabras separadas por comas para las intenciones: escribe las palabras o expresiones que ayudarán a relacionar la información procesada con esa intención.

Después puedes agregar variables asociadas mediante el botón “+”.

Al agregar una variable debes configurar:

Nombre de la variable: nombre bajo el cual se almacenará el dato obtenido.

Prompt variable: instrucción que explica a la inteligencia artificial qué información debe identificar y guardar.

Por ejemplo:

Nombre de la variable: nombre_cliente

Prompt variable: Identifica y guarda el nombre del cliente encontrado durante el proceso.

Da clic en “Adicionar variable” para agregarla.

Los prompts de extracción deben ser específicos y concentrarse en el dato que quieres almacenar, sin agregar instrucciones que no correspondan a la extracción.

Cuando termines de configurar la intención y sus variables, da clic en “Adicionar intención”.

Configura la Respuesta IA

En el campo “Respuesta IA” define la variable donde se almacenará el resultado generado por la inteligencia artificial.

En la interfaz presentada aparece, por ejemplo: $var_conver 

Esta variable puede utilizarse posteriormente dentro del flujo para recuperar el resultado generado por Agentic Key.

El componente Conversaciones utiliza este mismo mecanismo para almacenar la respuesta de la IA.

Guarda la configuración

Una vez hayas terminado de configurar:

• ASR.
• Modelo IA.
• Herramientas.
• Subagentes.
• Objetivo e instrucciones.
• Intenciones y variables, si las necesitas.
• Variable de respuesta.

Da clic en “Guardar”.