Custom Tools: Genera Cualquier Funcionalidad con Prompts de IA
Las 74+ herramientas integradas en Mind2Flow cubren el 80% de casos de uso. Pero, ¿qué pasa con ese 20% específico de tu negocio? Cálculos financieros propios, lógica de validación única, integración con tu API interna... ahí es donde los Custom Tools entran. Y lo mejor: los creas con prompts, no con código.
¿Qué es un Custom Tool?
Un Custom Tool es una función que le das a tu agente para resolver tareas específicas que las herramientas integradas no cubren. Ejemplos:
- Cálculo de comisiones: Lógica de negocio compleja con múltiples variables
- Validación de datos: Verificar que un input cumpla reglas específicas
- Integración con API propia: Consultar/actualizar tu sistema interno
- Transformación de datos: Convertir formato A a formato B con lógica custom
- Decisiones condicionales: Árbol de decisión complejo
Cómo Crear Custom Tools en 3 Minutos
Paso 1: Describir la Funcionalidad
- Dashboard → Tools → Create Custom Tool
- Name: "Calcular ROI de Campaña"
- Prompt descriptivo:Crea una función que calcule el ROI de una campaña de marketing.
Inputs:
- inversion: float (monto invertido en USD)
- ingresos: float (ingresos generados en USD)
- duracion: int (días de la campaña)
Output:
- roi_percentage: float (ROI en porcentaje)
- roi_diario: float (ROI promedio por día)
- clasificacion: string ("Excelente" si >200%, "Bueno" si 100-200%, "Regular" si 50-100%, "Malo" si <50%)
Fórmula: ROI = ((ingresos - inversion) / inversion) * 100
Paso 2: Generar Código Automáticamente
- Click "Generate Tool"
- Mind2Flow usa GPT-4 para generar código Python
- Código aparece en editor (puedes revisarlo/ajustarlo)
Paso 3: Probar en Sandbox
- Test con datos reales:inversion: 5000
ingresos: 15000
duracion: 30 - Output esperado:{
"roi_percentage": 200,
"roi_diario": 6.67,
"clasificacion": "Excelente"
} - Si funciona → Save Tool
Paso 4: Asignar a Agentes
- Agents → Select Agent → Tools → Add "Calcular ROI de Campaña"
- Agente ahora puede usar esta función cuando necesite calcular ROI
Casos de Uso Reales
1. Validador de RFC Mexicano
"Crea una función que valide si un RFC mexicano es válido. Debe verificar:
- Longitud (13 caracteres para personas físicas, 12 para morales)
- Formato correcto (letras + números + homoclave)
- Dígito verificador válido según algoritmo oficial
Retorna true/false y mensaje de error si inválido"
Uso: Agente valida RFC antes de crear factura automáticamente
2. Integración con ERP Interno
"Crea una función que consulte el inventario en nuestro ERP.
API endpoint: https://erp.miempresa.com/api/inventory
Headers: Authorization: Bearer [TOKEN]
Input: sku (string)
Output: stock_disponible (int), precio_unitario (float), ubicacion_bodega (string)
Si el producto no existe, retorna stock_disponible: 0"
Uso: Chatbot consulta stock en tiempo real antes de confirmar pedido
3. Cálculo de Comisiones con Escalas
"Crea una función para calcular comisiones de vendedores con estas reglas:
- Ventas $0-10,000: 5% comisión
- Ventas $10,001-50,000: 7% comisión
- Ventas $50,001-100,000: 10% comisión
- Ventas >$100,000: 12% comisión + bono de $1,000
Input: monto_ventas (float)
Output: comision (float), porcentaje_aplicado (float), incluye_bono (bool)"
Uso: Agente calcula comisiones automáticamente cuando ventas cierra deal
4. Scraping con Lógica Custom
"Crea una función que haga scraping del sitio de MercadoLibre México.
Input: keyword (string)
Extrae de los primeros 10 resultados:
- título del producto
- precio
- rating (estrellas)
- número de reviews
Filtra solo productos con rating >= 4 estrellas y >50 reviews
Retorna lista ordenada por precio ascendente"
Uso: Agente monitorea precios de competencia semanalmente
Mejores Prácticas para Prompts
1. Sé Específico con Inputs y Outputs
- ❌ Malo: "Inputs: datos del cliente"
- ✅ Bueno: "Inputs: nombre (string), email (string), telefono (string con formato +52...)"
2. Incluye Validaciones
- Qué pasa si input es inválido (email sin @, número negativo)
- Cómo manejar errores (retornar null, lanzar excepción, mensaje descriptivo)
3. Define Comportamiento Edge Cases
- División por cero
- Listas vacías
- APIs que no responden
- Datos faltantes
4. Incluye Ejemplos
Input: { email: 'usuario@ejemplo.com', nombre: 'Juan Pérez' }
Output: { valido: true, mensaje: 'Email válido' }
Librerías Disponibles
El sandbox de Mind2Flow incluye 63 paquetes Python pre-instalados:
- Web: requests, beautifulsoup4, selenium, playwright
- Data: pandas, numpy, scipy, openpyxl
- APIs: openai, anthropic, google-cloud-*
- Databases: sqlalchemy, pymongo, supabase
- Messaging: twilio, slack-sdk, discord.py
- Payments: stripe
Lista completa: usa tool 'get_available_packages' en tu agente
Debugging y Logs
Cuando un Custom Tool falla:
- Execution Logs: Ve qué inputs recibió, qué salió mal
- Error messages: Python tracebacks completos para debugging
- Test con diferentes inputs: Sandbox interactivo para probar cambios
- Version history: Guarda versiones anteriores, rollback si es necesario
Límites y Consideraciones
- Timeout: 30 segundos máximo de ejecución (configurable hasta 300s)
- Sin estado: No puedes guardar variables entre ejecuciones (usa database para persistencia)
- No acceso a filesystem: Trabaja en memoria, usa APIs para storage externo
- Rate limiting: APIs externas pueden tener límites, maneja con retry logic
Ejemplo Avanzado: Workflow Multi-Step
Objetivo: Generar reporte de ventas automático cada semana
Custom Tool 1: "Fetch Sales Data"
SELECT * FROM ventas WHERE fecha BETWEEN [fecha_inicio] AND [fecha_fin]
Agrupa por vendedor, calcula totales, promedios
Custom Tool 2: "Generate Chart"
Retorna imagen en base64
Custom Tool 3: "Format Report"
Incluye datos, gráfico, insights clave
Estilo profesional con CSS
Custom Tool 4: "Send Report"
Recipients: equipo de ventas
Schedule: Lunes 9am
Seguridad
Custom Tools corren en sandbox aislado:
- Sin acceso a otros usuarios: Datos aislados por organización
- API keys encriptadas: Almacenadas de forma segura
- Audit trail: Cada ejecución loggeada con timestamp y user
- Permisos granulares: Define qué agentes pueden usar qué tools
Conclusión
Los Custom Tools son la clave para llevar tus agentes de "demos impresionantes" a "soluciones productivas reales". Mientras las herramientas integradas cubren lo genérico, los Custom Tools implementan tu lógica de negocio única. Y lo mejor: no necesitas ser programador. Si puedes describir en español qué necesitas, Mind2Flow puede generarlo. Esto elimina el 90% de la necesidad de desarrollo custom, manteniendo la flexibilidad para ese 10% crítico.