SuperAPI AI 工具集

iblai-chat

前端与建站

查看项目

更新于 10-15 22:16

技能介绍

用途:为 Next.js 应用添加由 ibl.ai mentors 驱动的 AI 聊天挂件,基于 <mentor-ai> Web 组件,自动处理流式输出、会话管理与认证。

主要能力:生成聊天挂件组件并修改 Redux store 以加入聊天相关 reducer;ChatWidget 从 localStorage 读取 axd_token、tenant、userData,并以 authrelyonhost 模式传给 MentorAI iframe。

使用方式:前置条件为已配置 /iblai-auth、iblai CLI 可用、拥有 agent/mentor ID。先检查 CLI 版本并升级(pip install --upgrade iblai-app-cli 或 npm install -g @iblai/cli@latest)。确认项目根目录存在含 PLATFORM、DOMAIN、TOKEN 的 iblai.env,否则下载模板:curl -o iblai.env https://raw.githubusercontent.com/iblai/vibe/refs/heads/main/iblai.env。向用户索取 agent ID 并写入 .env.local 的 NEXT_PUBLIC_DEFAULT_AGENT_ID。运行 iblai add chat 生成组件,再按需引入:import { ChatWidget } from "@/components/iblai/chat-widget"; 组件支持 mentorId(必填)、tenantKey、theme、width、height 属性。完成后运行 /iblai-ops-test 验证(pnpm build、pnpm test),并启动 pnpm dev 在 http://localhost:3000 查看。

限制:不要为 ChatWidget 添加自定义样式、颜色或 CSS 覆盖,也不要实现暗色模式(除非用户明确要求)。iblai.env 不能替代 .env.local。默认使用 pnpm,未安装时回退 npm。应用应生成在当前目录而非子目录。自定义 UI 需遵循 ibl.ai 品牌规范与组件层级(优先 @iblai/iblai-js,其次 shadcn/ui)。