Asymptote-Labs/agent-beacon

Agent Beacon is the world's first open-source telemetry layer for AI agents wherever they run: locally, in CI, in the browser, or in the cloud.

Asymptote Lab 的 Agent Beacon – 它能做什麼

Agent Beacon 是一個開源遙測層，部署在運行 AI 代理的機器上（你的筆電、CI 執行器、雲端 VM、瀏覽器等），記錄代理執行的每一項操作——提示詞、工具呼叫、檔案編輯、命令執行、權杖使用量、成本、核准等。所有這些事件都會被統一歸一化為基於 OpenTelemetry 的單一 JSONL 模式，然後本地寫入，並可選擇性地轉送至你所選擇的安全/可觀察性堆疊（SIEM、日誌聚合服務、物件儲存，或 Asymptote 自有的儀表板）。

為什麼重要

跨執行環境的可見性 – 支援 20 多種本地代理執行環境（Claude Code、Cursor、Devin、VS Code Copilot 等），以及基於瀏覽器的聊天（Claude.ai、ChatGPT）、CI 流水線和雲端托管代理。
統一的模式 – 無需再拼接不相容的日誌；每個事件都遵循相同模型，便於關聯分析和檢測。
安全優先的預設設定 – 數據預設保留在端點；轉送為可選，且可定向至客戶控制的接收端。
企業級部署 – 提供 macOS、Linux、Windows 的套件，可透過 MDM（Jamf、Fleet、Rippling）或 Homebrew 安裝，並以系統服務方式執行。
本地檢測 – 內建的離線規則引擎（beacon scan）可在無網路連接的情況下對收集的遙測資料應用威脅檢測規則。

主要組件（如 README 所述）

組件	作用
Sources	捕獲本地代理、瀏覽器擴充、CI 作業或雲端 SDK 活動的鈎子、外掛或 OpenTelemetry 導出器。
Beacon core	收集事件，將其歸一化為統一模式，儲存在持久化的 `runtime.jsonl` 檔案中，建構會話時間軸，並執行本地檢測引擎。
Destinations	預設為本地 JSONL 檔案；可選地轉送至 SIEM（CrowdStrike、Sentinel、Splunk 等）、日誌聚合器（Datadog、Elastic、CloudWatch）、物件儲存（S3、GCS），或 Asymptote 的托管 Vector 端點。
Dashboard	一個只讀本地 UI，用於視覺化 JSONL 日誌和庫存狀態，適用於驗證和除錯。
MDM 部署	簽署的 macOS `.pkg`、Linux `.deb/.rpm`、Windows `.msi` 套件，可安裝服務、設定執行環境，並可大規模管理。

你可以用它做什麼

在任意機器上安裝單一二進位檔（beacon endpoint install）。
自動接入支援的代理 – 安裝程式會寫入設定檔或註冊 OTLP 導出器，使每個代理將事件串流傳送到 Beacon。
透過 beacon dashboard 本地查看，或開啟產生的 runtime.jsonl 檔案進行檢查。
轉送至你的安全堆疊 – 設定 Vector 轉送器或使用內建的 SIEM 集成。
執行離線威脅掃描 – beacon scan 應用基於 CEL 的規則（參見 spec/threat-rules）來檢測可疑模式。
透過 MDM 扩展 – 將套件推送到設備群，使用 beacon endpoint connect --system 將機器註冊至中央 Asymptote 仪表板（可選）。

誰會使用它

需要審計 AI 代理活動以防范資料外洩、憑證使用或政策合規問題的 安全與 IT 團隊。
希望在 CI 流水線中實現 AI 驅動工具可觀察性的 DevOps / SRE。
希望在不建構自己管道的情況下提供遙測資料的 AI 代理開發者。
運行多種不同代理產品的企業，需要統一視圖。

快速入門（來自 README）

執行 beacon endpoint install（或透過 Homebrew、.deb/.rpm、.msi 安裝）。
首次執行時會要求輸入電子信箱和使用類型——這是一次性、可退出的引導步驟。
服務將自動啟動，並開始從機器上存在的任何支援的執行環境收集事件。
使用 beacon dashboard 查看本地儀表板，或使用適當的 beacon 子命令將日誌轉送至你的 SIEM。

總結：Agent Beacon 為你提供了一種即插即用的方式，從不斷增長的 AI 代理生態系統中取得一致、可搜尋的遙測資料，同時將資料控制權保留在你手中，並提供內建的安全導向檢測功能。