​

Herramientas de flujo de trabajo

Las herramientas de flujo de trabajo permiten que un agente llame a una variante de endpoint de un flujo de trabajo implementado durante una ejecución de agente.

​

Descripción general

Agrega una herramienta de flujo de trabajo cuando un agente deba delegar parte de una tarea a un flujo de trabajo existente. Fetch Hive inicia el flujo de trabajo como una ejecución de flujo de trabajo normal, por lo que obtiene su propio ID de solicitud, ID de ejecución del flujo de trabajo, registros del flujo de trabajo y traza de pasos. El agente principal también registra la llamada como un span de herramienta de agente, con la traza del flujo de trabajo anidada bajo esa llamada a herramienta en la traza de la ejecución del agente. Las herramientas de flujo de trabajo usan la última versión activa de la variante del endpoint del flujo de trabajo seleccionado. El esquema de entrada de la herramienta se genera a partir de las declaraciones de entrada del paso inicial del flujo de trabajo, por lo que el modelo puede pasar las mismas entradas de nivel superior que el flujo de trabajo espera de una llamada a la API.

​

¿Cómo agrego una herramienta de flujo de trabajo?

1. Abre el agente principal en el editor de agentes.
2. Haz clic en el botón de agregar herramienta en el encabezado del editor.
3. Elige un endpoint y variante de flujo de trabajo implementado en Workflow Tools.
4. Ingresa el nombre y la descripción de la herramienta que verá el modelo.
5. Guarda la herramienta.

El endpoint y la variante del flujo de trabajo deben pertenecer al mismo espacio de trabajo que el agente. Los nombres de herramienta deben ser únicos entre las herramientas MCP del agente, las herramientas de flujo de trabajo y los subagentes.

​

¿Qué se registra?

Cada llamada a una herramienta de flujo de trabajo crea dos registros vinculados:

• Una ejecución de flujo de trabajo normal con su propio ID de solicitud e ID de ejecución del flujo de trabajo.
• Una llamada a herramienta del agente principal con metadatos que identifican la herramienta de flujo de trabajo y la ejecución hija del flujo de trabajo.

Puedes inspeccionar el flujo de trabajo hijo desde los registros del flujo de trabajo exactamente como cualquier otra invocación de flujo de trabajo. En la traza del agente, el span de la herramienta principal se llama agent.tool.workflow, y los spans del flujo de trabajo hijo se adjuntan debajo de ese span.

​

¿Cuándo debo usar herramientas de flujo de trabajo?

Usa herramientas de flujo de trabajo cuando el trabajo delegado ya esté modelado como un flujo de trabajo, especialmente si incluye múltiples pasos deterministas, ramificaciones, integraciones o registro reutilizable específico del flujo de trabajo. Usa subagentes cuando el trabajo delegado deba ser manejado por otro agente con sus propias instrucciones y conjunto de herramientas.