Descripción general

La funcionalidad Herramientas Tracing en la Management Console (MC) proporciona un sistema de seguimiento para errores e interacciones que ocurren durante la ejecución de AI Agents que utilizan Connectores Externos y SAP BTP Connectors. Esta funcionalidad mejora la visibilidad de errores y permite un monitoreo detallado de las respuestas y ejecuciones de los AI Agents, permitiéndole consultar y filtrar la información de trazas de manera eficiente directamente desde la interfaz de la MC.

Escenarios de uso

Registro en tiempo real de advertencias y errores: Permite a los administradores monitorear el estado de ejecución de los Connectores.

Monitoreo de respuestas de tareas de AI: Captura y registra detalles de las respuestas generadas por Connectores utilizados por los AI Agents.

Registro centralizado: Las trazas se agrupan y pueden filtrarse en la MC bajo la categoría Herramientas.

Configuración

Para habilitar el tracing, configúrelo desde la MC siguiendo estos pasos:

1.Navegue a: Tracking > Configuration.

Tools_Tracing_00

2.Seleccione el nivel de registro

oError: Registra únicamente errores del sistema relacionados con la ejecución de los Connectores.

oWarning: Registra solamente las advertencias generadas durante la ejecución de los Connectores.

oInformation: Captura las respuestas de los Connectores además de errores y advertencias.

Configuración específica

•Si solo se habilita Error, únicamente se registrarán errores del sistema.

•Si se habilita Warning, también se incluirán las advertencias de los Connectores.

•Si se habilita Information, también se registrarán las respuestas de los Connectores.

•Si el nivel de registro está configurado únicamente en Error, las respuestas de los Connectores no serán guardadas.

Esta configuración permite ajustar el nivel de detalle del tracing según las necesidades del proyecto.

Tags_Tracing00

Categorías de Logs

Existen dos categorías principales de logs para esta traza, cada una capturando distintas etapas de ejecución y las Herramientas utilizadas.

1. Ejecución de Conector Externo

•External Connector Request: Captura los detalles de la solicitud enviada desde Bizagi al servicio externo.

•External Connector Response: Registra la respuesta devuelta por el servicio externo, incluyendo estado y datos recibidos.

Tools_Tracing_01

2. Ejecución de SAP BTP Connector

•SAP BTP Request: Registra la información de la solicitud enviada desde Bizagi al servicio SAP BTP.

•SAP BTP Response: Captura la respuesta recibida desde SAP BTP, incluyendo resultados de la ejecución y posibles errores.

Tools_Tracing_02

Trazas desde Bizagi Studio

El prefijo Studio_ identifica ejecuciones que se originan en Studio.

Ejemplo:

Studio_SAP Cloud_SAP BT Connector Action_AI_OUT_20250910.json

Trazas desde el Portal de Trabajo

Un prefijo numérico identifica el número de caso en el que se está ejecutando el agente. Si no aparece, significa que el agente se está ejecutando fuera del contexto de un caso.

Ejemplos de mapeo:

SAP-AI_03

Entradas

901_SAP_CP_A_WorkCenters_IN0_20250912.json

901_SAP_CP_A_WorkCenters_IN1_20250912.json

Salidas

901_SAP_CP_A_WorkCenters_OU0_20250912.json

901_SAP_CP_A_WorkCenters_OU1_20250912.json

Tenga en cuenta que, para resolver cualquiera de estos errores, es necesario esperar. Si el problema persiste, envíe un ticket.