用途:Code Mode 让 LLM 在受控沙箱内生成并执行 TypeScript,通过调用宿主提供的工具完成复杂任务,必须建立在 chat 体验之上(需熟悉 ai-core 与 ai-core/chat-experience)。
主要能力:核心 API 为 createCodeModeTool(),可搭配四种可互换的隔离驱动(IsolateDriver 接口):createNodeIsolateDriver(V8 JIT,最快,需 isolated-vm 原生 C++ 插件)、createQuickJSIsolateDriver(WASM,无原生依赖,可运行于浏览器、Deno、Bun、边缘运行时,但较慢且 stdlib 有限,无文件 I/O)、createQuickJSBunIsolateDriver(Bun 原生 QuickJS,需 Bun>=1.3.14)、createCloudflareIsolateDriver(通过部署的 Worker 在边缘执行,需 workerUrl)。推荐更高级入口 createCodeMode(),返回 tool、systemPrompt、tools、discoveryTool,并在系统提示中生成各工具的 TypeScript 类型桩。
代码片段:codeModeWithSnippets() 让 LLM 保存可复用片段,未来请求中作为可调用工具。信任策略含 createDefaultTrustStrategy、createRelaxedTrustStrategy、createAlwaysTrustedStrategy、createCustomTrustStrategy;存储可选 createFileSnippetStorage(生产)或 createMemorySnippetStorage(测试)。
进度展示:沙箱执行会发出自定义事件(execution_started、console、external_call、external_result、external_error、snippet_call 等),在 useChat 的 onCustomEvent 中处理,React/Solid/Vue/Svelte 集成签名一致。
惰性工具:给低频工具标记 lazy:true,可避免系统提示膨胀,改用 discover_tools 发现;lazyToolsConfig.includeDescription 控制目录显示程度。
限制与注意:绝不能把 API 密钥、数据库凭据或令牌传入沙箱,生成的代码可能借助工具调用外泄,密钥应保留在宿主工具实现中。资料未提供收费、价格或更多平台信息。