NB文档doc.nbjs.ai
智能体 / 循环与工作区

循环与工作区

平台的智能体循环跑在浏览器,不在服务端。这样模型调用、工具执行和文件读写都不占用服务器线程。

一次运行

用户输入
  → 模型返回 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

两套工作区

环境实现位置
浏览器IndexedDBnb-workspace / files
Tauri 桌面本地目录exe 旁 nb-ai-data/workspace

工具层只依赖统一适配器,不判断环境:

路径只允许工作区内的相对路径,拒绝 . 和 ..。

为什么不在服务端跑

限制