用途:在 Next.js 应用中为智能体加入 Support 标签页,实现人工支持工单管理。当用户与智能体对话时可将会话转交人工,每次请求生成一张工单,管理员可查看、回复并解决。
主要能力:包含可用性开关(说明转人工流程,与 Tools 标签页同一开关状态)、可搜索的用户下拉筛选(防抖、显示邮箱、支持 All Users 重置)与状态筛选(全部/Open/In Progress/Closed);左侧工单收件箱每页 10 条,显示时间、请求者邮箱、主题、状态徽章与正文预览,多页时显示分页;右侧工单详情在桌面显示,md 断点以下改为对话框,含状态下拉(Closed 调用专用关闭接口,其余走 patch)、原始请求正文(HTML/Markdown 均经净化渲染)、按时间正序的回复线程与回复框,已关闭工单提示需改回 Open 或 In Progress 才能回复。
使用方式:先完成认证(/iblai-vibe-auth),配置 MCP 服务器与技能,并确保 AgentSettingsProvider 在布局层包裹路由。在 app/(app)/agents/[mentorId]/support/page.tsx 中导入并渲染 AgentHumanSupportTab,该组件从 Provider 读取 tenantKey、mentorId、username,无身份 prop 覆盖。需向用户索取真实 mentorId(智能体 UUID),不可编造。可选通过 labels 覆盖文案,通过 PaginationComponent 替换内置分页。完成后运行 /iblai-vibe-ops-test,执行 pnpm build 与 pnpm test,并启动 pnpm dev 在 http://localhost:3000 查看。
限制与注意:需项目根目录存在 iblai.env(含 PLATFORM、DOMAIN、TOKEN),模板可用 curl -o iblai.env https://raw.githubusercontent.com/iblai/vibe/refs/heads/main/iblai.env 下载;iblai.env 不是 .env.local 的替代。Redux store 需包含 mentorReducer 与 mentorMiddleware,initializeDataLayer() 为 5 参数(v1.2+),需安装 sonner 与 @iblai/iblai-web-mentor。不要为 SDK 组件添加自定义样式、颜色或 CSS 覆盖,不要实现暗色模式(除非明确要求)。工单按智能体的 mentor_unique_id 归属;若平台不支持该工具,开关隐藏但收件箱仍可用。默认包管理器为 pnpm,未安装时回退 npm。