Herramientas a nivel del bot
La sección Herramientas del bot (no del agente) es el repositorio central de herramientas personalizadas disponibles para ese bot. Es distinta de la tab Herramientas dentro de cada agente — acá se definen las herramientas, y desde los agentes se asignan.Esta vista muestra únicamente las herramientas custom que se crearon para tu bot — integraciones con sistemas externos, consultas a APIs, etc. Las funciones generales de la plataforma (Finalizar Conversación, Transferir a Agente Humano, Detectar Correo de Voz, etc.) no aparecen acá: esas se activan por agente, desde la tab Herramientas de cada agente.
Cómo funcionan las herramientas
Cuando el agente decide invocar una herramienta, la plataforma:1
Extrae los parámetros
El LLM identifica los valores necesarios a partir del contexto de la conversación y los parámetros del archivo de campaña.
2
Ejecuta la herramienta
La plataforma llama al servicio externo (API, base de datos, etc.) con los parámetros extraídos.
3
Devuelve el resultado al agente
El resultado se incorpora al contexto del LLM para que el agente pueda usarlo en su respuesta.
Cómo crear una herramienta
Puedes crear una herramienta nueva desde el botón Nuevo de esta vista, o desde la tab Herramientas de un agente (ver Herramientas del agente) — el formulario es el mismo en los dos casos.
1
Nombre
El identificador con el que el agente va a referenciar la herramienta.
2
Parámetros
Con Agregar parámetro defines cada dato que la herramienta necesita: su nombre, el tipo de dato (
str, int, float, bool, dict, listas de esos tipos, o una versión opcional con valor por defecto) y una descripción.3
Documentación
El docstring de la herramienta: qué hace, cuándo usarla y qué devuelve. Es lo que el LLM lee para decidir si la invoca — cuanto más clara y específica, mejor.
4
Código
El cuerpo de la función, en Python — no incluye la línea
def, la plataforma la agrega automáticamente. Tiene que incluir un return (un valor, None, o vacío) y puede leer y modificar el diccionario context de la conversación, igual que en la tab Lógica de un agente.5
Tipo de dato de retorno
El tipo de dato que devuelve la herramienta (
str, int, float, bool, dict, listas de esos tipos, o Otro para especificar un tipo personalizado).