AgentLoop:Guía de integración de auditoría

Tipos de agentes compatibles

Actualmente, el módulo Audit admite la ingesta de registros de sesión para los siguientes agentes de codificación de IA:

Pasos de ingesta

1. Inicie sesión en la consola de AgentLoop. En el panel de navegación izquierdo, haga clic en Ingestion Center.

2. En el área AI Observability, busque la tarjeta del tipo de agente de destino (por ejemplo, Qoder, Cursor o Claude Code) y haga clic en ella para acceder a la configuración de ingesta.

3. Seleccione el escenario de despliegue: Host, Kubernetes o Docker.

4. Configure los parámetros de ingesta:

   Parámetro	Descripción
   Application name prefix	Identifica un grupo de instancias de agente y genera el nombre del servicio; por ejemplo, ai-coding-prod
   Connection method	Red pública o red interna de Alibaba Cloud
   AgentSpace initialization	Inicializa el AgentSpace actual y vincula CMS Workspace con SLS Project
   Project	El SLS Project vinculado al AgentSpace actual (solo lectura)
   Log storage location	Los registros de auditoría del lado de la aplicación se escriben en agent-event / agent-event-webtracking. El destino específico depende de la configuración de recopilación generada por Ingestion Center.
   Machine group	Seleccione o cree un machine group para el destino de recopilación

5. Configure las opciones de procesamiento de datos:

   Data masking (opcional): Admite el enmascaramiento de información confidencial, como números de teléfono, números de identificación, direcciones de correo electrónico, direcciones IP, números de teléfono fijo y números de tarjetas bancarias. Esta opción está deshabilitada de forma predeterminada y se puede habilitar según sea necesario.

6. Haga clic en Complete ingestion. El sistema genera automáticamente los comandos de instalación. Ejecute estos comandos en el host o clúster de destino para completar el despliegue de Pilot y la configuración de recopilación.

Verificación de la ingesta

Una vez finalizada la ingesta, compruebe en la consola de SLS si los datos se están escribiendo en agent-event / agent-event-webtracking. También puede consultar la marca de tiempo más reciente de los datos correspondientes a la aplicación del agente en la página Audit Management. Vaya a Audit Facts, filtre por tipo de agente o nombre de aplicación y compruebe que las sesiones reportadas, los datos de solicitud y respuesta del modelo, y los datos de llamadas a herramientas sean visibles.

Tipos de datos recopilados

Los registros de auditoría recopilados mediante la ingesta de aplicaciones de IA incluyen los siguientes tipos de eventos:

Descripción general

La ingesta de AI Node Runtime/eBPF utiliza tecnología eBPF para observar el comportamiento del agente en tiempo de ejecución a nivel de kernel, sin modificar el código de la aplicación. Con este método es posible:

• Identificar los procesos de agentes de IA que se ejecutan en los hosts y determinar su tipo.

• Capturar las características de las solicitudes de API de LLM (modelo, tokens, entre otros).

• Supervisar comportamientos a nivel de proceso, como lecturas y escrituras de archivos o conexiones de red.

• Detectar actividades de agentes que no se registran mediante la ingesta formal de registros de sesión.

Pasos de ingesta

1. En el área AI Observability de Ingestion Center, haga clic en la tarjeta AI Node Runtime/eBPF.

2. Seleccione el escenario de despliegue: Host, Kubernetes o Docker.

3. Configure los parámetros de alcance del nodo:

   Parámetro	Descripción
   Project	El SLS Project vinculado al AgentSpace actual (solo lectura)
   Logstore	Fijado en ebpf-event (solo lectura)
   Machine group	Seleccione o cree un machine group para el destino de recopilación

4. Configure las reglas de detección de AgentSight:

   • Command-line allowlist: Defina las reglas de procesos de agente que se incluirán en la recopilación. Cada grupo contiene un tipo de agente y un patrón de argumento de línea de comandos. A los procesos que coinciden con esta lista de permitidos se les asigna una etiqueta con el tipo de agente correspondiente.

   • Command-line blocklist: Defina los patrones de procesos que se excluirán de la recopilación. Esta lista tiene prioridad sobre la lista de permitidos.

   • Domain allowlist: Defina los patrones de dominios de acceso a la red que se incluirán en la recopilación. Los procesos que accedan a los dominios de esta lista también formarán parte del alcance de recopilación.

   Si no se proporciona ninguna configuración, el sistema utiliza los valores predeterminados recomendados. Cuando se configura algún elemento, la configuración actual reemplaza por completo la lista predeterminada correspondiente.

5. Configure las opciones de enmascaramiento de datos (opcional). Están disponibles las mismas opciones que en la ingesta de aplicaciones de IA.

6. Complete la configuración de ingesta.

Verificación de la ingesta

Una vez finalizada la ingesta de eBPF, compruebe en la consola de SLS si los datos se están escribiendo en el logstore ebpf-event para confirmar que la ingesta fue exitosa.