AgentLoop:Incorporación de agentes de codificación con IA

Descripción general de LoongSuite Pilot

LoongSuite Pilot es un recopilador ligero que se ejecuta en las computadoras de los desarrolladores. Detecta automáticamente los AI Coding Agents instalados y despliega los hooks o plugins necesarios. Este componente normaliza los datos de actividad sin procesar de distintos agentes en un formato de evento unificado. Después, envía la información al backend de registros o trazas que utiliza AgentLoop.

Escenarios

Si su equipo utiliza AI Coding Agents como Claude Code, Codex, Cursor o Qoder en el desarrollo diario, puede usar LoongSuite Pilot para recopilar datos de actividad del lado del cliente en los siguientes escenarios:

• Consulte qué AI Coding Agents se utilizan en todo el equipo.

• Analice sesiones, llamadas a modelos, llamadas a herramientas y eventos de error.

• Realice un seguimiento del uso de tokens desglosado por agente.

• Investigue el comportamiento de ejecución de los agentes mediante consultas de registros, enlaces de trazas o interfaces personalizadas.

• Filtre contenido confidencial, como prompts, respuestas (completions) y parámetros de herramientas, antes de enviar los datos.

AI Coding Agents compatibles

A continuación se muestran las tablas con los agentes y las capacidades de recopilación de datos que admite LoongSuite Pilot en Linux / macOS y Windows, respectivamente.

Compatibilidad con Linux / macOS

Compatibilidad con Windows

Requisitos previos

Antes de empezar, compruebe que se cumplen los siguientes requisitos generales:

• El AI Coding Agent de destino está instalado y se ha utilizado como mínimo una vez.

• Los recursos de incorporación del AI Coding Agent se inicializaron en la consola de AgentLoop y usted obtuvo el comando de instalación generado automáticamente.

macOS / Linux

Compruebe también que su computadora cumple con los siguientes requisitos:

• Por lo general, no es necesario instalar previamente Node.js ni npm. El instalador descarga y fija un entorno de ejecución de Node.js administrado junto con las dependencias precompiladas.

• Debe tener instalado curl o wget.

• Es obligatorio poder acceder a las URL de descarga de OSS indicadas en el comando de instalación.

Windows

Compruebe también que su computadora cumple con los siguientes requisitos:

• Windows 10 o posterior.

• PowerShell 5.1 o posterior.

• Normalmente no hace falta instalar Node.js ni npm de antemano. Además, debe poder acceder a las URL de descarga de OSS incluidas en el comando de instalación.

Alternativa: Si el entorno de ejecución administrado de Node.js no está disponible porque la plataforma no es compatible o la descarga falla, el instalador recurre al Node.js del sistema. En este caso, es obligatorio tener instalado Node.js 18 o posterior y npm.

Límites conocidos de plataformas: Windows ARM64 y las distribuciones de Linux que usan musl (por ejemplo, Alpine) no cuentan actualmente con un artefacto administrado de Node.js correspondiente. En estas plataformas, prepare de antemano Node.js 18 o posterior y npm a nivel de sistema.

Instalar LoongSuite Pilot

Si usted usa AgentLoop, se recomienda copiar el comando de instalación que genera automáticamente la consola de AgentLoop. Los nombres de recursos y los parámetros de conexión del comando (excepto true y false) se generan de forma automática durante la inicialización de los recursos de incorporación.

Obtenga los valores de los parámetros de CMS y SLS desde la consola de AgentLoop.

macOS / Linux

# Run the installation command. Replace all parameter values with the ones obtained above.
curl -fsSL https://aliyun-observability-release-cn-shanghai.oss-cn-shanghai.aliyuncs.com/loongsuite-pilot/installer.sh -o /tmp/loongsuite-pilot-installer.sh && bash /tmp/loongsuite-pilot-installer.sh install \
  --collect-log "true" \
  --collect-trace "true" \
  --sls-project "your_SLS_Project_name" \
  --sls-logstore "your_SLS_Logstore_name" \
  --sls-endpoint "your_SLS_endpoint" \
  --cms-license-key "your_Trace_License_Key" \
  --cms-endpoint "your_Trace_endpoint" \
  --cms-workspace "your_Trace_workspace" \
  --service-name-prefix "your_service_name_prefix"

Windows

# Download the installer script
Invoke-WebRequest `
    -Uri 'https://aliyun-observability-release-cn-shanghai.oss-cn-shanghai.aliyuncs.com/loongsuite-pilot/installer.ps1' `
    -OutFile installer.ps1

# Run the installer. Replace all parameter values with the ones obtained above.
.\installer.ps1 install `
    -CollectLog 'true' `
    -CollectTrace 'true' `
    -SlsProject "your_SLS_Project_name" `
    -SlsLogstore "your_SLS_Logstore_name" `
    -SlsEndpoint "your_SLS_endpoint" `
    -CmsLicenseKey "your_Trace_License_Key" `
    -CmsEndpoint "your_Trace_endpoint" `
    -CmsWorkspace "your_Trace_workspace" `
    -ServiceNamePrefix "your_service_name_prefix"

El instalador ejecuta automáticamente las siguientes operaciones:

• Detecta los AI Coding Agents compatibles presentes en su computadora.

• Le permite seleccionar los agentes de los cuales desea recopilar datos.

• Despliega los hooks o plugins correspondientes.

• Escribe la configuración local.

• Inicia el servicio en segundo plano de LoongSuite Pilot.

Una vez finalizada la instalación, ejecute los siguientes comandos para comprobar el estado del servicio:

loongsuite-pilot status
loongsuite-pilot info

De forma predeterminada, LoongSuite Pilot escribe la configuración local, el estado de ejecución y los resultados de recopilación JSONL en el directorio .loongsuite-pilot, ubicado dentro del directorio principal del usuario actual. Las rutas predeterminadas son las siguientes:

Gestionar LoongSuite Pilot

El panel local inicia y se detiene junto con el servicio de recopilación de LoongSuite Pilot. No es necesario ejecutar un comando de monitoreo por separado. Cuando el servicio de recopilación inicie, abra la siguiente dirección predeterminada. Si configuró un puerto personalizado, sustituya 8765 por dicho puerto:

http://127.0.0.1:8765/

Para desinstalar LoongSuite Pilot y conservar los datos locales, ejecute el siguiente comando:

macOS / Linux:

curl -fsSL https://aliyun-observability-release-cn-shanghai.oss-cn-shanghai.aliyuncs.com/loongsuite-pilot/installer.sh -o /tmp/loongsuite-pilot-installer.sh && bash /tmp/loongsuite-pilot-installer.sh uninstall

Windows:

.\installer.ps1 uninstall

Si desea eliminar tanto los archivos de instalación como los datos locales, ejecute el siguiente comando:

macOS / Linux:

curl -fsSL https://aliyun-observability-release-cn-shanghai.oss-cn-shanghai.aliyuncs.com/loongsuite-pilot/installer.sh -o /tmp/loongsuite-pilot-installer.sh && bash /tmp/loongsuite-pilot-installer.sh uninstall --purge

Windows:

.\installer.ps1 uninstall -Purge

Configurar la recopilación de agentes

Después de la instalación, puede controlar si se recopilan datos de un AI Coding Agent específico. Para ello, modifique la sección agents en el archivo de configuración local. La ruta predeterminada del archivo de configuración es la siguiente:

{
  "agents": {
    "claude-code": {
      "enabled": true
    },
    "cursor": {
      "enabled": true
    },
    "qoder": {
      "enabled": false
    }
  }
}

Por ejemplo, si necesita recopilar datos de Claude Code y Cursor, pero deshabilitar Qoder, utilice la configuración mostrada anteriormente. Después de modificar la configuración, reinicie LoongSuite Pilot:

loongsuite-pilot restart

Configurar el enmascaramiento de datos

LoongSuite Pilot puede enmascarar credenciales comunes y datos personales confidenciales en los eventos normalizados antes de enviarlos al backend de salida. Este enmascaramiento aplica a escenarios donde los prompts, las respuestas (completions), los parámetros de herramientas o sus resultados podrían contener credenciales o datos personales sensibles.

Para habilitar o ajustar la política de enmascaramiento, modifique el archivo de configuración local. La ruta predeterminada de dicho archivo es la siguiente:

Para habilitar todas las reglas de enmascaramiento:

{
  "mask": {
    "mode": "all"
  }
}

Para habilitar únicamente reglas específicas de enmascaramiento:

{
  "mask": {
    "mode": "custom",
    "types": [
      "apiKey",
      "idCard",
      "phone",
      "email",
      "ipAddress",
      "bankCard"
    ]
  }
}

A continuación se describen los modos de enmascaramiento.

La siguiente tabla describe los tipos de enmascaramiento.

LoongSuite Pilot analiza principalmente los campos que pueden contener información del usuario o de herramientas, tales como:

• Mensajes de entrada y salida del LLM.

• Parámetros de las llamadas a herramientas.

• Resultados de las llamadas a herramientas.

• Campos de contenido conocidos del agente.

Los metadatos estables, como los nombres de modelos, los conteos de tokens, la latencia, las ramas de Git y las rutas de los espacios de trabajo, no se analizan como campos de contenido de credenciales.

Después de modificar la configuración, ejecute el siguiente comando para reiniciar LoongSuite Pilot:

loongsuite-pilot restart

Comprobar el resultado de la incorporación

Tras realizar la instalación o cambiar la configuración, siga estos pasos para comprobar que la incorporación fue exitosa.

loongsuite-pilot status
loongsuite-pilot info

ls ~/.loongsuite-pilot/logs/output
tail -f ~/.loongsuite-pilot/logs/output/*.jsonl

Get-ChildItem "$env:USERPROFILE\.loongsuite-pilot\logs\output"

Get-ChildItem "$env:USERPROFILE\.loongsuite-pilot\logs\output\*.jsonl" |
  Sort-Object LastWriteTime |
  Select-Object -Last 1 |
  Get-Content -Wait

Preguntas frecuentes