​

Registros

Los registros de flujos de trabajo te ayudan a inspeccionar qué pasó después de que comienza una ejecución, ya sea que esa ejecución provenga del dashboard, la API, una programación, un disparador de webhook o un agente. Usa esta página para revisar la actividad reciente de los flujos de trabajo, filtrar las ejecuciones que te interesan y abrir una hoja de detalle de la ejecución con datos de traza y salida.

​

Resumen

La interfaz de registros de flujos de trabajo es una vista basada en tabla bajo Logs en la sección de flujos de trabajo. Admite filtrado por origen desde la barra lateral, filtrado por rango de fechas desde el encabezado e inspección a nivel de fila a través de una hoja detallada de ejecución. Cuando abres una ejecución completada, la hoja de detalle combina datos resumen, una cascada de trazas, detalles de la solicitud, salida, entradas de inicio e información de entrega por callback cuando está presente.

​

¿Cómo abro los registros de flujos de trabajo?

Abre Workflows en la barra lateral. Haz clic en Logs en el menú de la sección de flujos de trabajo. Usa el grupo Source en la barra lateral cuando quieras alternar entre All Sources, Dashboard, API, Scheduled, Webhook y Agent. Usa Dashboard cuando solo quieras las ejecuciones iniciadas desde el editor o la interfaz del dashboard. Usa API cuando solo quieras las ejecuciones iniciadas desde un deployment de flujo de trabajo a través de la API pública. Usa Scheduled, Webhook y Agent para las ejecuciones lanzadas por esos orígenes.

​

¿Qué puedo filtrar en los registros de flujos de trabajo?

Usa el control de rango de fechas en el encabezado para elegir un rango personalizado o un preajuste disponible. Los preajustes incluyen rangos como los últimos uno, siete, 30 o 90 días, pero los rangos más largos pueden requerir un plan con más historial de registros. Usa API keys para acotar la tabla a las ejecuciones iniciadas con una o más claves de API del workspace. Usa Workflow cuando quieras aislar las ejecuciones de un solo flujo de trabajo. Usa Delivery para alternar entre ejecuciones All, Callback y Direct. La entrega es independiente del origen: una ejecución de invocación por API puede usar entrega por callback, mientras que las ejecuciones disparadas por webhook siempre usan entrega por callback. Usa User metadata para filtrar por una propiedad de metadata rastreada. Elige una clave de propiedad para encontrar ejecuciones donde esa clave exista, o agrega un valor exacto para hacer coincidir valores escalares como cus_123, enterprise, true o 12. Haz clic en Clear filters para restablecer el estado de filtro activo.

​

¿Qué se rastrea en la tabla de registros de flujos de trabajo?

La tabla principal de registros muestra campos resumen para cada ejecución, incluidos:

• Completed At
• Name
• Tools
• Status
• Total Cost
• Duration
• API Key
• Collaborator

Para las ejecuciones en vivo, la columna Name también puede mostrar la insignia de la variante del deployment, incluido el nombre de la variante y el número de versión. La columna Tools refleja los proveedores o las fuentes de pasos que contribuyeron con completions de trabajo real a la ejecución. Los registros de orquestación del flujo de trabajo, como la agregación de pasos en paralelo, se excluyen de este resumen aunque aún puedan aparecer en la línea de tiempo de la traza.

​

¿Cómo inspecciono una ejecución de flujo de trabajo?

Haz clic en una fila completada en la tabla de registros. Fetch Hive abre una hoja de detalle de la ejecución a la derecha. El encabezado muestra el ID de la ejecución, el estado, la hora de inicio, la insignia de la variante del deployment cuando está presente, una insignia de origen como Scheduled o Webhook, y una insignia Callback cuando la ejecución usa entrega por callback. La franja resumen debajo muestra el flujo de trabajo, la duración, el costo, las herramientas y el propietario para esa ejecución. Si el flujo de trabajo aún existe y no está archivado, el nombre del flujo de trabajo en la franja resumen enlaza de vuelta al editor del flujo de trabajo.

​

Trazas

Usa la cascada de trazas en el lado izquierdo de la hoja de detalle de la ejecución para comprender cómo progresó la ejecución a lo largo del tiempo. Cada span te ayuda a inspeccionar una parte específica de la ejecución, como la solicitud entrante, el inicio del flujo de trabajo, la actividad de la herramienta, la actividad del LLM y la finalización del flujo de trabajo. Cuando seleccionas un span, el lado derecho se actualiza para mostrar los detalles del span y cualquier dato de completion enlazado. Dependiendo del span seleccionado, esto puede incluir:

• datos de respuesta del modelo
• detalles de la solicitud
• entradas de inicio
• contenido de salida
• metadata de usuario
• metadata
• desgloses de tokens y costos

Para los completions de prompt de Claude AI, los detalles de la solicitud pueden incluir Prompt Cache, que es el TTL de caché de prompts de Anthropic configurado y asignado a esa ejecución del paso. Las lecturas y escrituras reales del caché aún se muestran a través de los campos de uso de tokens cacheados. Esta es la vista principal de depuración para las ejecuciones de flujos de trabajo. Comienza aquí cuando necesites entender qué parte del flujo de trabajo fue lenta, falló o produjo un resultado incorrecto.

​

¿Cómo inspecciono la salida, la entrega por callback y los registros de webhook?

Abre una ejecución desde la tabla de registros. Selecciona los spans de solicitud o completion en el panel de trazas para alternar los detalles del lado derecho. Usa la sección de salida cuando quieras inspeccionar el resultado final del flujo de trabajo desde el span workflow.complete. Las tarjetas de registro copiables incluyen controles para copiar el contenido mostrado o minimizar la tarjeta mientras comparas otros detalles de la ejecución. Si la ejecución usa entrega por callback, los detalles a nivel de solicitud también pueden mostrar Callback delivery con la URL de callback utilizada para esa ejecución. Si hay registros de entrega de webhook presentes, la misma hoja puede mostrar Webhook Logs con la URL de callback, conteo de reintentos, código de respuesta, payload, cuerpo de la respuesta y una acción Retry para los intentos de entrega por callback fallidos. Los registros de webhook son intentos de entrega, no el origen de la ejecución.

​

Notas

• La tabla de registros se actualiza en respuesta a los cambios de estado de ejecución del flujo de trabajo, por lo que las ejecuciones recientes pueden refrescarse mientras ves la página.
• Fetch Hive rastrea los nombres de las propiedades de metadata de usuario a lo largo del tiempo desde las invocaciones de flujos de trabajo para que el filtro de metadata pueda sugerir claves que tu workspace haya enviado realmente. Consulta Metadata de invoke para ver ejemplos de solicitud.
• Las filas en ejecución no son el punto de entrada principal para la inspección profunda. Abre una ejecución completada cuando quieras la hoja de detalle completa y la vista de traza.
• Los detalles de entrega por callback solo son visibles cuando la ejecución seleccionada realmente usó entrega por callback.
• El origen te dice qué inició la ejecución. La entrega te dice si la ejecución esperó una respuesta directa o devolvió respuesta inmediatamente para entrega por callback.

Consulta también: Publicación y versionado, Entrega por callback y disparadores de webhook y Ejecutar con API