SuperAPI AI 工具集

tanstack-ai-code-mode

编程与开发

查看项目

更新于 10-16 00:01

技能介绍

用途:在聊天体验之上,让 LLM 生成 TypeScript 代码并在沙箱中执行,替代或补充标准工具调用。需先熟悉 ai-core 与 ai-core/chat-experience。

主要能力:createCodeModeTool() 创建代码模式工具;createCodeMode() 返回 tool、discoveryTool、tools、systemPrompt,系统提示含各工具的 TypeScript 类型桩。三种可互换的 isolate 驱动:createNodeIsolateDriver(V8 JIT,需 isolated-vm 原生插件)、createQuickJSIsolateDriver(WASM,无原生依赖,支持浏览器与边缘运行时)、createCloudflareIsolateDriver(需部署 Worker 与 workerUrl)。codeModeWithSkills() 支持持久化技能,含信任策略与文件/内存存储。懒加载工具用 lazy: true 标记,通过 discover_tools 按需发现。执行过程发出 code_mode:execution_started、console、external_call、external_result、external_error 等事件,可在 useChat 的 onCustomEvent 中处理。

用法:定义 toolDefinition 工具,创建驱动并传入 createCodeModeTool 或 createCodeMode,再在 chat() 中传入 tools 与 systemPrompt。使用懒加载工具时需展开 tools 而非仅 tool。

限制与注意:切勿将 API 密钥或机密传入沙箱,机密应保留在宿主进程的工具实现中;始终设置有限 timeout,默认 30 秒;Node 驱动需检查平台兼容性,勿随意 skipProbe;不同驱动能力不同,QuickJS 无文件 I/O 且为解释执行,Cloudflare 每次工具调用有网络延迟与 maxToolRounds 限制。其余细节暂未提供。