SuperAPI AI 工具集

ai-entitlements-and-feature-gating

设计与创作

查看项目

更新于 10-16 03:40

技能介绍

用途:设计 AI 功能如何按套餐层级解锁,例如 Free 用蒸馏模型加每日生成上限,Pro 用旗舰模型加工具,Enterprise 用自定义模型、智能体与知识库;也用于新增 AI 功能时决定哪些层级可见,以及让销售在不改代码的情况下为单个租户开通功能。

主要能力:定义网关检查的 AI 权益键,如 ai.feature.<feature_id>.enabled、ai.model_tier、ai.context_max_tokens、ai.max_output_tokens、ai.generations_per_day、ai.tokens_per_month、ai.tools.enabled、ai.tools.allowed、ai.kb.max_pages、ai.agent.max_steps、ai.agent.concurrent_sessions、ai.region、ai.fine_tune.enabled、ai.byok.enabled;给出套餐×权益矩阵;在网关于调用模型前解析权益并拦截;设计升级 UX;实现带原因、操作人与过期时间的按租户覆盖;并列出智能体专属权益键与执行点。

使用方式:先读取 SKILL.md,定义权益键,映射套餐矩阵,在网关实现强制校验,设计升级引导,实现按租户覆盖,并规避反模式。网关伪代码示例:def enforce_entitlements(ctx): e = ctx.entitlements;被拦截时返回结构化错误,含 code、key、current_plan、required_plan、upgrade_url。按租户覆盖表 tenant_ai_entitlement_override 含 tenant_id、key、value、reason、actor_user_id、expires_at、created_at。

适用场景:SaaS 产品中 AI 功能的套餐分层、销售临时开通、试用升级、智能体预算与并发控制。

限制:不适用于平台级权益引擎本身(见 saas-entitlements-and-plan-gating)、AI 用量计费(ai-usage-metering-and-billing)或内部成本归因(ai-cost-per-tenant-attribution)。具体价格、平台与效果资料暂未提供。