消息数据编辑器 (高级)
消息数据编辑器是一个面向高级用户的调试工具,允许你直接查看并修改消息在数据库中的原始 JSON 结构。
1. 进入编辑器
- 将鼠标悬停在消息上。
- 点击更多菜单 (
···)。 - 选择 🗄️ 数据编辑 (高级)。
2. 核心编辑区域
编辑器提供了一个全功能的代码编辑器(基于 CodeMirror 或 Monaco),加载了该消息的原始数据:
- Role (角色):
system,user,assistant,tool等。 - Content (内容): 消息的文本原文。
- Metadata (元数据):
tokens: 预估的 Token 数。model: 生成该消息的模型 ID。sessionVariableSnapshot: 该时刻的会话变量快照。toolCalls: 如果是工具调用消息,包含具体的函数名和参数。attachments: 关联的附件列表。
3. 使用场景
3.1 修复损坏的数据
如果你在导入第三方角色卡或会话时发现某些消息渲染异常,可以通过数据编辑器手动修正元数据或角色定义。
3.2 模拟特定的上下文状态
通过手动修改 sessionVariableSnapshot,你可以强制改变会话变量的值,从而测试 Agent 在不同变量状态下的反应,而无需重新进行多轮对话。
3.3 深度调试工具调用
你可以直接查看 toolCalls 的原始参数和 tool 角色的原始返回结果,这对于排查工具调用逻辑错误非常有用。
4. 注意事项
**数据风险**
直接编辑原始数据具有一定风险。不合法的 JSON 格式或错误的字段定义可能导致消息无法渲染或应用崩溃。在保存修改前,请务必确认数据的完整性。