Si su aplicación de IA ya está conectada a la observability de AgentLoop y reporta continuamente datos de rastreo (Traces), seleccione los servicios de la aplicación que desea auditar en Audit Management. La información de llamadas al modelo y de herramientas contenida en los Traces se convierte en eventos de auditoría, por lo que no es necesario configurar nuevamente la ingesta de registros de la misma aplicación. Una vez completada la conversión, consulte las Sessions y su contexto de comportamiento en Audit Facts. Además, si habilita la detección de riesgos de la aplicación, analice los eventos de riesgo correspondientes en Risk Audit.
Escenarios
La conexión de los datos de rastreo de aplicaciones a la auditoría es adecuada para los siguientes escenarios:
Ya puede consultar los datos de Trace de la aplicación en AI Agent Observability > Tracing y desea reutilizarlos para la auditoría.
Necesita auditar solo algunas aplicaciones. Defina el alcance de la conversión mediante
serviceName.Desea consultar hechos de auditoría como solicitudes de modelos, respuestas de modelos, llamadas a herramientas y resultados de herramientas.
Si una aplicación ya se conectó a la auditoría mediante AI Application Logs, se recomienda no convertir sus Traces. De lo contrario, el mismo comportamiento ingresará repetidamente a la auditoría.
Requisitos previos
Antes de comenzar, compruebe que se cumplen las siguientes condiciones:
AgentLoop está activado y se creó un AgentSpace.
Los Traces de la aplicación objetivo están conectados al AgentSpace actual y generaron datos durante las últimas 24 horas.
Los Traces contienen un valor válido de
serviceNamee incluyen, como mínimo, registros de llamadas de tipo LLM o Tool.
La integridad de los campos del Trace afecta el contenido de auditoría convertido. Por ejemplo, si el Trace de origen no proporciona información de usuario, sesión o tipo de agente, la información correspondiente en las páginas de auditoría también podría estar incompleta.
Procedimiento
Paso 1: Ir a Audit Management
Inicie sesión en la consola de AgentLoop y seleccione el AgentSpace objetivo.
En el panel de navegación izquierdo, elija Audit > Audit Management.
Si la página muestra Initialize Agent Security Audit Resources, haga clic en Initialize Resources. Espere a que la página indique que los recursos están listos y luego haga clic en Go to Agent Audit. Si accede directamente a la página Audit Management, omita este paso.
Si la inicialización falla, haga clic en Retry Initialization. Cuando la página indique que el proceso toma demasiado tiempo, inténtelo más tarde. Las tareas preparatorias ya completadas no se ejecutan de nuevo.
Paso 2: Seleccionar los servicios de la aplicación
En la sección Audit Data Source Ingestion, busque la fila cuyo grupo sea AI Application y cuya fuente de datos sea Application Tracing.
Haga clic en Manage Conversion Scope.
-
En el cuadro de diálogo Manage Application Tracing Conversion Scope, busque y seleccione los valores de
serviceNameque desea conectar a la auditoría.Campo
Descripción
serviceNameIdentificador del servicio en el Trace, utilizado para distinguir diferentes aplicaciones o servicios de IA.
Estadísticas de LLM
Cantidad de registros de llamadas de LLM detectados durante las últimas 24 horas.
Estadísticas de herramientas
Cantidad de registros de llamadas a herramientas detectados durante las últimas 24 horas.
Confirme la cantidad de servicios seleccionados que se muestra en la página y luego haga clic en Save Configuration.
Una vez guardada la configuración, el estado de Application Tracing se muestra como N services configured. El valor de serviceName distingue entre mayúsculas y minúsculas, así que selecciónelo según los valores reales de los Traces.
Comprobar el resultado de la ingesta
Después de completar la configuración, siga estos pasos para comprobar el resultado:
Genere una nueva solicitud que contenga una llamada al modelo o a una herramienta en la aplicación objetivo.
Transcurrido un momento, actualice la página Audit Management. En la sección Ingested Data Observation, consulte AI Application Tracing Data.
-
Confirme que la aplicación objetivo aparece en la lista y revise la siguiente información:
Tipo de agente.
Nombre de la aplicación del agente.
Hora de los últimos datos.
Tendencia del volumen de eventos durante las últimas 24 horas.
Haga clic en View a la derecha de la aplicación objetivo para ir a Audit Facts y consultar el contexto de las llamadas al modelo y a las herramientas de la Session correspondiente.
El indicador N services configured confirma que el alcance de la conversión se guardó correctamente. Para determinar si se generaron datos de auditoría, consulte los datos reales en la lista AI Application Tracing Data y en Audit Facts.
Si también necesita consultar los resultados de riesgo, vaya a Detection Configuration en Audit Management y habilite Application Risk Detection. Mientras esta función permanezca deshabilitada, podrá consultar los hechos de auditoría ya ingresados, pero no se generarán nuevos resultados de detección de riesgos.
Ajustar o detener la conversión
En la sección Audit Data Source Ingestion, busque Application Tracing y haga clic en Manage Conversion Scope.
Seleccione los servicios que desea agregar o desmarque aquellos que ya no requieren conversión.
Haga clic en Save Configuration.
Al desmarcar un servicio, el sistema deja de convertir los nuevos Traces que este genere posteriormente. Los datos de auditoría ya creados no se eliminan automáticamente y se conservan según las reglas de retención del AgentSpace actual.
Alcance de la conversión
El sistema convierte únicamente los registros de llamadas de tipo LLM y Tool asociados a los valores de
serviceNameseleccionados.Los nodos de Trace de otros tipos no se ingresan como eventos de auditoría de llamadas al modelo o a herramientas.
Cuando agregue un servicio de aplicación, abra nuevamente Manage Application Tracing Conversion Scope y seleccione el
serviceNamecorrespondiente.Los campos y valores convertidos provienen de los Traces de origen. El contenido que los datos originales no proporcionen no se completa automáticamente.
Si la misma aplicación se ingesta tanto mediante registros como mediante rastreo, podrían generarse datos duplicados. Cuando la página muestre un aviso de posible ingesta duplicada, conserve un solo método de ingesta y desmarque el servicio duplicado en el alcance de la conversión.
Preguntas frecuentes
No se encuentra el servicio objetivo en el alcance de la conversión
Compruebe los siguientes puntos en orden:
Si el AgentSpace seleccionado actualmente coincide con aquel al que pertenecen los Traces.
Si el servicio objetivo generó nuevos Traces durante las últimas 24 horas.
Si el valor de
serviceNamede los Traces es válido.Si los Traces contienen registros de llamadas de tipo LLM o Tool.
Si una aplicación con el mismo nombre ya se conectó a la auditoría mediante registros de aplicación de IA.
Se guardó el alcance de la conversión, pero no se muestran datos de auditoría
Primero genere una nueva llamada al modelo o a una herramienta en la aplicación objetivo y luego actualice la página Audit Management. Si los datos siguen sin aparecer, compruebe que los Traces de origen se puedan consultar correctamente y verifique si el estado de Application Tracing se muestra como Processing Error.
La página muestra un aviso de posible ingesta duplicada
Este aviso indica que la misma aplicación podría estarse ingresando tanto mediante registros como mediante rastreo. Haga clic en Manage Conversion Scope, desmarque el serviceName duplicado y guarde la configuración.