Herramientas
Que son las herramientas y como le dan capacidades a tus agentes.
Que es una herramienta
Una herramienta (tool) es una capacidad que asignas a tu agente para que pueda ejecutar acciones durante una conversacion. Sin herramientas, el agente solo puede conversar. Con herramientas, puede buscar datos, generar reportes, enviar mensajes, conectarse a sistemas externos y mas.
Tipos de herramientas
| Tipo | Descripcion | Ejemplo |
|---|---|---|
| Consulta de datos | Busca informacion en tus colecciones de datos | Buscar un equipo por serial, consultar historial de un cliente |
| Accion interna | Ejecuta funciones dentro de tu sistema | Generar un reporte PDF, asignar una tarea, localizar personal |
| Conexion externa | Conecta con APIs externas o dispositivos IoT | Llamar una API REST, enviar un comando MQTT a un sensor |
Crear una herramienta
- Ve a Herramientas en la barra lateral.
- Haz clic en Crear Tool.
- Completa la configuracion:
| Campo | Descripcion |
|---|---|
| Nombre | Identificador unico (sin espacios, ej: buscar_equipo) |
| Descripcion | Explica que hace la herramienta. El agente usa esta descripcion para decidir cuando usarla |
| Tipo | Consulta de datos, Accion interna o Conexion externa |
| Parametros | Datos que el agente solicita al usuario para ejecutar la herramienta |
Nombre y descripcion
El nombre es el identificador tecnico que el agente usa internamente. Debe empezar con letra y solo puede contener letras, numeros, guiones y guion bajo.
La descripcion es crucial: el agente la lee para decidir cuando usar la herramienta. Escribe una descripcion clara y especifica. Puedes usar el boton Mejorar con IA para optimizarla automaticamente.
Parametros
Los parametros definen que informacion debe pedir el agente al usuario antes de ejecutar la herramienta. Cada parametro tiene:
- Nombre — Identificador del parametro (ej:
serial_number) - Tipo — string, number, boolean
- Descripcion — Que representa este dato
- Requerido — Si el agente debe obtenerlo obligatoriamente
Asignar herramientas a un agente
Las herramientas se asignan durante la creacion o edicion de un agente (voz o WhatsApp). Un agente puede tener multiples herramientas asignadas.
El agente decide automaticamente cuando usar cada herramienta basandose en la conversacion y la descripcion de la herramienta.
Sugerencia automatica de parametros
Al crear una herramienta de tipo Consulta de datos, puedes usar la funcion de sugerencia automatica. Al seleccionar una coleccion, el sistema sugiere automaticamente:
- Nombre descriptivo para la herramienta
- Descripcion contextual
- Parametros basados en los campos de la coleccion
Esto acelera la creacion y asegura que los parametros coincidan con los datos disponibles.