SuperAPI AI 工具集

iblai-vibe-agent-chat

智能体与模型

查看项目

更新于 10-16 03:37

技能介绍

用途:在 Next.js 应用中接入 ibl.ai 智能体的完整对话界面。该技能依据公开资料整理。

主要能力:Chat 组件为进程内渲染(非 iframe),复用宿主的 Redux store、providers 与 auth session;包含消息流、conversation starters、canvas、文件附件、语音输入、语音通话、屏幕共享和 prompt gallery。组件自带样式,不应添加自定义样式、颜色或 CSS 覆盖,也不要实现深色模式(除非用户明确要求)。

前置条件:先完成 /iblai-vibe-auth 认证配置,应用需已有可用的 store、providers 与 SSO 回调路由;需要一个 agent ID(UUID),可取自 https://os.ibl.ai/platform/<tenant>/<agent-uuid> 的最后一段,或在 os.ibl.ai 创建。SDK 最低版本:@iblai/iblai-js ^2.33.1、@iblai/agent-ai ^2.10.0。

安装依赖: pnpm add @iblai/data-layer @iblai/web-containers @iblai/web-utils @iblai/agent-ai react-paginate livekit-client @livekit/components-react @livekit/components-styles @tauri-apps/plugin-os @tauri-apps/api

接入要点:providers/index.tsx 中用 <ServiceWorkerProvider> 包裹 AuthProvider/TenantProvider,并传 skip={isSsoLoginRoute};需提供 public/sw.js(SDK 不自带可复制版本);子路径挂载需在 next.config 中为 /sw.js 添加 Service-Worker-Allowed 头;在 store/index.ts 注册 chat、chatInput、chatSliceShared、files、rbac、subscription、topBanner 等固定键名的 reducer;新建 app/agents/[mentorId]/chat-new/page.tsx 渲染 <Chat>,用 Suspense 包裹以配合 useSearchParams,并通过 useCachedSessionId 在挂载前播种或清除会话,key 设为 mentor:session:new 以在切换会话时安全重挂载。

限制:<Chat> 在挂载时一次性读取会话与语音状态,非预期的重挂载会丢失会话或导致语音异常,应避免条件式切换子树。SDK 的 .d.ts 类型定义不完整,部分运行时 props 或参数未声明,应以实际 bundle 为准。棕地应用中若宿主已有同名 chat/files 等 slice,需重命名宿主 slice(SDK 键名固定)。运行需配置 NEXT_PUBLIC_MAIN_TENANT_KEY 与 NEXT_PUBLIC_DEFAULT_AGENT_ID。关于收费、价格及具体效果,资料暂未提供。