用途:在 Next.js 应用中添加智能体 API 标签页,用于管理程序化访问智能体的 API 密钥。该标签页以表格展示已有密钥的名称、创建时间和过期时间,并提供创建与删除操作,属于 agent-settings 系列中的一个标签页,所有标签页共用同一个 AgentSettingsProvider 包装器。
主要能力:挂载 AgentApiTab 组件;通过 labels 属性覆盖用户可见文案(如标题);相关导出包括 AGENT_API_TAB_LABELS 和 ApiTabLabels 类型。
使用方式:前置条件为已配置认证(/iblai-auth)、已设置 MCP 与技能(iblai add mcp)、路由已被 AgentSettingsProvider 包装,并向用户询问真实的 mentorId(智能体 UUID),不可自行编造。运行 iblai 命令前先检查 CLI 版本并升级:pip install --upgrade iblai-app-cli 或 npm install -g @iblai/cli@latest。项目根目录需有 iblai.env,包含 PLATFORM、DOMAIN、TOKEN;若缺失可下载模板:curl -o iblai.env https://raw.githubusercontent.com/iblai/vibe/refs/heads/main/iblai.env。在 app/(app)/agents/[mentorId]/api/page.tsx 中从 @iblai/iblai-js/web-containers/next 导入并渲染 AgentApiTab。完成后必须运行 /iblai-test,再启动开发服务器 pnpm dev,在 http://localhost:3000 查看结果。默认使用 pnpm,未安装时回退 npm。
限制与注意:不要为 ibl.ai SDK 组件添加自定义样式、颜色或 CSS 覆盖,保持组件原样;除非用户明确要求,否则不要实现深色模式。自定义 UI 时遵循 ibl.ai 品牌规范(主色 #0058cc,渐变 linear-gradient(135deg, #00b0ef, #0058cc),按钮 bg-gradient-to-r from-[#2563EB] to-[#93C5FD] text-white,系统无衬线字体,shadcn/ui new-york 变体),优先使用 ibl.ai SDK 组件,其次 shadcn/ui(npx shadcn@latest add <component>),存在等价组件时不要自写。iblai.env 不是 .env.local 的替代,仅保存 DOMAIN、PLATFORM、TOKEN 三个简写变量,Next.js 运行时环境变量仍从 .env.local 读取。Redux store 必须包含 mentorReducer 和 mentorMiddleware;initializeDataLayer() 需 5 个参数(v1.2+);@reduxjs/toolkit 通过 next.config.ts 中的 webpack 别名去重;需安装 peer 依赖 sonner 和 @iblai/iblai-web-mentor(pnpm add sonner @iblai/iblai-web-mentor)。验证要求 pnpm build 零错误、pnpm test(vitest)通过,并可用 npx playwright screenshot 截图检查。