扣子平台的 API 调用审计日志在哪里查看,个人版能查到每次请求的明细吗?
扣子平台没有单独的「API 调用审计日志」页面:调用量统计在 Bot 的 API 管理入口,单次请求明细要用扣子罗盘的 Trace 按 request_id 检索,成员操作审计在企业版组织管理里。个人版一般只能看到聚合数据,逐次明细和他人操作记录需要专业版或企业版并具备管理员权限,长期留存还要自行导出。
扣子平台没有一个名为「API 调用审计日志」的独立页面,可查内容分散在三处:Bot 发布后的 API 调用统计、扣子罗盘的调用链明细、企业版组织管理中的成员操作日志。个人版通常只能看到调用量与成功率的聚合数据,逐次请求明细和成员操作审计需要专业版或企业版,并且要具备空间管理员权限;免费个人空间查不到他人调用记录,也不适合作为合规审计的唯一来源。
先分清审计目标是「调用行为」还是「配置变更」,两者的入口和权限完全不同。调用行为回答谁在什么时候调了哪个 Bot、结果如何;配置变更回答谁改了提示词、知识库或工作流并发布了新版本。把这两类混在一个页面里找,是多数人觉得扣子没有审计日志的原因。
只看调用量和成功率,在 Bot 的发布管理与 API 管理入口就能完成。Bot 发布为 API 后,控制台会按天或按小时汇总调用次数、失败次数和错误码分布,适合判断接口是否整体可用。这种粒度是聚合值,不能还原某一次具体请求的输入输出,也不带调用方身份。
要定位某一次失败请求,得用扣子罗盘的 Trace 检索能力。按 request_id 或 conversation_id 查出整条调用链,能看到每个节点的输入输出、模型耗时、token 消耗和报错位置,多轮会话还能按会话维度串起来。Trace 面向排障,记录的是执行细节,不等于合规意义上的操作审计。
要回答「谁在什么时候把线上 Bot 改了」,看的是组织管理里的成员操作日志。这类日志记录成员对 Bot、知识库、插件、工作流的创建、修改、删除和发布动作,带操作人和时间。它不记录对话内容,也不记录外部 API 每次请求的参数,两类日志不能互相替代。
审计日志的可见范围由角色决定,普通开发者看不到同空间其他人的调用明细。空间管理员可以查看成员操作记录和整体调用情况,超管权限更大;普通成员一般只能看到自己名下的 Bot。排查「日志是空的」时,先确认账号角色和数据归属,再怀疑功能缺失。
平台日志能不能当审计依据,取决于保留期和是否支持导出。控制台展示通常有时间窗口,过期后明细查不到,需要长期留存的要定期导出到自有日志系统。涉及等保或内部合规时,保留周期、导出权限、脱敏规则都要按内部制度定,不能默认平台会永久保存。
读日志的顺序是 request_id、状态码、token 与耗时,不要一上来翻对话内容。request_id 是串联平台记录和业务记录的唯一定位符;4xx 多为调用方参数、鉴权或配额问题,5xx 才更多指向平台或模型侧;token 与耗时突增往往先于错误率上升,是容量问题的早期信号。
把调试台的对话记录当成审计日志是最常见的误区。调试台记录的是开发者在控制台里的自测对话,用于调提示词和看知识库召回,外部通过 API 发起的调用不会完整落在那里。对外提供服务的 Bot,其调用情况要以 API 维度的统计和 Trace 为准。
平台日志存在延迟,且不同工作空间之间默认不互通。刚发生的调用可能要等几分钟才出现在统计里,跨团队共用多个空间时,各空间的日志各自独立。做故障复盘或对账时,以调用发生时间对齐并预留延迟窗口,否则容易把延迟误判成调用丢失。
调用侧自建日志是审计的兜底,核心是记录 request_id 与业务单号的映射。在自有后端或网关把每次请求的 request_id、bot_id、业务订单号、开始时间、耗时、返回状态落库,平台侧日志只用来核对内容与计费。这样平台日志过期、权限受限或空间迁移时,业务侧仍能还原调用链路。
用控制台还是导出到日志系统,由日调用量和团队数决定。单团队、日调用几百次,控制台加定期导出足够;多团队、上千次以上或需要按人按业务分摊成本时,应把调用记录接入自有可观测或日志服务,导出前先做对话内容脱敏并对查询权限做最小化授权。落到操作上,先明确要查的是调用明细、配置变更还是用量对账,再对应到 API 管理、扣子罗盘、成员操作日志三个入口,比在一个页面里找「总开关」更省时间。