SuperAPI AI 工具集

iblai-vibe-project

前端与建站

查看项目

更新于 10-15 22:16

技能介绍

用途:在 Next.js 应用中接入 ibl.ai 的进程内项目界面,包含项目文件、项目指令、项目已分配智能体列表以及项目范围内的聊天输入。它复用 SDK 的 Chat 组件:传入 projectId 后,SDK 会自动把默认的欢迎/探索界面替换为 ProjectLandingPage。同一个 <Chat> 同时支持两种模式,本技能只负责添加路由与 URL 参数传递。

主要能力:新增路由 /agents/[mentorId]/projects/[projectId],从 URL 读取两个 ID 并传给 <Chat>,由 SDK 渲染项目落地页(聊天输入 + Project files / Add project instructions 卡片 + Project Agents 网格)。点击“Project files”打开 SDK 的 ProjectFilesModal,点击“Add project instructions”打开 ProjectInstructionsModal,“Add Agent”打开 AddMentorToProjectModal。

使用方式:本技能是 /iblai-vibe-agent-chat 之上的薄增量,需先完成该技能(providers 包装、store reducers 注册、service worker、peer 依赖安装)。需要 agent ID 和一个真实 projectId。最低 SDK 版本:@iblai/iblai-js ^2.33.1、@iblai/agent-ai ^2.10.0;如版本较旧可执行 pnpm add @iblai/iblai-js@^2.33.1 @iblai/agent-ai@^2.10.0。写路由前先做 prop 检查:grep -q "projectId?: string" node_modules/@iblai/web-containers/dist/next/index.d.ts。创建 app/agents/[mentorId]/projects/[projectId]/page.tsx,渲染 <Chat> 并传入 projectId={projectId},其余 props 与 /iblai-vibe-agent-chat 相同。

适用场景:需要为已认证用户提供项目级聊天与项目资源管理的 Next.js 应用。

限制:不要给 SDK 组件添加自定义样式、颜色或 CSS 覆盖,也不要实现暗色模式(除非用户明确要求)。projectId 需为用户有权访问的项目,否则界面为空并出现 data-layer 控制台错误。若项目界面渲染但聊天 WebSocket 无法连接,属于后端问题(智能体的 LLM 配置)。