SuperAPI AI 工具集

iblai-vibe-org-metadata

办公与效率

查看项目

更新于 10-16 05:56

技能介绍

用途:在 ibl.ai 平台上为每个组织维护一个公共 metadata 对象,ibl.ai OS 自身设置(默认智能体、帮助中心 URL、聊天宽度、功能开关、登录页品牌)与你的应用自定义键共存于此,用于记住组织级选择,无需数据库。

主要能力:提供 useOrgSettings<T>()(位于 lib/iblai/metadata.ts,由 /iblai-vibe-user-metadata 安装,两者共用该文件),在 metadata.apps.<slug> 下进行类型化读取与合并写入,写入采用 GET→合并→PUT;提供 OrgSettingsForm 管理卡片(应用名称、欢迎语、支持 URL),用于 /admin/organization;vibe-starter 的 /setup 在此存储 defaultAgentId、appName、setupCompletedAt,首页在 NEXT_PUBLIC_DEFAULT_AGENT_ID 为空时读取 defaultAgentId。

使用方式:先运行 /iblai-vibe-user-metadata Step 2 安装 useOrgSettings,再将 assets/org-settings.tsx.j2 渲染为 components/settings/org-settings.tsx(需 shadcn card、input、label)。客户端用 useOrgSettings<MyOrgSettings>({...}) 读取,管理员用 update({...}) 保存,将 <OrgSettingsForm /> 挂载到仅管理员页面(/iblai-vibe-admin)。新增键需扩展 lib/iblai/metadata.ts 中的 OrgSettings 及表单,值保持 JSON 可序列化且小。

限制与注意:PUT 会替换整个对象,只写自己的键会静默删除 overall_default_mentor、help_center_url、auth_web_mentorai 及所有开关并破坏该组织的 OS,因此必须 GET→合并→PUT;该对象为公开读取,GET 无需认证,切勿存放密钥、令牌、不希望公开的价格或个人信息,仅存 ID 与展示字符串;写入需组织管理员,否则返回 403。验证可运行 pnpm typecheck && pnpm test,并用 curl -s https://api.$DOMAIN/dm/api/core/orgs/$PLATFORM/metadata/ | python3 -m json.tool 对比保存前后,确认仅 metadata.apps.<slug> 变化。首次使用若 iblai.env 无 ARCHITECTURE=,需先运行 /iblai-vibe-start。