AI 应用接入：AI Coding Agent

Windows 支持情况

前提条件

开始接入前，请确认本机满足以下条件：

• 目标 AI Coding Agent 已安装，并至少使用过一次。

• 已在 AgentLoop 中完成 AI Coding Agent 接入资源初始化，并获取控制台自动生成的安装命令。

托管运行时回退：如果托管的 Node.js 运行时因平台不支持或下载失败而不可用，安装器会回退使用系统 Node.js；此时要求已安装 Node.js 18 或更高版本及 npm。

已知平台边界：Windows ARM64 和使用 musl 的 Linux（例如 Alpine）当前没有对应的托管 Node.js 产物，需要提前准备系统 Node.js 18 或更高版本及 npm。

安装 LoongSuite Pilot

对于 AgentLoop 用户，建议直接复制 AgentLoop 控制台自动生成的安装命令进行安装。命令中除 true、false 外的资源名称和接入参数，通常由 AgentLoop 在初始化接入资源时自动生成。

在安装前，需要通过 AgentLoop 控制台获取对应的 CMS、SLS 参数，在安装命令中替换为实际值。

# 执行安装命令，下面所有参数需要替换为上面获取到的参数
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 "您的SLS Project名" \
  --sls-logstore "您的SLS Logstore名" \
  --sls-endpoint "您的SLS Endpoint" \
  --cms-license-key "您的Trace License Key" \
  --cms-endpoint "您的Trace Endpoint" \
  --cms-workspace "您的Trace Workspace" \
  --service-name-prefix "您的服务名前缀"

# 下载安装脚本
Invoke-WebRequest `
    -Uri 'https://aliyun-observability-release-cn-shanghai.oss-cn-shanghai.aliyuncs.com/loongsuite-pilot/installer.ps1' `
    -OutFile installer.ps1

# 执行安装命令，下面所有参数需要替换为上面获取到的参数
.\installer.ps1 install `
    -CollectLog 'true' `
    -CollectTrace 'true' `
    -SlsProject "您的SLS Project名" `
    -SlsLogstore "您的SLS Logstore名" `
    -SlsEndpoint "您的SLS Endpoint" `
    -CmsLicenseKey "您的Trace License Key" `
    -CmsEndpoint "您的Trace Endpoint" `
    -CmsWorkspace "您的Trace Workspace" `
    -ServiceNamePrefix "您的服务名前缀"

安装器会自动完成以下操作：

• 检测本机支持的 AI Coding Agent。

• 让您选择需要采集的 Agent。

• 部署对应的 Hook 或插件。

• 写入本地配置。

• 启动 LoongSuite Pilot 后台服务。

安装完成后，执行以下命令查看服务状态：

macOS / Linux / Windows：

loongsuite-pilot status
loongsuite-pilot info

默认情况下，LoongSuite Pilot 会把本地配置、运行状态和 JSONL 采集结果写入当前用户目录下的 .loongsuite-pilot 目录。默认路径如下：

管理 LoongSuite Pilot

本地 Dashboard 随 LoongSuite Pilot 采集服务一起启动和停止，无需单独执行 monitor 命令。确认采集服务已启动后，直接访问：

http://127.0.0.1:8765/

如需卸载 LoongSuite Pilot 并保留本地数据，执行：

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

如需同时移除安装文件和本地数据，执行：

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

配置 Agent 采集

安装完成后，可以通过本地配置文件中的 agents 配置控制是否采集某个 AI Coding Agent。默认配置文件路径如下：

配置数据脱敏

LoongSuite Pilot 可以在规范化事件发送到输出后端前，对常见密钥和个人敏感数据进行脱敏。脱敏适用于 Prompt、Completion、工具参数或工具结果中可能出现凭证或个人敏感数据的场景。

如需开启或调整脱敏策略，请修改本地配置文件：

开启全部脱敏规则：

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

仅开启指定脱敏规则：

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

脱敏模式如下。

脱敏类型如下。

在包含大量纯数字业务标识的日志中，手机号和银行卡号的格式检测可能命中相同形态的数据，建议使用 custom 模式并只开启所需类型。

LoongSuite Pilot 重点扫描可能包含用户或工具内容的字段，例如：

• LLM 输入和输出消息。

• 工具调用参数。

• 工具调用结果。

• 已知 Agent 内容字段。

模型名、Token 数、耗时、Git 分支、Workspace 路径等稳定元数据不作为密钥内容字段扫描。

修改配置后，执行以下命令重启 LoongSuite Pilot：

loongsuite-pilot restart

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