SuperAPI AI 工具集

scaffold-frenchfry-render

编程与开发

查看项目

更新于 10-15 20:28

技能介绍

用途:该技能用于引导式创建一个 Frenchfry 项目,包含用于 Realtime 会话创建的 runtime 代理(@frenchfryai/runtime)、用于语音与工具调用交互的 React 客户端(@frenchfryai/react),以及用于部署的 Render Blueprint(render.yaml)。范围聚焦于工具调用,默认不添加生成式 UI。

主要能力:生成 runtime 与 web 两个应用、安装依赖、写入初始 render.yaml;校验 @frenchfryai/runtime 与 @frenchfryai/react 是否安装;验证应用接线;构建包含 Node web 服务(runtime)与静态 web 服务(React 应用)的 Render 蓝图;执行最终检查。

使用方式:先确认脚手架目标、输出目录名,以及使用内置脚本还是手动修补。首选命令:bash skills/scaffold-frenchfry-render/scripts/scaffold-frenchfry-tool-calling.sh <target-dir>。安装状态用 npm ls @frenchfryai/runtime @frenchfryai/react 确认。runtime 应用需通过 registerRealtimeSessionRoute 暴露 /realtime/session;React 应用需用 useTool 注册至少一个工具,默认避免 useGenUi / VoiceUiOutlet。Render 蓝图从 assets/frenchfry-tool-calling-render.yaml 起步,并参考 references/render-deploy/ 下的文档。

限制与检查:密钥须使用 sync: false,公开配置值使用 value;确认 OPENAI_API_KEY 在 render.yaml 中声明为 sync: false;runtime 绑定 0.0.0.0:$PORT;静态服务将 /* 重写为 /index.html。完成后应产出 runtime 源文件、含工具调用示例的 React 源文件、含两个服务与环境变量的 render.yaml,以及安装依赖所用命令。