用途:在 Next.js 应用中为智能体添加“Support”标签页,实现人工支持工单管理。当用户与智能体对话时可将会话转交人工,每次请求生成一张工单,管理员可查看、回复并解决。
主要能力:包含可用性开关(即智能体的人工支持工具开关,与 Tools 标签页状态一致)、可搜索的用户下拉筛选与状态筛选(全部/Open/In Progress/Closed)、每页 10 条的工单收件箱(显示时间、请求者邮箱、主题、状态徽章与正文预览)、工单详情面板(状态下拉、原始请求、按时间正序的回复线程、回复输入框)。桌面端右侧显示详情,md 断点以下以对话框打开。关闭的工单不能回复,需改回 Open 或 In Progress。
使用方式:需先完成认证(/iblai-vibe-auth),配置 MCP 服务器与技能(@iblai/mcp 写入 .mcp.json),并用 AgentSettingsProvider 在布局层包裹路由。项目根目录需有 iblai.env,含 PLATFORM、DOMAIN、TOKEN;缺失时可用 curl -o iblai.env https://raw.githubusercontent.com/iblai/vibe/refs/heads/main/iblai.env 下载模板。在 app/(app)/agents/[mentorId]/support/page.tsx 中导入并渲染 AgentHumanSupportTab,该组件从 Provider 读取 tenantKey、mentorId、username,分页由内置 IblPagination 自动渲染。可通过 labels 属性覆盖文案,通过 PaginationComponent 替换分页组件。需向用户索取真实的 mentorId(智能体 UUID),不可自行编造。
适用场景:需要为智能体提供人工客服接管与工单处理流程的 Next.js 应用。
限制:必须安装 sonner 与 @iblai/iblai-web-mentor 对等依赖;Redux store 需包含 mentorReducer 与 mentorMiddleware;initializeDataLayer() 需 5 个参数(v1.2+);@reduxjs/toolkit 通过 next.config.ts 的 webpack 别名去重。工单按智能体的 mentor_unique_id 限定范围。若平台不支持该工具,开关隐藏但收件箱仍可用。验证需运行 /iblai-vibe-ops-test,确保 pnpm build 与 pnpm test 通过。