SuperAPI AI 工具集

firebase-vertex-ai

部署与运维

查看项目

更新于 10-16 06:20

技能介绍

用途:设计、实现并部署调用 Vertex AI/Gemini 的 Firebase 应用,从 Cloud Functions 或其他 GCP 服务发起 AI 调用,并处理密钥、权限与可观测性。

主要能力:初始化或校验 Firebase 仓库(Hosting/Functions/Firestore);添加调用 Gemini/Vertex AI 的 Cloud Function 或 HTTP 端点并校验输入、返回结构化响应;配置 Firestore 规则与索引、Storage 规则、Auth 提供方与授权检查;部署 Functions/Hosting 并对已部署端点做冒烟测试;加入日志/指标、错误激增告警与预算/配额等成本控制。

使用方式:需 Node.js 运行时与目标项目的 Firebase CLI 访问权限;需 Firebase 项目(Functions/Vertex AI 按需启用计费);启用 Vertex AI API 并具备从后端调用 Gemini/Vertex AI 的权限;密钥通过环境变量或 Secret Manager 管理,不得写入客户端代码。输出包括可部署的项目结构、安全的后端调用代码、Firestore/Storage 规则与索引指引、本地与部署后的验证清单及 CI 就绪命令。

适用场景:Gemini 驱动的聊天 API、基于 Firestore 的 RAG 流程(文档嵌入与带引用回答)等。

限制与错误处理:认证失败需定位主体与缺失权限/角色,按最小权限修复;计费/API 问题需识别阻塞的 API 或配额并给出补救步骤;Firestore 规则/索引问题需提供最小复现查询与规则修复;Vertex AI 调用失败需暴露模型/区域不匹配,并对瞬时错误加重试与退避。完整指南见 ${CLAUDE_SKILL_DIR}/references/SKILL.full.md,另可参考 Firebase 文档 https://firebase.google.com/docs、Cloud Functions 文档 https://firebase.google.com/docs/functions、Vertex AI 文档 https://cloud.google.com/vertex-ai/docs。