# 预览与调试 (https://mosoo.ai/docs/zh-Hans/test-and-debug/)



使用 Agent workspace 在 Preview Session 中测试可选的 Agent 预设。

## 预览 [#预览]

在左侧输入具有代表性的任务，至少测试：

* 正常请求和预期输出；
* 每个已绑定 Skill 或 MCP server 的调用；
* 文件输入和生成 artifacts；
* 信息不足时的追问行为；
* tool、credential 或 Environment 的失败路径。

保存后的预设修改用于新 Session。测试新配置时请新建 Preview。Cloud 调试 Preview 可能在 30 天没有消息、Run 或文件活动后被清理，登录控制台和读取历史不会续期。正式 API Session 不采用这项到期规则。

## 日志 [#日志]

打开 **Logs** 检查 session 与执行历史，用于关联 runtime startup、tool use 和 failure。日志不应包含 secret；如果用户输入中带有 raw credential，请在分享 diagnostics 前移除。

## 成本 [#成本]

打开 **Cost** 查看 Agent 级用量估算、model mix 和最近 usage event。Production 与 Debug 可分开过滤。Cost 是模型调用估算，不是 Provider invoice。

## Session 维护 [#session-维护]

维护操作只针对选中的 Session。重启 Driver 或重建沙箱会保留已提交的工作区与原生续接状态，其他 Session 不会继承它。无关工作应新建 Session；检查点失败或未提交时，需先解决该问题再继续执行或维护。

## 常见问题定位 [#常见问题定位]

1. **Runtime needs a key**：在当前 Project 配置匹配的 Provider。
2. **Model unavailable**：检查 Provider model list 与 endpoint compatibility。
3. **MCP tool failed**：确认连接已启用并授权，再直接测试工具任务。
4. **Environment startup failed**：检查精确 package version、setup script 和必需 variables。
5. **保存的修改没有出现在已有 Session 中**：Session 创建时会固定配置。测试修改后的配置请新建 Preview。