用途:回答“发生了什么、为什么”,用于排查意外扣费、套餐变更历史、被拒绝的功能检查、余额与用量差异,以及 Stripe webhook 投递问题。
主要能力:结合两类数据源——当前账户状态(客户、套餐、余额查询工具)与请求日志接口(searchRequestLogs、queryRequestLogs)。日志记录 API 请求和 Stripe webhook 投递,每条含请求体与响应体,但不暴露 Autumn 内部处理过程,因此结论必须来自可观测的请求、响应与状态。
使用方式:先加载 autumn-concepts 技能理解数据模型。每次排查按固定顺序:先确定三个锚点——客户(customer_id,可用客户查询工具解析名称或邮箱,如有实体则加 entity_id)、显式时间窗(把“本月”等相对说法转为具体日期)、期望与实际行为的一句话描述;缺少锚点时先集中追问。然后先查当前状态(getCustomer 常能立即回答“现状”)。定位事故窗口时,先用一次 queryRequestLogs 按 bin(timestamp, ...) 聚合找出相关活动时段,再用 searchRequestLogs 在窄范围下钻查看 request_body / response_body。采用两遍模式:Pass A 定位、Pass B 检查,避免宽范围大列表查询。查询使用受限管道语法,阶段为 where、summarize、project、order by、limit,谓词支持 ==、!=、>、>=、<、<=、contains、startswith、in、and/or 与括号;可查询字段包括 timestamp、source、status_code、request_method、request_url、request_path、request_body、response_body、org_id、customer_id、entity_id、stripe_event_id、stripe_event_type、stripe_object_id;嵌套路径最多 4 段,仅限 request_body 与 response_body 下。searchRequestLogs 每次范围上限 7 天、默认仅 30 分钟,必须显式传范围;queryRequestLogs 有 customer_id 过滤时上限 30 天,否则 15 天;limit 上限 200。覆盖超过 7 天需按连续窗口分页,或先用聚合缩小范围。按域查阅对应参考:账单/发票/套餐变更/取消/试用/状态漂移看 references/billing-timeline.md;被拒绝检查、余额或额度差异、用量、重置、402/429 看 references/balances-usage.md;Stripe webhook、订阅生命周期、支付失败看 references/stripe-webhooks.md。最后报告结论先行,附时间线、所用时间范围和过滤条件及不确定性。
适用场景:账单与订阅状态排查、余额与用量核对、webhook 投递追踪、按路径或状态码的失败请求分析等。
限制:日志不暴露内部处理(后台任务、缓存、处理错误),无法解释的原因应说明并建议联系 Autumn 支持。不得将接口描述为公开 API 文档,也不得据此虚构端点。查询不接受自由文本或 *,字段必须来自可查列表。资料未提供收费、价格与平台等信息。