Son servicios de terceros conectados por OAuth cuyas acciones el Nodo Cortex puede ejecutar directamente, sin necesidad de gestionar claves de API.
🎯 ¿Para qué sirve?
Esta funcionalidad le permite al nodo hacer cosas reales fuera de la conversación. Por ejemplo:
Crear un evento en un calendario.
Abrir un ticket de soporte en tu sistema.
Notificar a un canal de tu equipo interno.
Cargar o actualizar un contacto en tu CRM.
💡 La gran ventaja: A diferencia de un HTTP Request tradicional, la autenticación aquí la resuelve la plataforma mediante OAuth. No tienes que programar integraciones desde cero, gestionar tokens de seguridad ni preocuparte por sus renovaciones.
📍 ¿Dónde se configura?
Para acceder a las herramientas, la ruta es:
Canvas → Seleccionar Nodo Cortex → Panel derecho → Pestaña (Tab) Herramientas.
🔗 Cómo conectar una aplicación (Paso a paso)
El proceso de conexión es visual y consta de tres pasos:
1. Seleccionar la aplicación
Al hacer clic en agregar, se abre un modal de exploración con más de cien toolkits (paquetes de herramientas) disponibles. Puedes usar el buscador para encontrar rápidamente la aplicación que necesitas.
2. Conectar y verificar
El sistema verificará automáticamente si la aplicación ya está conectada a tu cuenta.
Si no lo está, se iniciará el flujo de OAuth en una pestaña nueva de tu navegador para que inicies sesión y des los permisos.
Al volver a Cortex, simplemente haz clic en el botón Verificar de nuevo para comprobar el estado de la conexión.
3. Seleccionar las acciones
Una vez conectada la app, podrás explorar todas las acciones disponibles (ej. "Enviar correo", "Crear contacto"). Puedes buscar por nombre o descripción, y seleccionar varias a la vez antes de agregarlas al nodo.
Gestión de Herramientas adjuntas
Cada herramienta que adjuntes se mostrará con su nombre, descripción, aplicación de origen e identificador de la acción. Si ya no las necesitas, se pueden eliminar individualmente del nodo.
✍️ Referenciar herramientas en el prompt
Al escribir @ dentro del campo de instrucciones (prompt) de tu nodo, se desplegará la lista de herramientas que acabas de conectar.
El menú es filtrable. Al seleccionar una, se insertará una referencia formateada, por ejemplo: @[Send Message - Slack].
En tiempo de ejecución (runtime), esta referencia se resuelve automáticamente como una instrucción vinculada a esa herramienta.
🧠 Mejores prácticas: Escribir buenas descripciones
La descripción de la herramienta es el texto que lee el modelo de lenguaje (LLM) para decidir cuándo debe usarla. Es el factor más crítico para que el nodo la invoque en el momento correcto.
Una descripción completa y efectiva debe cubrir tres cosas:
Qué hace la herramienta: Explicado en una o dos oraciones.
Cuándo usarla: Las situaciones exactas del cliente que deben disparar la acción.
Cuándo NO usarla: Reglas de exclusión (vital si hay riesgo de confusión con otra herramienta similar).
✅ Conviene (Completo y claro) | ❌ Conviene evitar (Vago y ambiguo) |
"Consulta el stock de un vehículo en el CRM. Usar cuando el cliente pregunta si hay disponibilidad de un modelo puntual. No usar para preguntas generales sobre el catálogo." | "Consulta el sistema." |
⚙️ El esquema técnico va en el prompt
Aunque la descripción de la herramienta le dice al modelo qué hace, conviene detallar en el prompt del nodo el esquema técnico: qué entrada exacta espera la herramienta y qué devuelve, incluyendo ejemplos concretos de cada parámetro.
Los modelos interpretan mejor los ejemplos que las abstracciones. Si documentas un parámetro así:
attendees (array de strings): correos de los asistentes. Ej: ["[email protected]"], evitas el error clásico de que la IA pase un objeto complejo donde se esperaba una simple cadena de texto.Manejo de errores: También conviene enumerar en el prompt los errores esperados y qué debe hacer el nodo ante cada uno. (Por ejemplo: "Si falla la creación del evento en el calendario, NO comuniques el error técnico al cliente, deja una nota interna y deriva la conversación a un asesor").
💡 La división de tareas:
La descripción de la herramienta define qué hace y cuándo se usa.
El prompt del nodo define en qué momento exacto del flujo conversacional se debe invocar (usando
@[nombre]), cómo pasarle los datos y cómo reaccionar a sus respuestas.
¡Dale manos a tu Inteligencia Artificial! 🚀
Al integrar aplicaciones externas con OAuth y configurar descripciones precisas, transformas a tu agente de un simple asistente conversacional a un operador resolutivo capaz de ejecutar procesos reales de principio a fin, automatizando tu negocio como nunca antes. ✅