扣子

扣子扣子编程扣子罗盘资源

文档反馈

低代码项目

快速开始

智能体

工作流

应用

资源

发布

了解项目发布

发布智能体

发布应用

发布到公共渠道

发布管理

数据分析

渠道入驻

模型

多人协作

开发工具

推广与变现

常见问题

消息日志

更新于: 2026-06-24 15:44:40

在智能体、应用或工作流中，每条消息回复都会生成一条消息日志，这个消息日志详细记录了其回复问题的编排步骤和详细过程。消息日志帮助你了解低代码智能体、应用或工作流的推理过程，以便你进行针对性的分析和优化。

功能说明

日志页面主要展示低代码智能体、应用和工作流的消息日志，单击日志可查看全流程处理链路。
消息日志功能通常用于以下场景：

日志分析：查看的详细消息日志，即 trace 数据。
故障排查：在扣子编程中，一个对话请求通常会经由多个环节处理，例如调用 LLM 节点回复问题。消息日志功能提供智能体调用技能的输入、查询的知识库等信息，你可以识别智能体出现异常或不符合预期行为的步骤。

费用说明

Trace 日志的费用根据上报的日志存储量和存储时长计算。系统会自行在一段时间内上报一次 Trace，并在上报时一次性收取费用。更多信息，请参考Trace 日志费用（即将收费）。

注意

自2026年7月1日起，扣子将对你上报的 Trace 日志收取相应费用。

使用限制

不同扣子套餐支持的消息日志相关权益如下表。

功能	个人免费版	个人进阶版	个人高阶版	个人旗舰版	个人尊享版	团队高阶版	团队旗舰版	团队尊享版	企业标准版	企业旗舰版
消息日志存储最长天数	3天	7天	7 天	7 天	7 天	7 天	7 天	7 天	90天	180天
消息导出	不支持	每个智能体单次最多可导出 5000 条消息记录。

消息日志的使用限制如下表所示。

限制类	限制说明
权限	空间成员仅能查看你作为所有者或协作者的应用、智能体和工作流的消息日志。添加智能体协作者的操作可参考协同管理低代码智能体。空间所有者和管理员支持查看所有应用、智能体和工作流的消息日志。
记录范围	渠道：暂不支持豆包的智能体消息日志。内容：消息日志页面暂不支持展示多模态用户输入，例如语音、图片、文件等类型的消息。
延时	消息在各个渠道中的延时不同，部分渠道可能长达数分钟，对话后建议间隔一段时间再查看消息。
数据准确性	日志页面显示的用户输入 Token、模型输出 Token仅用于参考。企业标准版、企业旗舰版和旧版付费套餐用户实际使用的 Token 数量可查看火山引擎账单。

查看消息日志

借助分析看板，你能够全面跟踪和分析已发布的低代码智能体、应用和工作流的运行状况，包括 Token 消耗、积分消耗、用户数、对话数等基础运营数据、用户参与度、性能评估以及渠道运营洞察等，帮助你优化用户体验、提升运营效率、解决技术问题。

登录扣子编程。
在左下角单击个人头像，选择企业账号，然后单击对应组织的设置图标。
在组织管理页面的顶部选择空间管理，然后单击目标工作空间对应的设置。
在顶部选择发布管理页签。
单击对应的低代码智能体、应用或工作流，在日志页面，在顶部选择时间段，查看对话记录。

查看消息列表

页面默认展示过去 3 天内的消息列表。列表标题行各字段说明如下：

说明

对于 API 渠道，会话、消息和用户 ID 均由 API 的调用方自定义设置，对话状态也取决于发起对话 API 的执行状态。

字段	说明	筛选示例
状态	本次对话的状态。如果智能体由于系统限流或其他技术因素未能提供有效回复，或者对话中触发的工作流中任意节点运行异常，则视为对话状态异常。	支持根据对话状态筛选消息。
消息 ID	用户向智能体发送的消息的 ID。	支持根据对话 ID 筛选消息。
会话 ID	会话 ID 即 Conversation ID，是会话的唯一标识。会话是用户和智能体之间围绕某个主题的一段问答交互。一个会话包含一条或多条消息。	支持根据会话 ID 筛选消息。
用户 ID	和智能体对话的用户 ID。用户 ID 的类型取决于对话发生的渠道。智能体商店&调试区：扣子用户的 UID。查看 UID 的方式可参考查看 UID。 API&SDK：调用发起对话 API 时设置的 user_id 参数。飞书等第三方渠道：展示第三方渠道中的用户 ID。详细说明可参考消息列表中的用户 IDUser ID是什么？	支持根据用户 ID 筛选消息。
用户输入	对话中用户输入的消息内容。	支持根据关键词筛选消息。
输出	智能体或工作流的输出内容。	支持根据关键词筛选消息。
模型输入 Token	用户输入内容的 Token 长度，估算值，仅用于参考。	不支持筛选
模型输出 Token	模型输出内容的 Token 长度，估算值，仅用于参考。	不支持筛选
请求发起时间	请求的发起时间。	不支持筛选。
整体耗时	对话的总时长，单位为毫秒（ms）。从用户发起请求开始计算，到智能体最终回复完成为止。	支持根据整体耗时筛选消息。
首次响应耗时	智能体首次响应的处理耗时，单位为毫秒（ms）。从用户发起请求开始计算，到智能体或工作流返回第一个 Token 为止。如果希望工作流尽早返回首个 Token，可配置输出节点。	支持根据首次响应耗时筛选消息。
渠道	用户和智能体的对话发生的渠道。在日志页面不支持查看豆包渠道的智能体消息日志。	支持筛选指定渠道的消息列表。只能筛选并查看智能体发布过的渠道。

在消息列表中，你可以执行以下操作：

操作	说明
隐藏或显示指定列	列表中默认展示请求状态、名称、输入等部分信息，你也可以在页面右上角自定义设置展示哪些列。
刷新	单击刷新图标，即可刷新当前页签。
根据时间段筛选	支持根据以下方式指定时间：指定时区：选择时区进行筛选，例如选择 `UTC-12:00`。指定相对时间：例如过去 1 天、过去 3 天、过去 7 天等。自定义时间范围：单击 Custom，设置开始时间与结束时间。
下载	在日志页面右上角单击下载图标，即可将筛选后的消息导出到 `.csv` 文件中，并保存到本地。

查看数据统计

页面右侧的统计区域展示筛选范围内消息日志的相关统计数据，包括：

字段	说明
消息数	筛选范围内的消息总数。
错误率	筛选范围内，错误消息数量在所有消息中的占比。
整体耗时	筛选范围内所有消息的平均整体耗时。
首次响应耗时	筛选范围内所有消息平均首次响应耗时。

查看消息请求全链路

在日志页面的消息列表中单击指定消息，即可查看此消息的详细请求链路。调用树下选择具体节点，可查看：

节点详情：指定节点的详细信息，包括节点类型、状态、整体耗时等信息。
输入和输出：指定节点的输入和输出信息，JSON 格式展示扣子编程在此节点发起请求时的完整输入信息、完整输出信息。
链路拓扑：扣子编程在此节点的请求拓扑，对于工作流等节点，拓扑中会展示本次工作流的完整执行链路，你可以在此查看执行的节点名称与顺序。在左侧调用树中也可以单击工作流子节点名称右侧的图标，跳转到工作流试运行页面，查看本次请求的工作流运行过程与结果。

关于消息请求的全链路信息详细说明，可参考预览与调试。

管理 Trace 上报

关闭 Trace 上报

Trace 日志上报开关默认开启，工作空间所有者或者管理员可以按需关闭。关闭后，当前工作空间内所有成员的 Trace 数据将停止上报，历史数据不受影响。

在空间管理的发布管理页签下，单击对应的低代码智能体、应用或工作流。
在日志页面的右上角，单击成员 Trace 设置。
关闭允许全部成员上报 Trace 开关。

设置 Trace 存储时长

Trace 存储时长默认为当前订阅套餐支持的最大默认时长，例如企业旗舰版为 180 天。工作空间所有者或者管理员可以修改其存储时长。设置后，当前工作空间内所有 Trace 数据的存储时长均以此为准。

在空间管理的发布管理页签下，单击对应的低代码智能体、应用或工作流。
在日志页面的右上角，单击成员 Trace 设置。
设置Trace最大存储时长。

常见问题

扣子的消息最多保存多久？

仅智能体的所有者和协作者才能访问消息页面，不同扣子套餐支持的消息日志存储天数不一样，具体如下表所示。

功能	个人免费版	个人进阶版	个人高阶版	个人旗舰版	个人尊享版	团队高阶版	团队旗舰版	团队尊享版	企业标准版	企业旗舰版
消息日志存储最长天数	3天	7天	7 天	7 天	7 天	7 天	7 天	7 天	90天	180天

升级套餐后，消息保存天数如何生效？

升级套餐后，新的消息保存天数规则将从升级当天开始计算，不会追溯之前的消息保存天数。例如，你当前是个人免费版，消息仅能保存 3 天。如果 5 月 1 日订阅了个人进阶版，此时你仍然只能查看 4 月 28 日~ 4 月30 日这三天的消息。但从 5 月 1 日开始，消息保存天数变更为 7 天，到了 5 月 7 日，你就能看到 5 月 1 日~5 月 7 日的消息。

可以导出消息吗？

扣子付费套餐支持导出消息，个人免费版不支持导出消息。在日志页面右上角单击下载图标，即可将筛选后的消息导出到 .csv 格式的 Excel 文件中，并保存到本地。

消息列表中的用户 ID是什么？

消息列表中的用户 ID是和智能体对话的用户 ID。用户 ID 的类型取决于对话发生的渠道。详细说明如下：

渠道	用户 ID 示例	说明
智能体商店&调试区	737618761376343****	扣子用户的 UID。查看 UID 的方式可参考查看 UID。
API&SDK	12345****	调用发起对话 API 时设置的 user_id 参数。
飞书	736588c9260f**#93f8**	飞书的租户 Key 及 OpenID，格式为 `TenantKey#open_id`。
抖音	_000qxLv3hSueysm05WV925wziQRlFfx****	用户在 Coze 应用上的 open_id。抖音渠道包括抖音小程序、抖音企业号。
微信服务号、微信订阅号	gh_63a996234fa3_o0A3K6cqH**-2-cC_0jZrS**	微信 origin_id 和 user_id的拼接，格式为 `{{originalID}}_{{userID}}`。微信渠道包括微信客服、微信小程序、微信服务号、微信订阅号。
微信客服	wmpyqxdwaacyi1zouwwpjrppgrcr****	external_userid
微信小程序	ouao3618yko28my12carsrho****	微信小程序用户的 openid。