用途:在 Next.js 应用中添加智能体搜索/浏览页面,提供可搜索、可筛选的智能体浏览器,包含星标、精选、自定义和全部智能体四个分区。
主要能力:搜索输入框;分类、主题、LLM、类型筛选;星标/收藏切换;创建智能体操作;可通过 include 属性只显示指定分区;可通过 labels 覆盖界面文案;提供 AgentCard、AgentSearchInput、AgentSearchFilters、StarButton、AgentEmptyState 等子组件,以及 useAgentSearch、useAgentSearchWithPagination、useAgentStar 等 Hook。
使用方式:需先完成认证(/iblai-auth),并配置 MCP 服务器与技能(.mcp.json 中的 @iblai/mcp)。项目根目录需有 iblai.env,包含 PLATFORM、DOMAIN、TOKEN 变量,缺失时可用 curl -o iblai.env https://raw.githubusercontent.com/iblai/vibe/refs/heads/main/iblai.env 下载模板。从 @iblai/iblai-js/web-containers/next 导入 AgentSearch,直接传入 tenantKey、username、onAgentClick 等属性,不要用 AgentSettingsProvider 包裹。默认包管理器为 pnpm,未安装时回退 npm。完成后需运行 /iblai-ops-test,并启动 pnpm dev 在 http://localhost:3000 查看。
适用场景:需要在 Next.js 应用中集成智能体浏览与筛选入口,并支持收藏与创建智能体流程。
限制:星标分区需要已认证用户(username 不为 null),否则隐藏;Redux store 必须包含 mentorReducer 和 mentorMiddleware;需安装 sonner 和 @iblai/iblai-web-mentor 等 peer 依赖;不要为 SDK 组件添加自定义样式、颜色或 CSS 覆盖,也不要实现暗色模式,除非用户明确要求;iblai.env 不是 .env.local 的替代,Next.js 仍从 .env.local 读取运行时环境变量。具体收费、价格、平台支持范围等资料暂未提供。