Características
Ejecución síncrona
Las Tools se ejecutan y devuelven un resultado al instante, sin esperar respuestas del usuario.Reutilizables entre flujos y proyectos
Una misma Tool puede usarse en múltiples Skills y en cualquier proyecto dentro de la compañía.Publicación y uso interno
Pueden publicarse en el Marketplace (privadas por defecto) y consumirse desde cualquier proyecto activo.Versionamiento controlado
Cada cambio genera una nueva versión (v1, v2, v3), y puedes decidir qué versión usar en cada Skill.Consumo externo opcional
Incluyen documentación API para uso externo y soporte para integración con MCP, cuando necesitas exponerlas fuera de Jelou.Tools nativas listas para usar
Además de crear tus propias Tools, Jelou ofrece Tools predefinidas que puedes usar directamente desde el nodo AI Agent.Casos de uso
Las Tools son ideales para:Integrar APIs y servicios externos
Conectar con sistemas de terceros, bases de datos o servicios web. Ejemplo: Crear una Tool que consulta la API de Stripe para validar números de tarjeta sin guardarlos en tu Base de Datos.Realizar cálculos o transformaciones
Procesar datos, validar información o ejecutar operaciones matemáticas. Ejemplo: Tool que calcula la elegibilidad de crédito según score + ingresos del cliente.Consultar y actualizar datos
Acceder a información almacenada o modificar registros.Ejecutar acciones específicas
Enviar notificaciones, generar reportes o realizar operaciones del sistema. Ejemplo: Enviar una notificación cuando se completa un proceso. Una Tool se ejecuta al final de un flujo y envía una notificación por correo o WhatsApp al cliente confirmando que su solicitud fue recibida o aprobada (por ejemplo, una solicitud de crédito o una orden de compra).Tool vs Tool HTTPS
En Jelou existen dos tipos de Tools. Ambas ejecutan funciones automáticas, pero se usan en contextos distintos. La diferencia principal está en dónde se ejecutan y quién las consume.| Aspecto | Tool | Tool HTTPS |
|---|---|---|
| Dónde se usa | Dentro de Jelou, en los flujos (Skills) | Desde cualquier servicio externo vía HTTP |
| Cómo se consume | Directamente dentro de una Skill | Mediante llamadas API |
| Seguridad | Manejo interno de la plataforma | Requiere token de acceso |
| Velocidad | Más rápido (ejecución interna) | Puede tener latencia por la capa HTTP |
| Casos típicos | Datos internos, integraciones dentro de Jelou | Exponer funciones a otros sistemas o usar MCP |
Regla práctica
✅ Usa Tool si la función vive y se ejecuta dentro de un flujo en Jelou 🌐 Usa Tool HTTPS si necesitas que algo externo la consumaBuenas prácticas
- Nombres descriptivos: Usa nombres claros que indiquen qué hace el Tool
- Descripciones: Agrega descripciones en inputs y outputs para facilitar el uso
- Versionamiento consciente: Publica nuevas versiones solo cuando hagas cambios significativos
- Variables secretas: Siempre marca como “secreto” cualquier información sensible (API keys, tokens, credenciales)
- Manejo de errores: Incluye validaciones y manejo de errores en tu Tool
- Pruebas exhaustivas: Prueba tu Tool con diferentes escenarios antes de publicarlo
- Reutilización: Diseña Tools genéricas que puedan usarse en múltiples contextos
Errores comunes
- No configurar variables de entorno: Olvidar crear o configurar variables necesarias para autenticación
- Usar valores hardcodeados: Incluir API keys o credenciales directamente en el código en lugar de usar variables secretas
- No validar inputs: No verificar que los inputs tengan el formato o tipo correcto
- Olvidar seleccionar la versión: No elegir explícitamente la versión del Tool al usarlo en una Skill
- No probar antes de publicar: Publicar un Tool sin verificar que funciona correctamente
- Inventar IDs: Usar IDs de equipos, operadores o recursos que no existen en la plataforma
- No documentar cambios: Publicar nuevas versiones sin documentar qué cambió y por qué
Checklist de validación
Antes de publicar un Tool, verifica:- El Tool tiene un nombre descriptivo y claro
- Todos los inputs están configurados con tipos y descripciones
- Los outputs están correctamente mapeados
- Las variables de entorno necesarias están creadas (y marcadas como secretas si aplica)
- El Tool ha sido probado con diferentes valores de entrada
- Se manejan correctamente los casos de error
- La documentación de inputs y outputs es clara
- No hay valores hardcodeados que deberían ser variables
- El Tool funciona correctamente cuando se consume desde una Skill
- Si es Tool HTTPS, la documentación API está disponible y es correcta
FAQ
¿Puedo usar un Tool en múltiples Skills?
¿Puedo usar un Tool en múltiples Skills?
Sí. Una vez publicado, un Tool puede usarse en cualquier Skill de cualquier proyecto dentro de tu compañía. Las Tools son reutilizables a lo largo de toda la compañía.Ejemplo: Si creas un Tool ‘calcular_impuesto’, puedes usarlo en 3 Skills diferentes sin duplicar código.
¿Qué pasa si actualizo un Tool después de publicarlo?
¿Qué pasa si actualizo un Tool después de publicarlo?
Cuando publicas un Tool actualizado, se genera una nueva versión (v1, v2, v3, etc.). Las Skills que ya usan versiones anteriores seguirán funcionando con esa versión. Puedes elegir qué versión usar en cada Skill.
¿Cómo consumo un Tool desde un servicio externo?
¿Cómo consumo un Tool desde un servicio externo?
Si tu Tool está publicado como Tool HTTPS, puedes acceder a la documentación API desde la sección del Tool. Allí encontrarás la URL, el token de seguridad y ejemplos de cómo consumirlo mediante HTTP. También puedes usar la integración MCP para que agentes de IA externos descubran y usen tu Tool automáticamente.
¿Las variables secretas son seguras?
¿Las variables secretas son seguras?
Sí. Las variables marcadas como “secreto” están encriptadas y no son visibles para otros usuarios. Incluso cuando consumes un Tool HTTPS externamente, las variables secretas permanecen protegidas.
¿Qué nodos puedo usar en un Tool?
¿Qué nodos puedo usar en un Tool?
Los nodos soportados actualmente incluyen API, Código y Datum, entre otros. Consulta la sección de nodos en la documentación para ver la lista completa y sus características específicas.
¿Puedo ver el historial de versiones de un Tool?
¿Puedo ver el historial de versiones de un Tool?
Sí. En la documentación API del Tool, puedes ver todas las versiones publicadas y el historial de cambios. Esto te ayuda a entender qué cambió en cada versión y por qué.
¿Qué es MCP y cómo se relaciona con las Tools?
¿Qué es MCP y cómo se relaciona con las Tools?
MCP (Model Context Protocol) es un protocolo para agentes de IA externos (no Jelou) que quieran descubrir y usar tus Tools.Al habilitar MCP, se genera una URL única que permite a estos agentes acceder a tus Tools publicadas y utilizarlas de forma autónoma.