iblai-agent-api 用于在 Next.js 应用中添加智能体 API 标签页,实现对智能体编程访问所需 API 密钥的管理。该标签页在表格中显示已有密钥的名称、创建时间和过期时间,并提供创建和删除操作。它属于更广泛的 agent-settings 标签家族,所有标签共用同一个 AgentSettingsProvider 包装器。
使用前提:需先完成认证(/iblai-auth),配置 MCP 服务器与技能(@iblai/mcp 写入 .mcp.json),并由 AgentSettingsProvider 在布局层包裹该路由;需向用户索取真实的 mentorId(智能体 UUID),不可自行编造。项目根目录需存在 iblai.env,包含 PLATFORM、DOMAIN、TOKEN 三个变量;缺失时可用 curl -o iblai.env https://raw.githubusercontent.com/iblai/vibe/refs/heads/main/iblai.env 下载模板。需注意 iblai.env 不能替代 .env.local。
集成方式:从 @iblai/iblai-js/web-containers/next 导入 AgentApiTab,在 app/(app)/agents/[mentorId]/api/page.tsx 渲染。可通过 labels 属性(DeepPartial<ApiTabLabels>)覆盖可见文案,如自定义 header 标题。组件构建优先使用 ibl.ai SDK 组件,其次使用 shadcn/ui(npx shadcn@latest add <component>),不要为 SDK 组件添加自定义样式或 CSS 覆盖,除非明确要求否则不要实现暗色模式。包管理器默认使用 pnpm,未安装时可回退到 npm。
完成前必须运行 /iblai-ops-test 验证:pnpm build 需零错误通过,pnpm test(vitest)需通过,随后启动开发服务器(pnpm dev)并可用 Playwright 截图检查 http://localhost:3000/agents/<id>/api。其他注意事项:Redux store 需包含 mentorReducer 与 mentorMiddleware;initializeDataLayer() 在 v1.2+ 为 5 个参数;@reduxjs/toolkit 通过 next.config.ts 中的 webpack 别名去重;对等依赖 sonner 与 @iblai/iblai-web-mentor 需安装(pnpm add sonner @iblai/iblai-web-mentor)。资料未提供收费、价格及平台支持范围等信息。