SuperAPI AI 工具集

iblai-vibe-agent-create

智能体与模型

查看项目

更新于 10-16 08:48

技能介绍

用途:在 ibl.ai 应用内部创建一个智能体。SDK 没有提供创建组件(据资料称已对照 @iblai/web-containers 1.16–1.19 验证),因此采用“服务端路由 + 小表单”的模式;vibe-starter 的 /setup 即该表单。首次使用若 iblai.env 中没有 ARCHITECTURE=,需先运行 /iblai-vibe-start 决定单组织/多组织/无头模式及登录方式。

主要能力:一次平台调用即可创建智能体并返回唯一 unique_id(后续其它智能体技能所需);提供管理员接口 GET 列出组织智能体、POST 创建;浏览器侧 adminFetch() 转发会话令牌;setup 界面可命名应用并选择或创建智能体、保存到组织元数据。

前提条件:已完成鉴权,.env.local 中配置 IBLAI_API_KEY(仅服务端);具备来自 /iblai-vibe-api 的 lib/iblai/platform.ts(含 requireAdmin、platformFetch);调用者须为组织管理员或拥有 MENTOR_CREATORS(组织开关 rbac/student-agent-creation/status/ 决定普通成员是否可创建)。

安装:渲染资产(去掉 .j2 后缀、无变量),包括 app/api/admin/agents/route.ts、lib/iblai/admin-client.ts、components/setup/setup-screen.tsx、app/setup/page.tsx;setup 界面通过 useOrgSettings 保存,并使用 SDK 的 OnboardingShell / StepHeader,需要 shadcn 的 input、label。

调用方式(服务端,requireAdmin(req) 之后):POST /dm/api/ai-mentor/orgs/{org}/users/{caller.username}/mentor-with-settings/,body 含 template_name(多数组织默认 ai-mentor)、new_mentor_name、display_name、description,可选 system_prompt、llm_provider;列出已有智能体用 GET /dm/api/search/orgs/{org}/users/{username}/mentors/;浏览器侧用 adminFetch("/api/admin/agents", { method: "POST", json: {...} })。复制已有智能体请用 /iblai-vibe-agent-setting 中的 fork。

创建后:把 id 存到应用读取的位置,即 NEXT_PUBLIC_DEFAULT_AGENT_ID(环境变量优先)或组织设置 defaultAgentId(/setup 写入的位置);再经 /iblai-vibe-agent-setting 配置身份与可见性,Prompts、LLM、Datasets、Tools、Memory 均通过 /iblai-vibe-agent 配置。

验证:运行 pnpm typecheck && pnpm build;以管理员打开 /setup 创建智能体并进入对话,新智能体会出现在 os.ibl.ai → Explore → Custom;以普通成员 POST /api/admin/agents 应返回 403。

限制:创建需组织权限与管理员身份;SDK 无创建组件;其余收费、价格、平台范围等资料未提供。