Cherry Studio
文档

调用链与开发者模式

调用链用于查看一次对话或 Agent 任务内部发生的模型请求、工具调用和 MCP 交互。它适合排错和性能分析,不是日常聊天必须开启的功能。

从运行环境、认证网络到 Agent 绑定和调用链的 MCP 排错流程图

排查 MCP 调用时先确认服务器和认证,再用调用链判断请求是否进入 Agent 与工具执行阶段。

开启方式

1. 打开【设置】→【通用】

在【开发者模式】区域开启【启用开发者模式】。

2. 重启 Cherry Studio

开发者模式在重启后生效。重启前正在运行的 Agent 任务应先确认状态。

3. 复现一次问题

重新发送最小测试消息,只保留必要模型和工具,减少无关调用。

4. 打开调用链

在对话或 Agent 右侧面板进入【调用链】,选择节点查看输入、输出、耗时和状态。Agent 任务还能看到 Agent 名称、操作和工具调用数量。

常见节点怎么读

节点重点检查常见问题
模型请求模型、输入、输出、Token 和状态服务商错误、上下文过长、输出为空
工具调用工具名、参数、结果参数错误、权限等待、工具返回异常
MCP 调用服务名、连接类型、输入与输出服务器断开、认证失败、远程错误
Agent 执行Agent、操作、工具数量和状态子任务失败、流程没有结束
HTTP 请求方法、URL、状态和响应地址错误、网络或鉴权问题

用户案例:MCP 工具返回空结果

先在 MCP 设置页确认服务器正常,再让 Agent 只调用一个工具。调用链显示请求已到达服务器但输出为空,说明问题更可能在服务端数据或参数,而不是 Agent 没有绑定;若根本没有 MCP 节点,则回到 Agent【MCP】检查绑定。

为什么开启后仍看不到调用链?

确认已经重启应用,并在重启后重新发起一次请求。启用前产生的历史消息不会自动补齐调用数据。

为什么开启后仍看不到调用链?

确认已经重启应用,并在重启后重新发起一次请求。启用前产生的历史消息不会自动补齐调用数据。

本页内容