Ejecuta herramientas desde un workflow

Requisitos

La herramienta debe estar activa y autorizada para al menos uno de los agentes asociados al workflow. Si se retira la autorización o se elimina la herramienta, valida de nuevo el proceso antes de publicarlo.

Configura el nodo

Añade un nodo Herramienta, selecciona la acción autorizada y define sus entradas en JSON. Utiliza únicamente los campos que el contrato de la herramienta espera.

No escribas contraseñas, tokens o cabeceras secretas dentro del workflow. Las credenciales deben permanecer en la configuración protegida de la herramienta.

Trata el resultado

Conecta el nodo con los pasos que interpretarán la salida. Prevé una ruta de error cuando la herramienta dependa de una API externa, datos variables o límites de uso.

Una respuesta HTTP correcta no garantiza que el resultado comercial sea válido. Comprueba los campos relevantes antes de confirmar la operación al usuario.

Prueba sin producir cambios

Comienza con una simulación y herramientas simuladas. Verifica los argumentos y el recorrido sin crear registros, enviar mensajes o modificar sistemas externos.

Cuando pruebes en modo real:

1. Utiliza datos controlados.
2. Evita duplicar acciones no idempotentes.
3. Comprueba el sistema de destino.
4. Revisa la traza y la salida del nodo.

Repetir una ejecución puede repetir también su efecto externo. No uses el botón de prueba como mecanismo de reintento sin conocer el contrato de la herramienta.

Aplica mínimo privilegio

Autoriza solo las herramientas necesarias para los agentes asociados. Si distintos agentes necesitan permisos diferentes, revisa qué asignación ejecutará el workflow y evita ampliar accesos únicamente para superar una validación.