Custom Tools: Genera Cualquier Funcionalidad con Prompts de IA

Por Pablo Cruz Pineda

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

Prompt:
"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

Prompt:
"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

Prompt:
"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

Prompt:
"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

Ejemplo de uso:
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"

Consulta base de datos PostgreSQL
SELECT * FROM ventas WHERE fecha BETWEEN [fecha_inicio] AND [fecha_fin]
Agrupa por vendedor, calcula totales, promedios

Custom Tool 2: "Generate Chart"

Usa matplotlib para crear gráfico de barras
Retorna imagen en base64

Custom Tool 3: "Format Report"

Genera HTML con template
Incluye datos, gráfico, insights clave
Estilo profesional con CSS

Custom Tool 4: "Send Report"

Envía email con HTML adjunto
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.

¿Listo para Implementar IA en tu Negocio?

Agenda una consultoría gratuita y descubre cómo la IA puede transformar tu operación