Inspección de flujos de trabajo agenticos
El inspector de flujo proporciona una vista consolidada del historial de ejecución del flujo de trabajo del agente y le ayuda a inspeccionar cómo se ejecutó un flujo de trabajo de principio a fin. Cada vez que se ejecuta un flujo de trabajo, se recopilan automáticamente detalles como el estado, el tiempo, el entorno, el iniciador y los mensajes de diagnóstico, y se muestran en un formato estructurado.
Puedes abrir el inspector de flujos desde el generador de flujos, la lista de herramientas o desde el conjunto de herramientas de un agente.
Inspector de flujo en el contexto de los espacios de trabajo en IBM Cloud
Solo en el entorno de IBM Cloud, si un flujo de trabajo está asociado a un espacio de trabajo, los administradores y los creadores que tengan acceso a dicho espacio de trabajo podrán ver las ejecuciones del flujo de trabajo en el inspector de flujos.
Para obtener más información sobre los espacios de trabajo, consulta la sección «Descripción general de los espacios de trabajo ».
Inspector de flujo abierto desde el generador de flujos
Al abrir el inspector de flujos desde el generador de flujos, se muestran simultáneamente el inspector de flujos y el generador de flujos. Esta vista permite examinar los datos de ejecución y revisar la estructura del flujo de trabajo sin tener que cambiar de vista.
Para abrir el inspector de flujos desde el generador de flujos:
En el generador de flujos, haz clic en el icono
.
El inspector de flujos se abre y muestra los detalles de la ejecución actual del flujo junto con el generador de flujos de trabajo. Se muestra el estado del flujo y un enlace «Ir al evento » que abre el evento correspondiente. El inspector de flujos también muestra detalles a nivel de instancia, como el ID de la instancia, el nombre del agente, el entorno, el iniciador, el modelo, el tiempo de ejecución y la fecha de inicio.
Los detalles de la ejecución del flujo incluyen dos secciones: «Eventos de flujo» y «Parámetros ». Para obtener más información, consulta «Eventos de Flow» y «Parámetros de Flow ».
El generador de flujos de trabajo muestra una versión histórica del flujo que se ajusta a la configuración utilizada durante la ejecución. Esta versión es de solo lectura. En la sección «Eventos de flujo» se enumeran todos los eventos de flujo. Al seleccionar un evento del flujo, se muestra información detallada sobre el paso seleccionado. Utiliza el botón Atrás para volver a la lista de eventos del flujo. Selecciona «Mostrar en el flujo» para abrir el nodo correspondiente en el generador de flujos de trabajo, lo que resalta el nodo y muestra sus detalles de configuración.
Para realizar cambios en el generador de flujos de trabajo, haz clic en «Volver a la última versión» para pasar a la versión editable más reciente del flujo de trabajo.
Abre el inspector de flujo desde la lista de herramientas o el conjunto de herramientas del agente
Puedes acceder al inspector de flujos desde la lista de herramientas o desde el conjunto de herramientas de un agente para una herramienta concreta. Al abrir el inspector de flujo desde estas ubicaciones, podrás ver las pestañas «Eventos de flujo» y «Parámetros de flujo ».
En el menú
, ve a «Compilar ».
En un entorno de « IBM Cloud », selecciona el espacio de trabajo asociado a tu flujo de trabajo en la lista de espacios de trabajo.
Selecciona todas las herramientas.
Selecciona el icono de opciones
de la herramienta que quieras revisar.Selecciona Abrir inspector de flujo.
Para abrir el inspector de flujos desde el conjunto de herramientas de un agente:
Abre el agente en el que está configurada la herramienta.
Selecciona la sección «Conjunto de herramientas ».
Selecciona el icono de opciones
de la herramienta que quieras revisar.Selecciona Abrir inspector de flujo.
El inspector de flujos se abre y muestra las instancias del flujo de trabajo seleccionado. Por defecto, muestra las instancias más recientes que has iniciado.
Ver detalles de la ejecución del flujo
Al seleccionar una ejecución del flujo de trabajo, se abre una vista detallada de esa instancia específica. Resume el iniciador, la información del agente, el entorno de ejecución, la duración de la ejecución y cualquier modelo utilizado durante la ejecución. Cada vista detallada incluye un enlace directo al generador de flujos de trabajo para que puedas acceder al nodo correspondiente.
El encabezado de detalles de ejecución del flujo incluye acciones que le ayudarán a actualizar, revisar, exportar o compartir información sobre la ejecución del flujo de trabajo. Estas acciones le ayudan a trabajar con la información de ejecución del flujo de trabajo de manera eficiente y admiten tanto escenarios de revisión colaborativa como técnica.
Las siguientes acciones están disponibles en el encabezado de detalles de ejecución del flujo:
Acción |
Descripción |
|---|---|
Compartir |
Copia un enlace a la ejecución del flujo de trabajo que puede compartir con los usuarios que tengan los permisos adecuados. La función permite la colaboración durante la revisión y validación del flujo de trabajo. |
Copiar carga JSON |
Copia la representación JSON completa de la ejecución del flujo de trabajo, incluyendo entradas, salidas, variables de flujo y metadatos. La carga útil JSON es útil para auditar, depurar, exportar datos de ejecución o incluir información de ejecución en casos de soporte técnico. |
Ver resumen de IA |
Abre un resumen generado por IA de la ejecución del flujo de trabajo. El resumen destaca los eventos clave, las acciones importantes que se llevaron a cabo durante la ejecución del flujo de trabajo y cualquier problema detectado. El resumen generado por IA ofrece una visión general del comportamiento del flujo sin necesidad de revisar cada paso. |
Gestión de los detalles de la ejecución del flujo
Los detalles de la ejecución del flujo incluyen dos secciones:
Eventos de flujo, que muestran la secuencia de acciones que se realizan durante la ejecución.
Parámetros de flujo, que muestran los datos utilizados por el flujo de trabajo.
Eventos de flujo
Los eventos del flujo muestran un resumen de cada acción que se ha producido durante la ejecución del flujo de trabajo. La lista de eventos muestra todos los eventos en orden cronológico, y puedes desplazarte por la lista para consultar eventos anteriores o posteriores. Cada evento muestra su tipo, la fecha y hora, y la duración de la ejecución. Cuando seleccionas un evento de la lista de eventos del flujo, la sección de detalles muestra la información del nodo seleccionado.
Los detalles del evento son los siguientes:
Nombre y tipo del nodo
Duración de tiempo de ejecución
Opción para abrir el nodo en el generador de flujos de trabajo con el fin de ver o actualizar su configuración
Estado de ejecución actual
Indicadores de nodos fallidos: cuando un flujo de trabajo contiene nodos fallidos, el nodo principal muestra una notificación de fallo con un enlace «Ir al evento» que permite desplazarse directamente al evento fallido.
Detalles del error: Los nodos con fallos muestran información detallada sobre el error.
Detalles de la ejecución del código: en el caso de los bloques lógicos y los nodos de código, el código ejecutado se muestra con números de línea.
Parámetros utilizados por el nodo, incluidas las entradas y las salidas.
Esta información te ayuda a seguir el flujo de ejecución, comprobar que el comportamiento sea el esperado, identificar los puntos en los que el flujo se detuvo o falló, y examinar eficazmente los eventos durante la resolución de problemas.
Parámetros de flujo
Muestra las entradas, las salidas y las variables de flujo proporcionadas al flujo de trabajo. Esta sección incluye un enlace «Abrir en el generador de flujos» en la parte superior para acceder rápidamente a la configuración del flujo de trabajo. La revisión de los parámetros del flujo permite confirmar que los datos se han procesado según lo previsto y verifica que los datos de entrada se hayan transferido correctamente al flujo de trabajo y que los resultados se hayan generado adecuadamente.
Para abrir los detalles de la ejecución del flujo:
En la lista de ejecuciones de flujos, seleccione Ver detalles para la ejecución de flujo que desea inspeccionar.
Desde la ventana de detalles de la ejecución del flujo:
Alterna entre los eventos de flujo y los parámetros de flujo para revisar la ejecución del flujo y los datos que se utilizan en el flujo de trabajo.
Seleccione Eventos de flujo para revisar la secuencia de acciones en la ejecución del flujo de trabajo.
Haga clic en Abrir en el generador de flujos para abrir el flujo de trabajo en una pestaña separada del navegador. El flujo de trabajo se abre con información detallada, incluyendo cómo está configurado cada nodo. Puede actualizar el flujo si es necesario.
Después de actualizar el flujo, vuelva a ejecutar el flujo de trabajo para generar una nueva instancia del flujo de trabajo con los cambios aplicados.