SuperAPI AI 工具集

sentry

通用与其它

查看项目

更新于 10-15 20:09

技能介绍

用途:该技能用于在智能体环境中接入 Sentry,跟踪项目中的错误、异常、错误趋势与应用健康度。当用户询问错误、异常或应用运行状况时可使用。

连接方式:基础地址为 https://sentry.io/api/0。默认从令牌可访问的组织中发现组织 slug;如需指定组织,可配置 SENTRY_ORG_SLUG,或在调用 sentry 动作时传入 orgSlug。认证使用 Authorization: Bearer $SENTRY_SERVER_TOKEN,需为内部集成令牌,而非用户认证令牌或 DSN。环境变量为 SENTRY_SERVER_TOKEN,可回退到 SENTRY_AUTH_TOKEN。缓存为 5 分钟内存缓存,最多 100 条。所需权限范围包括 alerts:read、event:read、org:read、project:distribution、project:read、team:read。

主要能力:服务端库文件为 server/lib/sentry.ts,导出函数包括 listProjects()(列出组织内所有项目)、listIssues(projectSlug?, query?, statsPeriod?)(按项目或全组织列出问题)、getIssueEvents(issueId)(获取特定问题的事件)、getOrganizationStats(statsPeriod?, category?)(获取组织级错误统计趋势)。智能体动作 sentry 支持 organizations、issues、projects、issue-events、stats 等模式,分别用于列出组织、按频率列出问题、列出项目、获取问题事件和组织级统计。API 路由包括 GET /api/sentry/projects、/issues、/issue-events、/stats。仪表盘路径为 /adhoc/sentry。

使用方式:所有面向智能体的 Sentry 操作应通过 sentry 动作完成,不要直接从智能体调用 /api/sentry/*。若默认组织不正确,在动作调用中显式传入 orgSlug。

限制与注意:令牌类型为 Sentry 集成设置 TOKEN 表中的自定义/内部集成令牌,不是 Client Secret。getOrganizationStats 使用 stats_v2 端点,字段为 sum(quantity),按 outcome 分组,默认类别为 error。其他细节暂未提供。