AI Tools te permite definir conexiones API externas que tu asistente de IA (prompts Specialist) puede llamar durante las conversaciones. En lugar de codificar las llamadas a la API directamente en tu flujo, la IA decide cuándo y cómo usar cada herramienta según el contexto de la conversación.

Ve a Integrate > AI Tools para acceder a la función.

📘 Función en beta AI Tools está actualmente en beta. Está disponible para bots con AI Specialist habilitado.

Resumen

La página AI Tools muestra todas tus definiciones de herramientas. Las herramientas se organizan en dos pestañas:

• Tools: herramientas de tipo API que llaman a endpoints externos

• Auth Tokens: tokens de autenticación HTTP usados por tus herramientas API

Puedes buscar herramientas por nombre y ordenarlas por nombre, tipo, descripción, fecha de última actualización o autor.

Cada herramienta muestra su método HTTP como una etiqueta (GET, POST, PUT, DELETE).

Crear una herramienta

Haz clic en Add a New Tool para abrir el asistente de creación. El asistente te guía a través de cuatro pasos.

Paso 1 — About

Proporciona los datos básicos que ayudan a la IA a entender cuándo y por qué usar esta herramienta.

• Tool Name: usa una frase verbo-sustantivo (por ejemplo, "Check Flight Status", "Get Order Details")

• Description: describe el problema específico que resuelve esta herramienta

📘 Cómo usa la IA esta información A diferencia del software tradicional, el Name y la Description no son solo etiquetas: son instrucciones. La IA los lee para decidir si y cuándo usar esta herramienta durante una conversación.

Paso 2 — API Connection

Configura cómo la herramienta llama a tu API externa.

Collect data inputs

Define los parámetros que tu herramienta espera de la conversación. Para cada parámetro, especifica:

• Name: el nombre de la variable (por ejemplo, order_id, flight_number)

• Format: Text, Number, Integer, Boolean, Enum, Array o Object

• Required or Optional: los parámetros obligatorios usan la sintaxis ${variable}, los opcionales usan ?{variable}

• Description: ayuda a la IA a entender qué datos recopilar del usuario

HTTP Method

Selecciona el método para tu solicitud API: GET, POST, PUT o DELETE.

URL

Introduce la URL del endpoint. Puedes insertar tus data inputs y las variables de tu bot usando el selector de variables (icono de corchetes). Las variables aparecen como badges en el campo URL.

Example: https://api.example.com/orders/${order_id}

Headers

Añade headers a tu solicitud. Hay dos tipos disponibles:

• Key-value pair: header estándar (por ejemplo, Content-Type: application/json)

• HTTP Authentication token: hace referencia a un token de autenticación preconfigurado (consulta Auth Tokens más abajo)

Body

Para las solicitudes POST/PUT, proporciona el body de la solicitud en JSON. También puedes insertar variables en el body. Puedes escribir el body o pegarlo: el contenido pegado entra tal cual y las variables que contiene aparecen como badges.

Platform variables

Además de los data inputs que recopila la IA, una herramienta puede enviar las propias variables de tu bot a tu API. Abre el selector de variables (icono de corchetes) en la URL, un header o el body. La lista tiene dos grupos:

• Data inputs: los valores que la IA recopila de la conversación. Usan la sintaxis ${variable} o ?{variable}.

• Platform variables: las variables custom, de user channel y de system de tu bot. Usan la sintaxis #{variable}.

Cuando la herramienta se ejecuta, cada platform variable se reemplaza por su valor en la conversación actual. La IA no elige ni modifica estos valores. Úsalas para datos que deben llegar a tu API exactamente tal como están, por ejemplo:

• un customer ID enviado por tu sitio web cuando el visitante ha iniciado sesión (variable de user channel)

• el idioma de la conversación (variable de system)

• un customer tier establecido antes en el flujo por un paso Data Manipulation (variable custom)

Cada variable aparece como un badge, con un color por categoría. Las variables no se pueden escribir a mano: selecciónalas de la lista, o pega un body que las contenga: también aparecen como badges. Una variable que ya no existe se marca en el campo, y la herramienta recibe un valor vacío en su lugar.

Las platform variables también están disponibles en la URL, los headers y el body de tus Auth Tokens.

📘 Consulta los valores en el Trace En el Trace de una conversación, cada llamada a herramienta muestra los valores que recibió: los data inputs completados por la IA y las platform variables resueltas por la plataforma. Consulta Trace en Flow Builder.

Paso 3 — Test Response

Antes de publicarla, prueba tu herramienta contra el endpoint real de la API.

1. Introduce un valor de prueba para cada data input y cada platform variable que use la herramienta

2. Haz clic en Test request para ejecutar la llamada

3. Revisa la respuesta JSON en bruto para verificar que sea correcta

Si la prueba tiene éxito, verás un banner verde "Successful response received (200 OK)" con el body completo de la respuesta.

Puedes omitir este paso, pero se recomienda encarecidamente probar para:

• Verificar que la conexión funciona correctamente

• Filtrar datos sensibles de la respuesta

• Asignar los resultados de la API a variables de ViaSay para usarlas en tu flujo

⚠️ Omitir la prueba Omitir este paso puede limitar tu capacidad de verificar la conexión, filtrar datos sensibles de la respuesta y asignar los resultados de la API a variables de ViaSay.

Paso 4 — Data Access

Controla a qué campos de la respuesta de la API puede acceder la IA.

• Full data access: la IA ve la respuesta JSON completa

• Manually restrict access: selecciona campos específicos para excluirlos de la respuesta que ve la IA

Esto es útil para evitar que la IA acceda a datos sensibles (por ejemplo, IDs internos, tokens o información privada de clientes).

Auth Tokens

Para las APIs que requieren autenticación, puedes configurar tokens de autenticación HTTP.

Ve a la pestaña Auth Tokens en la página AI Tools, o añade uno directamente desde el paso API Connection mediante Add a header > HTTP Authentication token.

Configura lo siguiente:

• Token title: un nombre para identificar este token (por ejemplo, "Booking API Auth")

• Description: descripción opcional

• HTTP Method / URL / Headers / Body: el endpoint de autenticación al que llamar

• Token configuration:

  • Access Token Field: el campo de la respuesta que contiene el token (por ejemplo, access_token)

  • Header Token Key: la clave de header en la que se envía el token (por ejemplo, Authorization)

  • Token Type: el prefijo del valor del token (por ejemplo, Bearer)

Haz clic en Test request para verificar que el endpoint del token funciona, y luego en Save token.

Una vez guardado, el token se puede referenciar en la sección Headers de cualquier herramienta. La plataforma llama automáticamente al endpoint del token e inyecta el token en tus solicitudes a la API.

Conectar herramientas a un Gen AI Step

Una vez creadas tus herramientas, puedes adjuntarlas a cualquier Gen AI Step en el Flow Builder.

1. Abre un paso Gen AI en el Flow Builder

2. Abre Create or Edit a prompt

3. Abre Advanced Settings

4. Activa Tools

5. Selecciona herramientas en el dropdown — las herramientas de tipo Token se excluyen automáticamente

Haz clic en una herramienta adjunta para abrir su detail panel, donde puedes:

• Ver la descripción y los parámetros de la herramienta

• Ir a la página de definición de la herramienta mediante Edit tool

• Abrir el modal Test tool para probar con valores de ejemplo

• Configurar los mapeos de Save output para extraer datos de la respuesta de la herramienta hacia variables de la conversación

Output mapping

En la sección Save output, mapea campos de la respuesta JSON de la herramienta a variables de la conversación:

1. Haz clic en + Add para crear un nuevo mapeo

2. Selecciona o crea una variable de conversación

3. Introduce una consulta JMESPath para extraer el campo deseado de la respuesta

Ejemplo: para extraer el estado del vuelo de {"status": "On Time", "gate": "B42"}, usa la consulta JMESPath status.

Editar y eliminar herramientas

Editar una herramienta

Desde la lista de AI Tools, haz clic en el menú de acciones (⋮) de cualquier herramienta y selecciona Edit. Esto abre el asistente con la configuración existente de la herramienta precargada.

También puedes acceder a la página de edición directamente desde el detail panel del Flow Builder mediante el enlace Edit tool.

⚠️ Editar una herramienta afecta a todos los prompts Al editar una herramienta existente, los cambios se aplican a todos los prompts donde esta herramienta esté adjunta.

Eliminar una herramienta

En el menú de acciones, selecciona Delete. Aparecerá un diálogo de confirmación. Esta acción no se puede deshacer.