SuperAPI AI 工具集

ai-web-apps

前端与建站

查看项目

更新于 10-16 08:03

技能介绍

用途:在 Next.js + Vercel AI SDK 上设计或构建 AI 增强型 Web 应用,适用于流式对话、工具调用、RAG、多模态输入或 MCP 工具暴露;也用于把 AI 功能接入多租户 SaaS,或审查已有 AI 路由是否缺少预算、配额、护栏与回退控制。纯后端或批处理场景、纯 UX 模式问题、计量计费策略、提示词或威胁设计应改用其他技能。

主要能力:产出四类正式交付物——模块门控契约、令牌账本与预算 schema、供应商抽象契约(工厂、回退、请求 schema)、输出校验与护栏规则;另含流式与 UI 实现说明、MCP 服务端/客户端契约。强调架构先行:先决策表再写代码。

使用方式:先加载上下文地图、关键流程表、访问模式列表、威胁模型、鉴权矩阵等上游产物。路由顺序为 moduleGate -> quotaGate -> budgetGuard -> factory -> streamText -> guardrails -> ledgerWrite。所有模型访问经统一工厂,功能代码不直接导入供应商 SDK。初始化命令:npm install ai @ai-sdk/openai @ai-sdk/google @ai-sdk/anthropic ai-fallback zod,可选 npm install @modelcontextprotocol/sdk 与 npm install lru-cache。生产限流基于 Redis。

限制与硬性要求:AI 功能默认关闭,需租户、用户、预算三重门控;每次模型调用须在响应到达用户前写入账本行;每次调用设置 maxTokens;结构化输出用 Zod 校验,渲染输出做 Markdown 净化,禁用 dangerouslySetInnerHTML;回退仅在 429、5xx 等瞬时错误触发;密钥不得进入浏览器。三个护栏层(结构、语义、渲染)均需执行。具体参考文档路径与模型选择细节见原文资料,此处未逐一展开。