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 运行器、云虚拟机、浏览器等），记录代理执行的每一项操作——提示词、工具调用、文件编辑、命令执行、令牌使用量、成本、审批等。所有这些事件都会被统一归一化为基于 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 代理生态系统中获取一致、可搜索的遥测数据，同时将数据控制权保留在你手中，并提供内置的安全导向检测功能。