接入 AI 编程助手

使用限制

• 操作系统：支持 macOS、Linux 和 WSL。Windows 原生环境暂不支持。

• Node.js：建议安装 Node.js 22，要求 Node.js 18 及以上版本。

• AI 编程助手：已安装并使用过 Qoder IDE、Qoder CLI 或 Codex 等 AI 编程助手。Pilot 需要在日常使用这些工具的同一个操作系统用户下安装。

• 云监控服务：已开通云监控 2.0 服务，并创建了目标工作空间。

• Trace 接入：如需上报 Trace，需在接入中心获取 Trace 接入 LicenseKey 和 Trace Endpoint。

• 日志接入：如需上报日志，需在接入中心完成日志接入资源初始化，并获取日志服务 Project、Logstore 和 Endpoint。

步骤一：获取接入命令

在安装 LoongSuite Pilot 前，您需要先从云监控 2.0 控制台获取接入命令。

1. 登录云监控 2.0 控制台，选择目标工作空间。

2. 在左侧导航栏单击接入中心。

3. 在AI 应用可观测区域单击LoongSuite Pilot或对应 AI 编程助手接入卡片。

4. 在参数配置区域完成配置。连接方式选择公网方式或阿里云内网方式；应用名前缀用于生成服务名，例如 ai-coding-agent 会生成 ai-coding-agent-qoder、ai-coding-agent-codex 等服务名；Trace 接入开启后需要获取 LicenseKey；日志接入开启后需要完成日志接入资源初始化。

页面下方将根据配置参数生成相应的安装命令。命令中如果仍显示“请先...”占位，请先回到上方完成 LicenseKey 获取或日志资源初始化后再执行。

步骤二：安装接入

# 安装 nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash

# 用 nvm 安装 v22 版本的 Node.js
nvm install 22

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 "<日志服务Project>" \
  --sls-logstore "pilot-audit-log" \
  --sls-endpoint "<日志服务Endpoint>" \
  --cms-license-key "<Trace接入LicenseKey>" \
  --cms-endpoint "<Trace接入Endpoint>" \
  --cms-workspace "<云监控工作空间>" \
  --service-name-prefix "<应用名前缀>"

步骤三：验证安装

安装完成后，执行以下命令检查 LoongSuite Pilot 是否正常运行：

loongsuite-pilot status
loongsuite-pilot info
ls "$HOME/.loongsuite-pilot/logs/output"

使用 Qoder IDE、Qoder CLI 或 Codex 完成一次 AI 生成或对话后，等待采集服务刷新。默认 JSONL 兜底输出目录应产生增量采集结果：

ls -lt "$HOME/.loongsuite-pilot/logs/output"

如果开启了日志接入，可以在 AgentLoop 的审计 > AI Agent洞察中查看 AI Agent 日志，也可以在日志服务目标 Project 的 pilot-audit-log 中检索原始 Agent 活动事件。如果开启了 Trace 接入，可以在云监控 2.0 的 AI 应用可观测中查看对应服务的调用链路。

步骤四：查看监控数据

Trace 数据在云监控 2.0 的 AI 应用可观测中查看；日志接入产生的 Agent 审计数据在 AgentLoop 的 AI Agent洞察中查看。

1. 登录云监控 2.0 控制台，选择目标工作空间。

2. 在左侧导航栏选择应用可观测 > AI 应用可观测。

3. 在应用列表中查找安装时配置的服务名前缀。例如应用名前缀为 ai-coding-agent 时，可查找 ai-coding-agent-qoder、ai-coding-agent-codex 等服务。

4. 单击应用名称或选择调用链分析，查看会话、Turn、Step、LLM 调用、工具调用、Token 消耗和耗时分布。

5. 如需查看日志接入上报的 Agent 活动事件，进入 AgentLoop，选择目标工作空间，在左侧导航栏选择审计 > AI Agent洞察，查看 AI Agent 日志、会话记录和工具调用审计数据。

升级和卸载

LoongSuite Pilot 会自动检查并在后台完成升级，无需手动执行升级命令；升级后会继续使用当前采集配置。

如需完全卸载 LoongSuite Pilot，并删除本地配置和日志数据，执行以下命令：

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

支持范围

常见问题