智能体 / 循环与工作区
循环与工作区
平台的智能体循环跑在浏览器,不在服务端。这样模型调用、工具执行和文件读写都不占用服务器线程。
一次运行
用户输入
→ 模型返回 tool_calls
→ 内置工具 / MCP tools/call
→ 结果回填
→ 再请求模型
→ 得到最终回答
循环由 agent/public/agent.js 执行,源码在 agent/src/agent.js,用 esbuild 打包:
esbuild src/agent.js --bundle --format=esm --platform=browser --minify --outfile=public/agent.js
两套工作区
| 环境 | 实现 | 位置 |
|---|---|---|
| 浏览器 | IndexedDB | nb-workspace / files |
| Tauri 桌面 | 本地目录 | exe 旁 nb-ai-data/workspace |
工具层只依赖统一适配器,不判断环境:
setProject(name)/projects()read(path)/write(path, content)/list(dir)/remove(path)readIn(project, path)/listIn(project, dir)
路径只允许工作区内的相对路径,拒绝 . 和 ..。
为什么不在服务端跑
- 服务端沙箱没有浏览器文件系统,也没有 Tauri IPC。
- 前端循环可以同时支持 H5 和桌面,不需要两套后端。
- 部署、域名、数据库交给 MCP,服务端不执行智能体代码。
限制
- 关闭页面即中断循环。
- 浏览器数据只在该浏览器,桌面数据只在本机,二者不自动同步。
- 部署只上传当前项目的
/app.js,其他文件留在本地。