SuperAPI AI 工具集

sentry-setup-ai-monitoring

部署与运维

查看项目

更新于 10-15 21:51

技能介绍

用途:在项目中配置 Sentry AI Agent Monitoring,用于追踪 LLM 调用、智能体执行、工具使用和 token 消耗,适用于需要 AI 可观测性、模型延迟或 AI 成本分析的场景。

主要能力:支持 JavaScript(openai、@anthropic-ai/sdk、Vercel AI、LangChain、LangGraph、@google/genai)、Python(openai、anthropic、langchain、huggingface_hub、google-genai、pydantic-ai、mcp 等,多数自动启用)以及 PHP/Laravel(laravel/ai,需 Laravel 12.x 与 sentry/sentry-laravel 4.27.0+)。可自动或手动埋点,采集 gen_ai.* 跨度,包括模型、token 用量、延迟、工具调用与智能体生命周期。

使用方式:先检测已安装的 AI SDK 与采样配置,确保 tracing 开启(tracesSampleRate > 0)。JS 在 Sentry.init 中启用集成;浏览器或 Next.js 需手动包装客户端;Python 安装 AI 包后自动启用;Laravel 通过 composer 安装并设置 SENTRY_TRACES_SAMPLE_RATE。多轮对话需设置 gen_ai.conversation.id 以启用 Conversations 视图。

限制与注意:提示词与输出捕获可能涉及 PII,JS 默认开启、Python 需 send_default_pii=True、Laravel 需 SENTRY_SEND_DEFAULT_PII=true,启用前须确认隐私政策与合规要求。生产环境不建议使用 tracesSampleRate: 1.0。token 属性中缓存与推理 token 是总量的子集,设置错误会导致成本为负。SDK 版本与 API 可能变化,实施前应以 docs.sentry.io 为准。