SuperAPI AI 工具集

neon-functions

数据与分析

查看项目

更新于 10-16 09:29

技能介绍

用途:Neon Functions 用于在 Neon 分支上部署长时间运行的 Node.js HTTP 处理函数,适合需要保持存活并靠近数据的请求/响应工作负载,例如多次 LLM 调用与工具调用的智能体、图像/视频生成、WebSocket 服务器、SSE 端点、Webhook 与机器人等。

主要能力:函数为 Web 标准处理程序,默认导出带 fetch(request) 方法并返回 Response,兼容 Hono 等框架,运行于 Node.js 24;每个函数获得公开 HTTPS URL,与分支数据库同区域运行,分支有 Postgres 时自动注入 DATABASE_URL;函数随分支隔离,每个分支运行自己的版本与 URL;空闲时可缩容至零。

使用方式:在 neon.ts 的 preview.functions 下按 slug 声明函数,指定 name 与 source;本地用 neon dev 热重载并注入环境变量,用 neon deploy 打包上传并应用配置;也可用 neon functions deploy <slug> --path . --entry src/index.ts 单独部署,用 neon functions get <slug> 获取调用 URL,用 list|get|delete 管理。环境变量由 Neon 注入,包括 NEON_BRANCH、DATABASE_URL、DATABASE_URL_UNPOOLED,以及启用相应服务时的 NEON_AUTH_BASE_URL、NEON_DATA_API_URL 等;自定义密钥通过 --env KEY=VALUE 或 neon.ts 的 env 声明。连接 Postgres 建议在模块作用域创建 pg 连接池并复用,max 保持较小(如 5)。

适用场景:需要长连接或长时运行的智能体后端、WebSocket/SSE 服务、靠近 Postgres 的计算、随数据分支的后端、Webhook 与响应后处理。

限制:该功能为预览版,目前仅在美国东部 2(us-east-2)区域可用;处理程序需在 15 分钟内开始响应,流在字节持续流动时保持存活;不适合纯静态站点、需要独立生命周期与取消的定时/后台任务,或必须运行在 us-east-2 之外的工作负载。函数应像独立 REST API 一样自行校验 JWT 或 API 密钥。资料未提供收费与价格信息。