SuperAPI AI 工具集

iblai-llm-tab

智能体与模型

查看项目

更新于 10-15 22:16

技能介绍

用途:为 Next.js 应用添加智能体 LLM 标签页(模型提供商选择),呈现可搜索的 LLM 提供商卡片网格,点击后通过弹窗选择该提供商下的具体模型。它是更广泛的 agent-settings 系列中的一个标签,所有标签共用同一个 AgentSettingsProvider 包装器。

主要能力:提供 AgentLLMTab 组件,从 @iblai/iblai-js/web-containers/next 导入。必填 prop 为 getLLMProviderDetails,用于把提供商名称映射为展示信息(logo URL、显示名称),由宿主应用提供,因为 logo 和显示名称因部署而异。可选 prop 包括 labels(覆盖用户可见文案)和 showConfigurationHeader(显示/隐藏配置头部)。相关导出还有 AGENT_LLM_TAB_LABELS、LLMTabLabels、LLMProviderDetails、LLMProvider、Provider。

使用方式:前置条件为已配置认证(/iblai-auth)、已执行 iblai add mcp、路由已被 AgentSettingsProvider 包装,并向用户索取真实的 mentorId(agent 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。注意 iblai.env 不是 .env.local 的替代,Next.js 运行时环境变量仍从 .env.local 读取。默认使用 pnpm,未安装时回退 npm。完成后必须运行 /iblai-test,再启动开发服务器 pnpm dev,在 http://localhost:3000 查看结果。

限制与注意:不要给 ibl.ai SDK 组件添加自定义样式、颜色或 CSS 覆盖,组件自带样式;除非用户明确要求,否则不要实现深色模式。构建自定义 UI 时遵循 ibl.ai 品牌(主色 #0058cc,渐变 linear-gradient(135deg, #00b0ef, #0058cc)),优先使用 ibl.ai SDK 组件,其次 shadcn/ui(npx shadcn@latest add <component>),不要重复造轮子。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)通过。