Ir al contenido

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).

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.

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.”
  1. Abre el asistente y entra a Herramientas.
  2. Pulsa Crear herramienta y elige el tipo. Se abre un panel lateral (a pantalla completa en móvil).
  3. Elige el flujo.
  4. Revisa el nombre generado (snake_case) y ajusta solo si hace falta.
  5. Escribe una descripción operativa, no de marketing.
  6. 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.”

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.
  1. Abre Playground (se abre en una pestaña nueva).
  2. Simula una conversación real del caso de uso.
  3. Verifica que el asistente invoque la herramienta cuando corresponde.
  4. 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.

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.

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.

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.
ProblemaCausa habitualCorrección
El asistente promete algo que no ejecutaAcción descrita en prompt pero sin tool funcionalCrear/activar tool o quitar promesa
La tool no aparece disponibleFlujo borrado/inactivo o credencial inválidaReparar flujo y credencial
Funciona en las pruebas pero no con clientesEstás en otro espacio de trabajo o la credencial es distintaVerificar workspace activo y conexión
Pide demasiados datos al clienteParámetros excesivos o mal definidosReducir requeridos y mejorar descripción