SuperAPI AI 工具集

setup-python-tools

编程与开发

查看项目

更新于 10-15 20:13

技能介绍

用途:为已通过 integrate-atlas-chat 接入 useAtlasChat 的应用,增加浏览器端 Pyodide Python 工具执行能力。若应用使用 Atlas / EOS 侧边栏(integrate-fusion-agent),则跳过本步骤。

前提:已存在 src/atlas-agent/(来自 integrate-atlas-chat),并已安装 @sinclair/typebox。将 integrate-atlas-chat/code/ 中的 python.ts、pyodide.ts、pyodide-react.ts、pyodide-runtime.ts 复制到 src/atlas-agent/。

主要能力:CDF 的 runPythonCode 工具以 toolConfirmation + clientTool 形式到达;接入 usePyodideRuntime 并把 pythonRuntime 传给 useAtlasChat 即可,无需 PythonToolConfig 条目。代理调用 Python 工具时,库会自动从代理配置获取代码、在浏览器中运行并返回结果。Pyodide 约 30MB,首次加载后会被缓存。

使用方式:先阅读 package.json 与调用 useAtlasChat 的组件,确认包管理器与现有依赖。用应用的包管理器安装指定版本:pnpm add pyodide@0.29.3、npm install pyodide@0.29.3 或 yarn add pyodide@0.29.3;该版本必须与运行时加载的 CDN 产物一致,否则会报错。在调用 useAtlasChat 的组件中引入 loadPyodide 与 usePyodideRuntime,调用该 hook 并传入 loadPyodide、client(加载中传 null)以及可选的 requirements(如 pandas、numpy)。hook 返回 runtime、loading、error、progress、isReady。把 pythonRuntime 传入 useAtlasChat 即可启用 Python 工具执行;Python 工具不通过 tools 声明,代理已从 CDF 配置中获知。加载指示器应放在聊天输入框上方而非消息列表中,保持紧凑,显示阶段文本与百分比,错误单独显示徽章。首次加载约 30-60 秒,后续从浏览器缓存加载小于 2 秒。Python 加载期间应禁用整个输入区域(而非仅发送按钮),首页建议芯片也应一并禁用。

限制:需先完成 integrate-atlas-chat 并具备 @sinclair/typebox;Pyodide 版本必须严格为 0.29.3;首次加载体积与耗时较大。其余细节资料未提供。