Skip to main content

​
Qué son las herramientas

Las herramientas son capacidades que el agente puede invocar durante una conversación: finalizar la llamada, transferir a una persona, consultar datos externos, validar información, etc. La tab Herramientas del agente tiene dos paneles: las funciones generales (siempre disponibles) y las herramientas específicas que se asignaron al bot.

​
Funciones generales

Son herramientas nativas de la plataforma que puedes activar o desactivar con un toggle para cada agente: Panel de funciones generales con toggles por agente
No es necesario activar todas las funciones en todos los agentes. Activa solo las que tienen sentido para el rol de ese agente en el flujo. Por ejemplo, solo el agente de cierre necesita “Finalizar Conversación”.

​
Herramientas asignadas

Además de las funciones generales, un agente puede tener herramientas personalizadas — integraciones con sistemas externos, consultas a APIs, registros en bases de datos, etc. Estas herramientas se muestran en una tabla con:
  • Nombre — cómo las identifica el agente.
  • Documentación — descripción de qué hace y cuándo usarla (el LLM lee esto para decidir si invocarla).
  • Parámetros — los datos que la herramienta necesita para ejecutarse.
Tabla de herramientas asignadas al agente
La documentación de cada herramienta es clave. El LLM la usa para decidir si debe llamar a esa herramienta y con qué parámetros. Cuanto más clara y específica, mejor — ver Documenta bien tus herramientas para más detalle.
Para agregar herramientas a un agente, usa el botón Asignar herramientas: se abre un panel con dos tabs. Panel Asignar herramientas con la lista de herramientas disponibles para asignar
  • Asignar: eliges entre las herramientas ya creadas para el bot (buscador + checkbox por herramienta, o “Seleccionar todas”).
  • Crear nueva: el mismo formulario de creación que el botón Nuevo de Herramientas del bot (Nombre, Parámetros, Documentación, Código y Tipo de dato de retorno) — la herramienta que crees acá queda disponible también para el resto de los agentes del bot.
Tab Crear nueva del panel Asignar herramientas, con el formulario de creación
¿Quieres confirmar que el agente llama a la herramienta en el momento correcto? Pruébalo con Abrir conversación antes de publicar los cambios.

​
Variables capturadas por el bot en la conversación

El agente PostConversación (ver El canvas de agentes) no solo asigna la etiqueta de resultado — tiene asignada su propia herramienta, igual que cualquier agente puede tener las suyas, y es esa herramienta la que dispara la clasificación. Editor de la herramienta asignada al agente PostConversación, con sus parámetros y su código Además del parámetro que indica la etiqueta, esa herramienta puede tener otros parámetros que el LLM completa a partir de lo que dijo el contacto durante la llamada — por ejemplo, el motivo por el que no pudo pagar, un dato puntual que mencionó, o un resumen corto de la conversación.
Estos parámetros se agregan igual que en cualquier herramienta, con Agregar parámetro (ver Herramientas del bot) — la diferencia es que acá el LLM los completa analizando toda la conversación, no un solo mensaje del contacto.

​
Hacer visibles esos valores con extra_metadata

Por sí solos, esos parámetros solo viven dentro del código de la herramienta. Para que un valor quede disponible más adelante — por ejemplo, para que tu equipo lo vea en el caso dentro de Bot Manager sin escuchar la grabación completa — hay que cargarlo explícitamente en el diccionario especial extra_metadata, dentro del campo Código de la herramienta:
Cualquier variable que cargues ahí queda visible en el caso de esa llamada: Caso en Bot Manager mostrando los valores cargados en extra_metadata
Usa extra_metadata para todo lo que tu equipo necesite revisar rápido sin escuchar la llamada entera — un resumen de la conversación, un dato puntual que dio el contacto, el motivo detrás de una negativa, etc.