Creando Herramientas de IA
Dale superpoderes a tu asistente de IA con herramientas personalizadas
El constructor visual de nodos SmartFlow de AI SmartTalk te permite crear herramientas personalizadas para tu asistente de IA sin necesidad de escribir código. Estas herramientas amplían las capacidades de tu IA más allá de la conversación hacia acciones reales.
¿Qué Son las Herramientas de IA?
Las herramientas (también llamadas "llamadas a funciones") permiten que tu IA realice tareas específicas durante las conversaciones. En lugar de solo responder preguntas, tu IA puede:
- Buscar en tu catálogo de productos
- Reservar citas
- Crear tickets de soporte
- Consultar el estado de un pedido
- Y mucho más
Sin Herramientas vs Con Herramientas
| Escenario | Sin Herramientas | Con Herramientas |
|---|---|---|
| Estado del Pedido | "Por favor visita nuestro sitio web para verificar tu pedido" | La IA obtiene la información de seguimiento y la muestra al instante |
| Reserva de Citas | "Llámanos al 555-1234 para programar" | La IA verifica la disponibilidad y reserva el horario |
| Búsqueda de Productos | "Navega por nuestro catálogo en..." | La IA busca y muestra productos coincidentes |
Creando Herramientas con SmartFlow
Utiliza el disparador Conversation Tool para crear herramientas que tu IA pueda usar durante los chats.
Paso 1: Crear un Nuevo SmartFlow
- Ve a Automatización → SmartFlows
- Haz clic en + Nuevo SmartFlow
- Dale un nombre descriptivo (por ejemplo, "Herramienta de Búsqueda de Productos")
Paso 2: Agregar el Disparador de Herramienta de Conversación
Arrastra el disparador Conversation Tool al lienzo:
Configura el disparador:
| Campo | Descripción |
|---|---|
| Nombre | Nombre de la herramienta que la IA reconocerá |
| Descripción | Ayuda a la IA a entender cuándo usar esta herramienta |
| Segmentación de Usuarios | Quién puede usar esta herramienta (todos los usuarios, solo conectados, etc.) |
| Variables de Herramienta | Parámetros que la IA debe recopilar del usuario |
Paso 3: Definir Variables
Agrega variables que tu IA debe recopilar de manera conversacional:
| Variable | Tipo | Descripción |
|---|---|---|
productName | String | Qué producto buscar |
maxPrice | Number | Filtro de precio máximo |
category | String | Categoría del producto |
La IA preguntará naturalmente a los usuarios por estos valores durante la conversación.
Paso 4: Agregar Acciones
Conecta acciones para realizar el trabajo real:
Combinaciones comunes de acciones:
| Caso de Uso | Acciones |
|---|---|
| Búsqueda de Productos | Buscar Conocimiento → Establecer Observación |
| Creación de Tickets | JIRA Crear Problema → Establecer Observación |
| Cita | Llamada API (calendario) → Enviar Mensaje |
| Consulta de Pedido | Llamada API (e-commerce) → Establecer Observación |
Paso 5: Devolver Resultados con Establecer Observación
Utiliza Establecer Observación para enviar resultados de vuelta a la IA:
La IA recibe la observación y la utiliza para responder al usuario.
Paso 6: Prueba Tu Herramienta
Haz clic en ▶ Prueba para probar tu herramienta:
- Crea una conversación de prueba
- Escribe un mensaje que deba activar tu herramienta
- Observa cómo se ejecuta el flujo
- Verifica que la IA responda correctamente
Ejemplo: Herramienta de Búsqueda de Productos
Objetivo: Permitir a los usuarios buscar productos preguntando de manera natural
Configuración del Disparador:
- Nombre:
searchProducts - Descripción: "Buscar en el catálogo de productos por nombre, categoría o precio"
- Variables:
query(String),maxPrice(Number, opcional)
Flujo:
Conversation Tool Trigger
↓
Search Knowledge Base
→ Query: {{trigger.query}}
→ Limit: 5 results
↓
Set Observation
→ Results: {{searchResults}}
Experiencia del Usuario:
Usuario: ¿Tienen widgets azules por debajo de €50?
IA: Déjame buscar eso...
Encontré 3 widgets azules por debajo de €50:
1. Widget Azul Básico - €29.99
2. Widget Azul Pro - €45.00
3. Widget Azul Mini - €19.99
¿Te gustaría más detalles sobre alguno de estos?
Ejemplo: Creación de Tickets en JIRA
Objetivo: Permitir a los usuarios crear tickets de soporte desde el chat
Configuración del Disparador:
- Nombre:
createTicket - Descripción: "Crear un ticket de soporte para problemas técnicos"
- Variables:
title(String),description(String),priority(String)
Flujo:
Conversation Tool Trigger
↓
JIRA Create Issue
→ Project: SUPPORT
→ Type: Bug
→ Summary: {{trigger.title}}
→ Description: {{trigger.description}}
↓
Set Observation
→ "Ticket {{jiraIssue.key}} creado con éxito"
Mejores Prácticas
Descripciones Claras de Herramientas
Escribe descripciones que ayuden a la IA a entender cuándo usar cada herramienta:
// Bueno
"Buscar en el catálogo de productos por nombre, categoría o rango de precios"
// Demasiado vago
"Buscar productos"
Nombres de Variables Significativos
Utiliza nombres de variables descriptivos y descripciones:
| Variable | Descripción |
|---|---|
customerEmail | Dirección de correo electrónico para buscar el pedido |
appointmentDate | Fecha preferida para la cita |
Manejo de Errores de Manera Elegante
Incluye manejo de errores en tus observaciones:
// Éxito
{"found": true, "results": [...]}
// Sin resultados
{"found": false, "message": "No hay productos que coincidan con tu búsqueda"}
Prueba de Manera Conversacional
Prueba tus herramientas conversando de manera natural, no solo haciendo clic en botones. Asegúrate de que la IA:
- Pregunte por las variables requeridas de manera natural
- Utilice la herramienta en el momento adecuado
- Presente los resultados de manera clara
Documentación Relacionada
- Introducción a SmartFlow — Aprende sobre el constructor de nodos
- Disparador de Herramienta de Conversación — Referencia completa del disparador
- Observaciones — Devolviendo datos a la IA
- Resumen de Acciones — Todas las acciones disponibles