Plataforma

Herramientas (Tools)

Una herramienta es una acción que el agente puede ejecutar cuando lo necesita: buscar en internet, consultar tu base de datos, actualizar un carrito, llamar a una API. El agente decide cuándo usarlas.

Info

Las herramientas funcionan en dos direcciones: Daguito puede usar herramientas tuyas o de terceros, y sistemas externos pueden usar las herramientas que Daguito expone. Esto hace que Daguito sea un nodo conectado en tu ecosistema, no un sistema cerrado.

Cómo el agente usa una herramienta

El agente no ejecuta herramientas al azar. Piensa primero, decide si necesita una herramienta, la invoca y continúa con la respuesta cuando tiene el resultado:

1
Usuario envía mensaje
"¿Cuánto cuesta enviar a Medellín?"
↓
2
El agente razona
Detecta que necesita información de envíos. Decide usar la herramienta consultar_tarifas.
↓
3
Ejecuta la herramienta
Llama a tu sistema con los parámetros: ciudad: "Medellín". Tu sistema devuelve el resultado.
↓
4
Genera la respuesta
Con el resultado en mano, responde al usuario: "El envío a Medellín cuesta $12 y llega en 3 días."

Los tres tipos de herramientas

Herramienta de flujo (Flow Tool)

Un subflujo completo expuesto como herramienta

Puedes convertir cualquier flujo de Daguito en una herramienta que otro agente puede invocar. El agente llama al flujo, el flujo se ejecuta con toda su lógica (nodos, condiciones, llamadas a APIs) y devuelve un resultado.

Escenario
El agente de soporte recibe: "Quiero saber el estado de mi pedido #4521"
Agente principal
→ usa →
Flujo: "consultar_pedido" Valida ID → Consulta API → Formatea respuesta
→ devuelve →
"Pedido en camino, llega el martes"
Úsalo cuando: la lógica de la herramienta es compleja (múltiples pasos, condiciones, llamadas a APIs).

Herramientas Handler (Handler Tools)

Funciones listas para usar, incluidas en Daguito

Son herramientas que vienen incluidas en Daguito. Las activas en la configuración del agente y están disponibles de inmediato, sin configuración adicional.

Búsqueda web
Busca información actualizada en internet y devuelve resultados relevantes.
Buscar en base de conocimiento
Busca en tus documentos y catálogos subidos usando búsqueda semántica en tu Base de Conocimiento.
Ver carrito
Consulta el estado del carrito de compras del usuario en la sesión actual.
Transcribir audio
Convierte audio en texto para flujos de voz o mensajes de WhatsApp con notas de voz.
Úsalo cuando: necesitas funcionalidades estándar sin escribir código.

Herramientas de cliente (Client Tools)

El agente señala una intención, tú la ejecutas

El agente detecta que necesita hacer algo en tu aplicación (abrir un modal, actualizar un campo, mostrar un componente), emite un evento con los datos necesarios, y tu código lo ejecuta localmente. Daguito no corre la lógica — solo coordina la señal.

Agente decide
Detecta que el usuario quiere editar la sección "diagnóstico" de una nota clínica
→
Emite evento
editar_seccion { seccion: "diagnóstico", contenido: "..." }
→
Tu app escucha
Tu código recibe el evento y actualiza la UI directamente
Úsalo cuando: la herramienta actualiza tu interfaz o ejecuta lógica en el cliente, no en el servidor.

Herramientas en dos direcciones

Lo que hace a Daguito diferente es que las herramientas no son solo de una vía. Daguito puede usar tus herramientas, y tú puedes usar las herramientas que Daguito expone.

Daguito usa tus herramientas

Registras tus propias funciones y el agente las invoca cuando las necesita. Tu código corre en tu servidor o en el cliente — Daguito solo pasa los argumentos y recibe el resultado.

Ejemplo 1 Tu tienda tiene una función buscar_inventario(query). La registras en el SDK y el agente la llama cuando el usuario pregunta por productos.
Ejemplo 2 Tu app médica tiene obtener_historial(paciente_id). El agente la usa para responder preguntas clínicas con datos reales del paciente.
Tu función ←→ Agente Daguito ←→ Usuario

Sistemas externos usan Daguito

Daguito expone herramientas a través del protocolo MCP (Model Context Protocol). Desde Claude u otros sistemas, puedes operar Daguito como si fuera una herramienta más de tu entorno.

Ejemplo 1 Desde Claude Desktop, le pides: "Crea un flujo que responda preguntas sobre mi catálogo". Claude usa la herramienta crear_flujo de Daguito y lo construye.
Ejemplo 2 Un sistema externo usa buscar_conocimiento(query) para consultar la base de conocimiento de tu organización directamente.
listar_flujos Ver todos los flujos
crear_flujo Construir un flujo nuevo
buscar_conocimiento Buscar en la base de conocimiento
ver_analíticas Consultar métricas de uso

Lo que ves mientras la herramienta trabaja

Algunas herramientas tardan unos segundos en ejecutarse. Para que el usuario no vea solo un cursor esperando, Daguito emite eventos de progreso en tiempo real:

Ejemplo: búsqueda web
Buscando en fuentes relevantes…
0.3s
Leyendo 5 resultados…
1.1s
Extrayendo fragmentos relevantes…
…
Generando respuesta
Tip

Si estás construyendo un widget o una app con el SDK, puedes escuchar estos eventos de progreso y mostrarlos en tu interfaz. El usuario ve exactamente qué está haciendo el agente, no solo un spinner.

¿Qué sigue?