用途:在项目中配置 Sentry AI Agent Monitoring,用于追踪 LLM 调用、智能体执行、工具使用与 token 消耗,并提供 AI 可观测性与成本/延迟分析。
主要能力:自动或手动接入 Sentry SDK,生成 gen_ai.* 类型的 span,覆盖 LLM 调用、智能体生命周期、工具调用、智能体交接与嵌入生成等;支持 JS/TS、Python、PHP/Laravel 等 SDK;可通过 gen_ai.conversation.id 将多轮对话分组为 Conversations 视图。
使用方式:先检测项目中已安装的 AI SDK(如 openai、@anthropic-ai/sdk、ai、@langchain、@google/genai 等)及现有采样配置。必须启用 tracing(tracesSampleRate > 0)。Node.js 中多数集成在安装 AI 包后自动启用;浏览器、Next.js 与 Cloudflare Workers 通常需要手动包装或使用插件。Python 集成自动启用,可用 send_default_pii=True 开启内容捕获。Laravel 需 sentry/sentry-laravel ^4.27.0 与 laravel/ai,并设置 SENTRY_TRACES_SAMPLE_RATE。多轮对话建议设置 conversation ID。配置后发起一次 LLM 调用,在 Sentry Traces 面板验证 gen_ai.* span。
限制与注意:API 名称、最低 SDK 版本与示例代码可能变化,实施前应以 docs.sentry.io 为准。生产环境不要使用 tracesSampleRate: 1.0,应降低采样率或用 tracesSampler;若根 span 被丢弃,其子 gen_ai span 也会丢失,建议 AI 相关事务 100% 采样。prompt/输出捕获可能包含 PII,必须获得用户明确确认后再启用。token 计数中缓存与推理 token 是总量的子集,若上报的缓存/推理值大于总量会导致成本为负。资料未提供具体价格与收费信息。