Herramienta de Conversación
Crea una herramienta que la IA pueda usar durante las conversaciones. La IA decide cuándo llamarla según el contexto.
Cuándo Usar
Usa este disparador para extender lo que tu IA puede hacer:
- Buscar productos en tu catálogo
- Verificar el estado de un pedido en tu sistema
- Consultar datos de clientes en CRM
- Crear tickets de soporte en JIRA
- Reservar citas
- Cualquier capacidad personalizada
Configuración
Configuración Básica
| Campo | Descripción |
|---|---|
| Nombre de la Herramienta | Nombre legible para humanos (mostrado en la Biblioteca de Nodos) |
| Descripción | Explica cuándo/cómo la IA debería usar esta herramienta |
Segmentación de Usuarios
Elige quién puede usar esta herramienta:
| Opción | Descripción |
|---|---|
| Todos los Usuarios | Usuarios anónimos + usuarios conectados |
| Solo Usuarios Conectados | Solo usuarios que han iniciado sesión |
| Acceso Basado en Roles | Roles de usuario específicos |
Variables de la Herramienta
Define los parámetros que la IA necesita recopilar del usuario:
| Campo | Descripción |
|---|---|
| Nombre de Variable | Nombre interno (por ejemplo, query, orderId) |
| Descripción | Ayuda a la IA a entender qué preguntar |
Las variables se vuelven disponibles como {{variableName}} en tu flujo.
Cómo Funciona
- Defines una herramienta con nombre, descripción y variables
- La IA aprende cuándo usarla a partir de tu descripción
- El usuario pregunta algo relacionado (por ejemplo, "Encuéntrame una laptop")
- La IA recopila las variables requeridas de manera conversacional
- El flujo se ejecuta con los datos recopilados
- El resultado regresa a la IA para la respuesta final
Nombrando Tus Herramientas: Por Qué Es Importante
Cuando tu asistente de IA tiene acceso a múltiples herramientas, elige cuál llamar basándose en tres cosas únicamente: el nombre de la herramienta, la descripción de la herramienta y las descripciones de las variables. No puede ver lo que hay dentro del flujo — lee el texto y decide.
Si esos tres campos son vagos o demasiado similares entre herramientas, la IA elegirá la herramienta incorrecta. Estudios sobre la llamada de funciones de LLM muestran que mejorar la claridad de la descripción por sí sola puede aumentar la selección correcta de herramientas en 15–20 puntos porcentuales, sin cambiar el modelo subyacente.
Esto es especialmente crítico cuando tienes varias herramientas que buscan diferentes bases de conocimiento — desde la perspectiva de la IA, todas "buscan información". El nombre y la descripción son la única forma en que puede diferenciarlas.
Nombre de la Herramienta
Usa el patrón dominio_accion_objetivo para que el nombre por sí solo distinga cada herramienta:
| ❌ Vago | ✅ Claro |
|---|---|
Buscar | rgpd_analisis_legal |
buscar_docs | ecommerce_busqueda_producto |
Herramienta 2 | consulta_ticket_soporte |
La IA usa el nombre como un primer filtro antes de leer la descripción. Un nombre claro le permite hacer una lista instantáneamente; un nombre genérico le obliga a adivinar.
Descripción de la Herramienta
La descripción es tu palanca más poderosa. Usa esta fórmula:
[Lo que hace — 1 oración]
Usar para: [3–5 casos de uso concretos con las palabras que realmente usarían tus usuarios]
❌ Malo:
Buscar en la base de conocimiento información.
✅ Bueno:
Busca sanciones de la CNIL y jurisprudencia del CJUE.
Usar para: encontrar decisiones de sanciones por sector o tipo de violación,
consultar montos de multas, citar precedentes legales,
evaluar el riesgo financiero de incumplimiento del RGPD.
Las palabras dentro de "Usar para" actúan como disparadores semánticos. Cuando el mensaje de un usuario contiene "multa", "sanción" o "riesgo", la IA lo empareja inmediatamente con esta herramienta.
Descripciones de Variables
Una variable descrita como "La consulta de búsqueda" no le dice nada a la IA. Pegará la pregunta cruda del usuario cada vez. Una mejor descripción guía a la IA para extraer las palabras clave correctas antes de enviarlas.
| ❌ Vago | ✅ Claro |
|---|---|
La consulta de búsqueda | Consulta de búsqueda: tipo de violación, nombre de la empresa, sector, monto de la multa o concepto legal |
Entrada del usuario | Tipo de documento solicitado: plantilla, modelo, formulario, cláusula o contrato |
Esto empuja a la IA a reformular en lugar de copiar todo el mensaje del usuario — resultando en búsquedas más específicas y mejores resultados.
Evitando Conflictos de Herramientas
Cuando dos herramientas pueden responder la misma pregunta, la IA duda — y a veces elige al azar. Cada herramienta debe cubrir un territorio exclusivo.
La regla: si puedes pensar en una pregunta de usuario que podría ir a cualquiera de las herramientas, tus descripciones necesitan más precisión.
Ejemplo — 5 herramientas de cumplimiento con límites claros:
| Herramienta | Cubre | NO cubre |
|---|---|---|
cumplimiento_analisis_legal | Artículos de ley, obligaciones legales, derechos | Sin consejos prácticos, sin casos del mundo real |
cumplimiento_metodologia | Guías paso a paso, procedimientos de auditoría, marcos | Sin texto legal, sin plantillas |
cumplimiento_plantillas_documento | Modelos listos para usar, formularios, cláusulas de contrato | Sin metodología, sin análisis legal |
cumplimiento_procesos_empresariales | Flujos de trabajo operativos, circuitos de aprobación | Sin texto legal, solo procesos internos |
cumplimiento_soluciones_operativas | Soluciones concretas, recomendaciones técnicas | Sin teoría, solo soluciones accionables |
Cuanto más específicas sean las descripciones sobre lo que cubre la herramienta, menos ambigüedad habrá. No necesitas escribir exclusiones explícitas — la precisión hace el trabajo.
Lista de Verificación Rápida
Antes de publicar un flujo con un disparador de Herramienta de Conversación, verifica:
- Nombre sigue
dominio_accion_objetivo— distinguible sin leer la descripción - Descripción comienza con lo que hace la herramienta en 1 oración
- Descripción incluye "Usar para:" con 3–5 casos de uso concretos
- Descripciones de variables enumeran los tipos de información esperados, no solo "la consulta"
- Sin superposición con el territorio de otra herramienta
- Probado con 2–3 preguntas ambiguas en el panel de Prueba para confirmar el enrutamiento correcto
Ejemplo: Búsqueda de Productos
Configuración de la Herramienta:
- Nombre:
ecommerce_busqueda_producto - Descripción: Busca en el catálogo de productos por nombre, categoría o característica. Usar para: encontrar un producto específico, comparar productos en una categoría, verificar si un producto existe, consultar especificaciones o precios de productos.
- Variable:
query— "Nombre del producto, categoría, característica o rango de precios a buscar"
Flujo:
- Disparador: Herramienta de Conversación
- Acción: Buscar en la Base de Conocimiento (
{{query}}) - Acción: Establecer Observación (devolver resultados)
Conversación del usuario:
Usuario: "¿Tienes auriculares inalámbricos?"
IA: llama a ecommerce_busqueda_producto con query="auriculares inalámbricos"
IA: "¡Sí! Encontré 3 auriculares inalámbricos. Los Sony WH-1000XM5 son nuestros más vendidos a €349..."
Ejemplo: Ticket de JIRA
Configuración de la Herramienta:
- Nombre:
soporte_crear_ticket_jira - Descripción: Crea un ticket de soporte en JIRA a partir de la conversación. Usar para: cuando el usuario informa un error, solicita una función o necesita escalar un problema al equipo técnico.
- Variables:
title— "Resumen corto del problema (1 oración)",description— "Descripción detallada que incluye pasos para reproducir, comportamiento esperado y comportamiento real"
Flujo:
- Disparador: Herramienta de Conversación
- Acción: Solicitud de IA (generar título/descripción)
- Paralelo: Generar descripción + título
- Acción: JIRA Crear Problema
