用途:当用户需要查看 Sentry issue 或事件、汇总近期生产错误,或通过 Sentry API 拉取基础健康数据时使用。属于只读可观测性技能。
主要能力:使用内置 scripts/sentry_api.py 进行确定性的 API 调用,处理分页并在瞬时错误时重试一次;支持列出 issue、查看 issue 详情、获取 issue 的事件列表、查看事件详情。仅使用 GET 端点:/api/0/projects/{org_slug}/{project_slug}/issues/、/api/0/issues/{issue_id}/、/api/0/issues/{issue_id}/events/、/api/0/projects/{org_slug}/{project_slug}/events/{event_id}/。
使用方式:先确保已认证。若尚未认证,请用户提供有效的 SENTRY_AUTH_TOKEN(只读范围,如 project:read、event:read),或让其登录并创建令牌。将 SENTRY_AUTH_TOKEN 设为环境变量。可选默认值:SENTRY_ORG、SENTRY_PROJECT、SENTRY_BASE_URL。默认参数:组织/项目 {your-org}/{your-project},时间范围 24h(作为 statsPeriod 传入),环境 prod,limit 20(最大 50,需分页直至达到 limit),search_query 可选。issue_short_id 需先通过 list-issues 查询解析。令牌缺失时,引导用户访问 https://sentry.io/settings/account/api/auth-tokens/ 创建只读范围令牌,并在本地设置环境变量;绝不要让用户在聊天中粘贴完整令牌。脚本与参考资料位于 {baseDir}/。
输出规则:issue 列表显示 title、short_id、status、first_seen、last_seen、count、environments、top_tags,按最近排序;事件详情包含 culprit、timestamp、environment、release、url;无结果时明确说明;输出中对 PII(邮箱、IP)脱敏,不打印原始堆栈跟踪,绝不回显认证令牌。示例提示:“List the top 10 open issues for prod in the last 24h.”
限制:只有资料给出上述输入、端点和规则;关于收费、价格、平台或未提及的效果,资料暂未提供。