neon-ai-gateway-neondatabase-agent-skills

1. 基本信息

项目	内容	数据来源
名称	neon-ai-gateway-neondatabase-agent-skills	GitHub API
作者/维护者	Neon（Databricks 旗下）	GitHub API + 官方文档
来源链接	https://github.com/neondatabase/agent-skills/tree/main/skills/neon-ai-gateway	—
许可证	Apache-2.0	GitHub API
GitHub Stars	82（整个 agent-skills 合集仓库口径，不代表本 skill 自身热度）	GitHub API
本 skill 独立安装量	594 次	skills.sh（第三方技能市场，独立统计）
Forks	12（合集口径）	GitHub API
最新版本	1.0.0（合集整体版本号）	package.json
安装方式	`npx skills add neondatabase/agent-skills --skill neon-ai-gateway`	官方 SKILL.md

2. 功能介绍与亮点

Neon AI Gateway 是内置在 Neon Postgres 分支里的 LLM 推理层：用一个 Neon 凭据、一个统一 API 端点即可调用 Anthropic、OpenAI、Google、Meta、阿里、DeepSeek 等多家厂商的模型，现有的 OpenAI SDK / Anthropic SDK / google-genai / Vercel AI SDK / Mastra 代码只需把 base URL 换成网关地址即可直接工作，无需为每家模型厂商单独注册账号和管理密钥。

主要亮点：

随数据库分支自动隔离：每个 Neon 分支拥有独立的网关地址与凭据，预览分支、CI 分支、生产分支的 AI 调用彼此隔离，与数据本身的分支隔离机制一致
一个凭据打通七家模型厂商，且不需要额外基础设施——网关运行在 Databricks 承载“每月超 145 万亿 token”规模的同一套基础设施上，随 Neon Functions 自动注入，原生支持流式响应
文档极为详尽：SKILL.md 逐一给出 Vercel AI SDK、Mastra、原生 OpenAI/Anthropic/Gemini SDK 四类接入方式的完整可运行代码示例，并说明如何用 /v1/models 端点在运行时探测当前分支实际可用的模型列表
是 Databricks 以约 10 亿美元收购 Neon 后重点推进的产品方向，在科技媒体（如 TechTarget、Seeking Alpha）与 Hacker News 上均有关于这次收购与 AI 基础设施战略的独立报道

3. 适用场景

所属分类：集成与工作流自动化

适合已经在用 Neon 作为数据库、想给应用或 agent 加上 LLM 调用能力（聊天、AI Agent、模型路由）却不想为 OpenAI、Anthropic、Google 等每家厂商单独开账号、管密钥的初中级开发者；尤其适合需要在预览分支/CI 分支里跑独立且互不影响的 AI 调用配额的团队。

4. 跨 Agent 兼容性

Claude Code：可用——通用安装命令 npx skills add neondatabase/agent-skills --skill neon-ai-gateway 适用；需注意官方 Claude Code 插件市场当前打包的是 neon / neon-postgres / neon-postgres-branches 三个skill，AI Gateway 需用通用 skills CLI 单独安装
Codex：未验证——仓库 AGENTS.md 明确写“面向 Claude Code、Cursor、Copilot 等 AI 编码 agent”，未见到针对 Codex 的专门适配说明
OpenClaw：未验证——未见相关材料
Hermes Agent：未验证——未见相关材料

5. 推荐理由

给 agent 构建的应用加 LLM 能力时，逐家注册模型厂商账号、管理多套密钥是常见的摩擦点；Neon AI Gateway 用一个已有的 Neon 凭据就打通七家主流模型厂商，且随数据库分支自动隔离调用环境,官方文档质量高、维护活跃，是当前唯一提供“数据库分支自带独立 AI 调用配额”这一能力的产品。

6. 评分

维度	分数	说明
受欢迎程度	7	官方 Neon（Databricks 旗下）出品，是 Databricks 约 10 亿美元收购 Neon 后重点推进的产品，在科技媒体与 Hacker News 上有独立报道；本 skill 自身在第三方技能市场 skills.sh 有 594 次可验证独立安装，是同一合集仓库中近一个月提交次数最多（26 次）的子技能，但作为公测期功能、仅限单一区域，整体采用规模仍中等
可用性	8	SKILL.md 文档详尽，覆盖四类主流 SDK/框架的完整示例，一条命令即可安装；最近一次提交在 2026-07-31，维护非常活跃；但目前仅限 `us-east-2` 区域公测、无法在已有项目上开启，且完整模型目录需要付费 Neon 套餐
安全性	9	见下方检查清单

安全检查清单：

shell 命令执行范围：仅涉及官方 Neon CLI（neon deploy / neon config apply / neon env pull），未见越权命令
联网外发：核心功能就是把请求转发给 Anthropic/OpenAI/Google 等模型厂商，这是网关本身的设计目的，转发目标在文档中逐一列明，不存在隐蔽外发
API key/凭据存储：凭据以 NEON_AI_GATEWAY_TOKEN、NEON_AI_GATEWAY_BASE_URL 两个环境变量形式注入，CLI 会写入 .env.local，文档说明清晰
可疑指令：SKILL.md 全文为技术文档与代码示例，未发现 prompt injection 或混淆代码迹象
作者信誉：Neon 为知名 Serverless Postgres 厂商，2025 年被 Databricks 收购，仓库署名与官方文档一致
License：Apache-2.0，明确
最近维护：上次提交在 2026-07-31，是本合集仓库内近期活跃度最高的子技能

7. 跟同类 Skills 相比的优势

产品	定位	与本 skill 的差异
OpenRouter	独立的多模型统一 API 网关服务	需单独注册账号与计费，不与任何数据库绑定；Neon AI Gateway 的差异化在于网关随数据库分支自动隔离，已经在用 Neon 的团队无需额外基础设施即可获得同等的多模型路由能力
Vercel AI Gateway	Vercel 平台内置的多模型路由层，主要面向部署在 Vercel 的应用	同样是“一个凭据、多个模型厂商”的思路，但绑定的是 Vercel 部署环境；Neon AI Gateway 绑定的是数据库分支而非部署平台，适合数据层选择 Neon、部署位置不限于 Vercel 的团队

8. 用户评价

该技能目前在第三方平台尚无具名用户评价。可验证的采用信号是 skills.sh 统计的 594 次独立安装，以及 Databricks 收购 Neon 一事在 Hacker News 上引发的两轮独立技术社区讨论。

9. 其他补充

同一仓库内还打包了 neon-postgres（连接与分支综合最佳实践）、neon-postgres-branches（分支专项）、claimable-postgres（免登录一次性数据库）、neon-functions（无服务器函数）、neon-object-storage（S3 兼容对象存储）等共 8 个关联子 skill，可按需单独安装。安装本 skill 前需先确保父级 neon skill 已就位（SKILL.md 会在未检测到父级 skill 时提示先安装）。

10. 安装使用方式

方式一（推荐）：终端执行 npx skills add neondatabase/agent-skills --skill neon-ai-gateway
方式二：先执行 npx skills add neondatabase/agent-skills 安装整个合集，再按需启用

安装后注意事项：需要一个新建的 Neon 项目（无法在已有项目上开启网关）、区域选在 us-east-2，且账号需在付费 Neon 套餐上才能完成网关的实际配置（免费套餐会被官方 CLI 拦截并提示升级）；随后在 neon.ts 中开启 preview.aiGateway 配置项并执行 neon deploy 完成开通。

11. 注意事项

目前为公测（beta）功能，仅在 us-east-2 区域提供，且不能在已有项目上追加开启,只能新建项目时启用
公测期模型目录可能被裁剪（部分旗舰模型如 Claude Opus、OpenAI Codex 系列初期可能缺失），需要在 Neon 控制台申请访问权限
跨 Agent 兼容性仅确认适用于通用 npx skills add 安装流程；Codex / OpenClaw / Hermes Agent 下的实际可用性未经验证
依赖父级 neon skill 提供的分支与基础配置知识，建议两者一并安装