AgentLoop:Integração de AI Coding Agents

Visão geral do LoongSuite Pilot

O LoongSuite Pilot é um coletor leve que roda nas máquinas dos desenvolvedores. Ele descobre automaticamente os AI Coding Agents instalados e implanta os hooks ou plugins necessários. O LoongSuite Pilot normaliza dados brutos de atividade de diferentes agentes em um formato de evento unificado e envia esses dados ao backend de log ou rastreamento do AgentLoop.

Cenários

Se sua equipe usa AI Coding Agents como Claude Code, Codex, Cursor ou Qoder no desenvolvimento diário, use o LoongSuite Pilot para coletar dados de atividade do lado do cliente nos seguintes cenários:

• Visualize quais AI Coding Agents a equipe utiliza.

• Analise sessões, chamadas de modelo, chamadas de ferramentas e eventos de erro.

• Acompanhe o uso de tokens por agente.

• Investigue o comportamento de execução do agente mediante consultas de log, links de rastreamento ou interfaces personalizadas.

• Filtre conteúdo sensível, como prompts, conclusões e parâmetros de ferramentas, antes de enviar os dados.

AI Coding Agents suportados

As tabelas a seguir listam os AI Coding Agents compatíveis com o LoongSuite Pilot e as capacidades de coleta de cada um. A primeira tabela descreve as capacidades gerais de integração do LoongSuite Pilot. Isso não significa que todos os agentes foram verificados em todos os sistemas operacionais. Para diferenças específicas de sistema operacional, consulte a tabela do Windows.

Capacidades gerais

Windows

Pré-requisitos

Antes de começar, certifique-se de atender aos seguintes requisitos gerais:

• O AI Coding Agent alvo está instalado e foi usado pelo menos uma vez.

• Os recursos de integração do AI Coding Agent foram inicializados no console do AgentLoop e você obteve o comando de instalação gerado automaticamente.

macOS / Linux

Certifique-se também de atender aos seguintes requisitos na sua máquina:

• Geralmente, não é necessário pré-instalar Node.js ou npm. O instalador baixa e fixa um runtime gerenciado do Node.js e dependências pré-compiladas.

• curl ou wget deve estar instalado.

• Você precisa ter acesso às URLs de download do OSS presentes no comando de instalação.

Windows

Verifique se os seguintes requisitos também são atendidos na sua máquina:

• Windows 10 ou superior.

• PowerShell 5.1 ou superior.

• Normalmente, não é preciso pré-instalar Node.js ou npm, e você deve conseguir acessar as URLs de download do OSS no comando de instalação.

Fallback: Caso o runtime gerenciado do Node.js esteja indisponível devido à falta de suporte da plataforma ou falha no download, o instalador usará o Node.js do sistema. Nessa situação, é obrigatório ter o Node.js 18 ou superior e o npm instalados.

Limitações conhecidas de plataforma: Atualmente, não há artefatos gerenciados do Node.js compatíveis com Windows ARM64 e distribuições Linux que usam musl (como Alpine). Nessas plataformas, prepare previamente o Node.js 18 ou superior e o npm do sistema.

Instalar o LoongSuite Pilot

Para usuários do AgentLoop, recomendamos copiar o comando de instalação gerado automaticamente no console do AgentLoop. Os nomes dos recursos e parâmetros de conexão no comando (exceto true e false) são gerados automaticamente durante a inicialização dos recursos de integração.

Obtenha os valores dos parâmetros CMS e SLS no console do 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"

O instalador executa automaticamente as seguintes operações:

• Detecta os AI Coding Agents suportados na sua máquina.

• Permite selecionar os agentes cujos dados você deseja coletar.

• Implanta os hooks ou plugins correspondentes.

• Grava a configuração local.

• Inicia o serviço em segundo plano do LoongSuite Pilot.

Após concluir a instalação, execute os comandos abaixo para verificar o status do serviço:

loongsuite-pilot status
loongsuite-pilot info

Por padrão, o LoongSuite Pilot grava a configuração local, o status de execução e os resultados da coleta JSONL no diretório .loongsuite-pilot, localizado na home do usuário atual. Os caminhos padrão são:

Gerenciar o LoongSuite Pilot

O painel local inicia e encerra junto com o serviço de coleta do LoongSuite Pilot. Não é necessário executar um comando de monitoramento separado. Após confirmar que o serviço de coleta está em execução, acesse a seguinte URL:

http://127.0.0.1:8765/

Para desinstalar o LoongSuite Pilot mantendo os dados locais, execute o comando abaixo:

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

Para remover tanto os arquivos de instalação quanto os dados locais, execute este 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 a coleta de agentes

Após a instalação, controle a coleta de dados de um AI Coding Agent específico modificando a seção agents no arquivo de configuração local. O caminho padrão do arquivo de configuração é:

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

Por exemplo, para coletar dados do Claude Code e do Cursor, mas desativar o Qoder, use a configuração mostrada acima. Após modificar a configuração, reinicie o LoongSuite Pilot:

loongsuite-pilot restart

Configurar mascaramento de dados

O LoongSuite Pilot pode mascarar credenciais comuns e dados pessoais sensíveis em eventos normalizados antes do envio ao backend de saída. O mascaramento aplica-se a cenários em que prompts, conclusões, parâmetros de ferramentas ou resultados de ferramentas podem conter credenciais ou dados pessoais sensíveis.

Para ativar ou ajustar a política de mascaramento, modifique o arquivo de configuração local. O caminho padrão do arquivo é:

Para ativar todas as regras de mascaramento:

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

Para ativar apenas regras específicas de mascaramento:

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

A tabela a seguir descreve os modos de mascaramento.

A tabela abaixo detalha os tipos de mascaramento disponíveis.

O LoongSuite Pilot examina principalmente campos que podem conter conteúdo de usuário ou ferramenta, tais como:

• Mensagens de entrada e saída do LLM.

• Parâmetros de chamada de ferramenta.

• Resultados de chamada de ferramenta.

• Campos de conteúdo conhecidos do agente.

Metadados estáveis, como nomes de modelos, contagens de tokens, latência, branches do Git e caminhos de workspace, não são examinados como campos de conteúdo de credencial.

Após modificar a configuração, execute o comando abaixo para reiniciar o LoongSuite Pilot:

loongsuite-pilot restart

Verificar o resultado da integração

Após alterações na instalação ou configuração, siga estas etapas para confirmar que a integração foi bem-sucedida.

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

Perguntas frequentes