扣子平台怎么查看 API 调用审计日志,能按智能体、时间和调用状态筛选吗?

在扣子平台查看 API 调用审计日志,要进入目标工作空间下已发布智能体或应用的 API 与日志入口,按时间、智能体、调用状态和请求标识筛选;只有空间管理员或具备日志权限的成员能看全量记录,试运行对话记录不能替代审计日志。

扣子平台的 API 调用审计日志不在智能体的试运行对话窗口里查看,而是在对应工作空间下已发布智能体或应用的 API 调用记录中查看,并且需要空间管理员或具备日志查看权限的成员账号。它记录的是外部系统通过 API 调用智能体时的请求元数据,不是普通网页端聊天记录,也不等同于计费账单。 先分清三类记录,才能判断自己打开的是不是审计日志。试运行窗口里的对话调试记录用于调提示词,会话记录用于回看用户对话内容,API 调用审计日志用于追踪谁在什么时间调用了哪个智能体、请求是否成功、耗时和用量。客服排障时,前两类帮助还原对话,第三类才能定位调用链路。 查看入口通常按“工作空间—目标智能体或应用—发布/API—调用日志”的顺序进入,但控制台版本不同,菜单名称可能变化。进入后先确认右上角工作空间和账号没有选错,再选择时间范围、智能体名称、API Key 或调用状态进行筛选。如果页面只显示调试记录,说明当前查看的是开发态,不是已发布 API 的调用审计。 API 调用审计日志至少要能回答五个问题:谁调用、调用了哪个智能体、什么时候调用、结果如何、消耗多少。对应到字段,就是请求时间、调用方标识或 API Key、智能体或应用 ID、接口名称、状态码、耗时、用量和请求 ID。客服投诉排查时,先用请求 ID 或会话 ID 找到单次调用,再按时间窗口看同一调用方是否连续失败。 权限边界决定审计日志能不能作为管理依据。空间所有者和管理员通常能查看全量调用记录,普通协作者往往只能看到自己创建或授权范围内的智能体。把日志权限交给客服一线之前,应先做角色划分:排障人员看元数据,合规人员按审批看必要内容,开发和运营不要共用管理员账号。 按 API Key 拆分调用方,是让审计日志可读的前提。给每个外部系统、每个环境分别创建独立 API Key,并用可识别的名称标注业务线、环境和负责人,不要多个客服系统共用一个 Key。这样日志里出现异常峰值或 4xx、5xx 状态时,才能直接定位到具体接入方,而不是只看到一条无法归属的调用记录。 审计日志和计费数据不是同一张表,核对时要留出时间差。调用日志反映请求发生的时间与结果,用量账单通常按平台结算周期汇总,二者在延迟、重试和失败请求的统计口径上可能不同。财务对账应以账单为准,审计日志用于解释差异:哪些请求失败仍产生消耗,哪些重试造成重复调用,哪些调用来自测试环境。 在线查询窗口有限,客服和合规场景要建立定期导出机制。控制台保留期以当前版本和空间配置为准,不能假设一年前的调用记录随时可查。建议按天或按周导出调用日志到企业日志系统,导出前对 API Key、用户标识、对话内容做脱敏,只保留排障和审计必需字段。 看不到 API 调用日志时,按顺序排查五件事。先确认智能体是否已经发布并开通 API 调用,而不是只在预览页试运行;再确认账号是否在正确的工作空间、是否具备日志权限;然后检查时间范围和筛选条件;最后看调用是否真正到达平台,以及日志是否有延迟。如果外部系统收到 401 或 403,日志侧也可能没有业务调用记录,需要先解决鉴权和发布状态。 网页、飞书、微信等渠道的对话记录,不一定会进入 API 调用审计日志。审计日志只覆盖通过 API 发起的调用;渠道侧产生的会话要在对应渠道后台或会话记录里查。做客服质检时,应把渠道会话 ID 与 API 请求 ID 关联起来,否则只能看到平台侧元数据,无法还原完整服务过程。 把审计日志用于客服经营,重点不是“留档”,而是形成可执行的告警。可以按智能体维度观察失败率、平均耗时和调用量突增,按 API Key 维度观察异常来源,按请求 ID 追踪单次投诉。告警规则应围绕业务阈值设置,例如连续失败、响应超时、调用量异常波动,而不是把所有 4xx 都当成系统故障。 合规上,API 调用审计日志属于可能包含个人信息和接入凭证的敏感记录。访问应遵循最小权限和审批留痕,日志中不展示完整 API Key,对话内容与元数据分开授权查看,导出文件设置有效期和下载审计。对客服务团队只保留排障所需字段,能定位问题即可,避免把完整对话长期散落在个人电脑。