SuperAPI AI 工具集

iblai-history-tab

编程与开发

查看项目

更新于 10-15 22:16

技能介绍

用途:在 Next.js 应用中挂载智能体 History 标签页,用于查看智能体对话历史。该标签页属于 agent-settings 家族,所有标签共享同一个 AgentSettingsProvider 包裹层。

主要能力:对话历史含评分、摘要、主题标签;支持按用户、日期范围、情感、主题筛选;提供对话预览、分页插槽与可选导出。相关导出为 @iblai/iblai-js/web-containers/next 的 HistoryTabLabels 类型。

使用方式:从 @iblai/iblai-js/web-containers/next 导入 AgentHistoryTab 并在路由页渲染。可用 props 自定义:labels(覆盖文案)、renderMessageContent(富文本渲染)、PaginationComponent(自定义分页,缺省不渲染分页 UI)、onExport(点击导出时回调,携带当前筛选)、isExporting(导出进行中)。导出可用 iblai add mcp 后通过 get_component_info 查询组件信息。

前置条件:先完成 /iblai-auth 鉴权;执行 iblai add mcp 配置 MCP 与 skills;路由需在 layout 层用 AgentSettingsProvider 包裹;需向用户索取真实 mentorId(agent UUID),不要自行编造。运行 iblai 命令前先更新 CLI:pip install --upgrade iblai-app-cli 或 npm install -g @iblai/cli@latest。

环境与限制:项目根需有 iblai.env,包含 PLATFORM、DOMAIN、TOKEN;模板可用 curl -o iblai.env https://raw.githubusercontent.com/iblai/vibe/refs/heads/main/iblai.env 下载。iblai.env 不能替代 .env.local,Next.js 运行时环境变量仍从 .env.local 读取。默认使用 pnpm,未安装则回退 npm。不要为 ibl.ai SDK 组件添加自定义样式、颜色或 CSS 覆盖,也不要实现暗黑模式(除非用户明确要求);自定义 UI 使用 ibl.ai 品牌色。组件优先用 ibl.ai SDK,其次 shadcn/ui(npx shadcn@latest add <component>),不要重复造已存在的组件。Redux store 须含 mentorReducer 与 mentorMiddleware;initializeDataLayer() 为 5 个参数(v1.2+);@reduxjs/toolkit 通过 next.config.ts 的 webpack aliases 去重;需安装 peer deps:pnpm add sonner @iblai/iblai-web-mentor。完成后必须运行 /iblai-test(pnpm build 零错误、pnpm test 通过),并启动 pnpm dev 供用户在 http://localhost:3000 查看。其他未提供的信息暂未提供。