Asistentes virtuales
Configurar herramientas paso a paso
Usa esta guía cuando quieras que tu asistente haga acciones reales (agendar, buscar datos, actualizar CRM, enviar mensajes o ejecutar flujos).
1) Preparar requisitos
Sección titulada «1) Preparar requisitos»Antes de crear la herramienta, confirma:
- El asistente existe y está en borrador o activo.
- El flujo de Flow Studio existe y tiene un trigger compatible con tool.
- Si el flujo usa integraciones externas, sus credenciales están conectadas.
- Tienes permisos para editar asistente y flujo.
2) Definir la acción de negocio
Sección titulada «2) Definir la acción de negocio»Escribe en una línea qué debe hacer la herramienta y con qué datos mínimos.
Ejemplos:
- “Consultar horarios disponibles para una fecha y devolver opciones.”
- “Crear oportunidad CRM con nombre, teléfono y producto.”
- “Buscar estado de pedido por documento y teléfono.”
3) Crear la herramienta en el asistente
Sección titulada «3) Crear la herramienta en el asistente»- Abre el asistente y entra a Herramientas.
- Pulsa Crear herramienta y elige el tipo. Se abre un panel lateral (a pantalla completa en móvil).
- Elige el flujo.
- Revisa el nombre generado (
snake_case) y ajusta solo si hace falta. - Escribe una descripción operativa, no de marketing.
- Pulsa Crear al pie del panel. Si cierras con cambios sin guardar, se te pide confirmar.
Todas las herramientas se configuran en ese mismo panel: tocar una fila de la lista lo abre. Cada fila muestra su estado (Configurada, Incompleta o Desactivada) , un interruptor para activarla o pausarla sin perder su configuración y un botón para eliminarla (pide confirmación). Ambos viven solo en la fila, no dentro del panel, y valen para todas las herramientas, incluidas transferir a un humano y seguimiento. Una herramienta incompleta no se puede activar hasta que completes sus datos; al pasar el cursor o enfocar el interruptor, un texto explica por qué. El panel abierto queda en la dirección del navegador, así que puedes compartirlo o recargar sin perderlo.
Buena descripción: “Busca disponibilidad en scheduler X y devuelve horarios en zona local.”
Mala descripción: “Agenda citas de forma increíble.”
4) Definir parámetros
Sección titulada «4) Definir parámetros»Cada parámetro debe tener nombre, tipo, descripción y requerido/opcional.
Recomendaciones:
- Usa nombres estables (
fecha,telefono,documento,producto). - Marca como requerido solo lo que sea imprescindible.
- Si el flujo necesita dos validaciones, decláralas explícitamente.
- Evita pedir un dato que luego el flujo no usa.
5) Probar en Playground
Sección titulada «5) Probar en Playground»- Abre Playground (se abre en una pestaña nueva).
- Simula una conversación real del caso de uso.
- Verifica que el asistente invoque la herramienta cuando corresponde.
- Repite con un caso negativo para confirmar que no promete acciones no disponibles.
Si no invoca la tool:
- mejora la descripción;
- revisa los parámetros;
- confirma que la fila de la herramienta tenga el interruptor activado y no figure como Incompleta.
6) Validar en ejecuciones
Sección titulada «6) Validar en ejecuciones»Revisa Ejecuciones (se abre en una pestaña nueva) y la conversación:
- parámetros recibidos;
- respuesta del flujo;
- errores de credenciales o permisos;
- latencia por nodo.
7) Pasar revisión antes de activar
Sección titulada «7) Pasar revisión antes de activar»Ejecuta la revisión antes de activar (se abre en una pestaña nueva). Corrige cualquier bloqueo por herramientas huérfanas, credenciales faltantes o canales no listos.
8) Publicar y monitorear
Sección titulada «8) Publicar y monitorear»Al publicar:
- monitorea primeras conversaciones;
- verifica que la tool no se dispare fuera de contexto;
- ajusta prompt y descripción si hay sobreactivación o subactivación.
Errores comunes
Sección titulada «Errores comunes»| Problema | Causa habitual | Corrección |
|---|---|---|
| El asistente promete algo que no ejecuta | Acción descrita en prompt pero sin tool funcional | Crear/activar tool o quitar promesa |
| La tool no aparece disponible | Flujo borrado/inactivo o credencial inválida | Reparar flujo y credencial |
| Funciona en las pruebas pero no con clientes | Estás en otro espacio de trabajo o la credencial es distinta | Verificar workspace activo y conexión |
| Pide demasiados datos al cliente | Parámetros excesivos o mal definidos | Reducir requeridos y mejorar descripción |
