AgentLoop:Mengaktifkan Agen Koding AI

Ikhtisar LoongSuite Pilot

LoongSuite Pilot adalah collector ringan yang berjalan di mesin developer. Aplikasi ini secara otomatis mendeteksi Agen Koding AI yang terinstal dan men-deploy hook atau plugin yang diperlukan. LoongSuite Pilot menormalisasi data aktivitas mentah dari berbagai agen ke dalam format event terpadu dan melaporkan data tersebut ke backend log atau trace yang digunakan oleh AgentLoop.

Skenario

Ketika tim Anda menggunakan Agen Koding AI seperti Claude Code, Codex, Cursor, atau Qoder untuk pengembangan sehari-hari, Anda dapat menggunakan LoongSuite Pilot untuk mengumpulkan data aktivitas sisi klien dalam skenario berikut:

• Melihat Agen Koding AI mana saja yang digunakan di seluruh tim.

• Menganalisis sesi, panggilan model, panggilan tool, dan event error.

• Melacak penggunaan token yang dipecah berdasarkan agen.

• Menyelidiki perilaku runtime agen melalui kueri log, tautan trace, atau antarmuka kustom.

• Menyaring konten sensitif seperti prompt, completion, dan parameter tool sebelum data dilaporkan.

Agen Koding AI yang Didukung

Tabel berikut mencantumkan agen dan kemampuan pengumpulan data yang didukung oleh LoongSuite Pilot masing-masing pada Linux / macOS dan Windows.

Dukungan Linux / macOS

Dukungan Windows

Prasyarat

Sebelum memulai, pastikan persyaratan umum berikut terpenuhi:

• Agen Koding AI target telah terinstal dan telah digunakan setidaknya satu kali.

• Sumber daya onboarding Agen Koding AI telah diinisialisasi di Konsol AgentLoop, dan Anda telah memperoleh perintah instalasi yang dihasilkan secara otomatis.

macOS / Linux

Pastikan persyaratan berikut juga terpenuhi di mesin Anda:

• Anda biasanya tidak perlu menginstal Node.js atau npm terlebih dahulu. Installer akan mengunduh dan mematok runtime Node.js terkelola serta dependensi prebuilt.

• curl atau wget telah terinstal.

• Anda dapat mengakses URL unduhan OSS dalam perintah instalasi.

Windows

Pastikan persyaratan berikut juga terpenuhi di mesin Anda:

• Windows 10 atau lebih baru.

• PowerShell 5.1 atau lebih baru.

• Anda biasanya tidak perlu menginstal Node.js atau npm terlebih dahulu, dan Anda dapat mengakses URL unduhan OSS dalam perintah instalasi.

Fallback: Jika runtime Node.js terkelola tidak tersedia karena platform tidak didukung atau unduhan gagal, installer akan menggunakan fallback ke Node.js sistem. Dalam kasus ini, Node.js 18 atau lebih baru dan npm harus diinstal.

Batasan platform yang diketahui: Windows ARM64 dan distribusi Linux yang menggunakan musl (misalnya, Alpine) saat ini tidak memiliki artefak Node.js terkelola yang sesuai. Di platform-platform ini, siapkan terlebih dahulu Node.js sistem versi 18 atau lebih baru dan npm.

Instal LoongSuite Pilot

Untuk pengguna AgentLoop, kami merekomendasikan agar Anda menyalin perintah instalasi yang dihasilkan secara otomatis di Konsol AgentLoop. Nama sumber daya dan parameter koneksi dalam perintah (kecuali true dan false) dihasilkan secara otomatis selama inisialisasi sumber daya onboarding.

Peroleh nilai parameter CMS dan SLS dari Konsol AgentLoop.

macOS / Linux

# Jalankan perintah instalasi. Ganti semua nilai parameter dengan nilai yang diperoleh di atas.
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

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

# Jalankan installer. Ganti semua nilai parameter dengan nilai yang diperoleh di atas.
.\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"

Installer secara otomatis melakukan operasi berikut:

• Mendeteksi Agen Koding AI yang didukung di mesin Anda.

• Memungkinkan Anda memilih agen yang datanya ingin dikumpulkan.

• Men-deploy hook atau plugin yang sesuai.

• Menulis konfigurasi lokal.

• Memulai layanan latar belakang LoongSuite Pilot.

Setelah instalasi selesai, jalankan perintah berikut untuk memeriksa status layanan:

loongsuite-pilot status
loongsuite-pilot info

Secara default, LoongSuite Pilot menyimpan konfigurasi lokal, status runtime, dan hasil pengumpulan JSONL ke direktori .loongsuite-pilot di bawah direktori home pengguna saat ini. Jalur defaultnya adalah sebagai berikut:

Manage LoongSuite Pilot

Dasbor lokal dimulai dan dihentikan bersamaan dengan layanan koleksi LoongSuite Pilot. Anda tidak perlu menjalankan perintah monitor terpisah. Setelah layanan koleksi dimulai, buka alamat default berikut. Jika Anda mengonfigurasi port kustom, ganti 8765 dengan port tersebut:

http://127.0.0.1:8765/

Untuk menguninstall LoongSuite Pilot dan menyimpan data lokal, jalankan perintah berikut:

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

Untuk menghapus file instalasi dan data lokal sekaligus, jalankan perintah berikut:

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

Konfigurasi Pengumpulan Agen

Setelah instalasi, Anda dapat mengontrol apakah akan mengumpulkan data dari Agen Koding AI tertentu dengan memodifikasi bagian agents dalam file konfigurasi lokal. Jalur file konfigurasi default adalah sebagai berikut:

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

Sebagai contoh, untuk mengumpulkan data dari Claude Code dan Cursor tetapi menonaktifkan Qoder, gunakan konfigurasi seperti di atas. Setelah mengubah konfigurasi, restart LoongSuite Pilot:

loongsuite-pilot restart

Konfigurasi Penyamaran Data

LoongSuite Pilot dapat menyamarkan kredensial umum dan data sensitif pribadi dalam event yang dinormalisasi sebelum dikirim ke backend output. Penyamaran berlaku untuk skenario di mana prompt, completion, parameter tool, atau hasil tool mungkin berisi kredensial atau data sensitif pribadi.

Untuk mengaktifkan atau menyesuaikan kebijakan penyamaran, modifikasi file konfigurasi lokal. Jalur file konfigurasi default adalah sebagai berikut:

Untuk mengaktifkan semua aturan penyamaran:

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

Untuk mengaktifkan hanya aturan penyamaran tertentu:

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

Tabel berikut menjelaskan mode penyamaran.

Tabel berikut menjelaskan jenis penyamaran.

LoongSuite Pilot terutama memindai bidang yang mungkin berisi konten pengguna atau tool, seperti:

• Pesan input dan output LLM.

• Parameter panggilan tool.

• Hasil panggilan tool.

• Bidang konten agen yang dikenal.

Metadata stabil seperti nama model, jumlah token, latensi, cabang Git, dan jalur ruang kerja tidak dipindai sebagai bidang konten kredensial.

Setelah mengubah konfigurasi, jalankan perintah berikut untuk me-restart LoongSuite Pilot:

loongsuite-pilot restart

Verifikasi Hasil Onboarding

Setelah instalasi atau perubahan konfigurasi, ikuti langkah-langkah berikut untuk memverifikasi bahwa onboarding berhasil.

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

FAQ