用途:为 Next.js 应用添加智能体(agent)的 Embed 标签页,属于 agent-settings 系列中的一个标签,所有标签共用 AgentSettingsProvider 包装器。
主要能力:提供嵌入配置界面,包含 CSS/JS 编辑器、自定义浮动气泡样式、可见性控制、可分享链接,以及嵌入智能体的预览 iframe。
使用方式:需先完成认证(/iblai-auth),配置 MCP 服务器与技能(.mcp.json 中的 @iblai/mcp),并确保 AgentSettingsProvider 在布局层包裹路由。需向用户索取真实的 mentorId(智能体 UUID),不可自行编造。项目根目录需有 iblai.env,包含 PLATFORM、DOMAIN、TOKEN 三个变量,缺失时可用 curl -o iblai.env https://raw.githubusercontent.com/iblai/vibe/refs/heads/main/iblai.env 下载模板。AgentEmbedTab 有三个必填 props:urls、CopyCodeBlock、visibilityOptions,均需宿主提供。可选 labels 覆盖文案,ssoProviders、isSsoProvidersError、supportEmail 用于 SSO 配置。完成后须运行 /iblai-ops-test,再以 pnpm dev 启动开发服务器。
限制与约定:不要为 ibl.ai SDK 组件添加自定义样式、颜色或 CSS 覆盖;除非用户明确要求,否则不实现深色模式。优先使用 @iblai/iblai-js 组件,其次使用 shadcn/ui(npx shadcn@latest add <component>),不要重复造轮子。默认包管理器为 pnpm,未安装时回退 npm。iblai.env 不是 .env.local 的替代,Next.js 仍从 .env.local 读取运行时环境变量。需安装 peer 依赖 sonner 与 @iblai/iblai-web-mentor。Redux store 须包含 mentorReducer 与 mentorMiddleware。其他细节(如 initializeDataLayer 参数、webpack 别名)以官方文档为准。