用途:在 iblai-vibe 项目中为智能体设置 LLM 消费上限,控制智能体自身及其用户的支出,并查看已用金额与百分比。
主要能力:提供「本智能体」与「按用户」两个子标签,分别对应智能体自身单例上限和显式的(用户、智能体)上限。每个限额包含启用开关、用量条(显示已花/已用百分比/剩余,超限变红)、消费金额、重置周期(日/周/月/年)、执行模式(阻断请求或仅告警)以及逗号分隔的告警阈值。按用户子标签以表格列出用户、限额与状态,并支持通过平台用户搜索新增限额。执行在服务端完成:被阻断的请求返回 429 与 spend_cap_exceeded 错误,直到周期重置。
使用方式:需先完成认证并配置 MCP 服务器与技能,路由须由 AgentSettingsProvider 包裹,并需向用户索取真实的 mentorId(智能体 UUID)。基础挂载从 @iblai/iblai-js/web-containers/next 引入 AgentSpendCapsTab,无需必填属性;可通过 labels 自定义文案。环境检查需项目根目录存在含 PLATFORM、DOMAIN、TOKEN 的 iblai.env。验证可运行 pnpm build、pnpm test 并启动开发服务器截图。REST 端点为 ${dmUrl}/api/ai-mentor/orgs/{org}/ 下的 agents/{mentor_unique_id}/spend-cap/ 等,使用 Authorization: Token <token>。
适用场景与限制:适用于需要限制智能体或特定用户 LLM 支出的管理界面。限额端点为 RBAC 管控,无权限用户会看到 403 无权限面板。计数字段为只读、由服务端对账;PUT 为 upsert,首次保存创建记录,首次运行 404 属正常。共三种范围(组织、智能体、按用户),最严格者生效,本标签页只管理两个智能体级范围,工作区级限额在组织设置的计费界面管理。用户名键、邮箱显示:按用户上限以用户名为键但界面统一显示邮箱。需安装 sonner 与 @iblai/iblai-web-mentor 等对等依赖。