用途:通过 ibl.ai 平台 API 配置某个智能体的嵌入/挂件设置,使其能运行在外部网站上。
主要能力:可读写匿名访问、自定义 CSS/JS、挂件模式(default/advanced)、上下文感知、可见性、附件按钮、语音通话与录音开关、目录展示、引导提示、SSO 及提供方、自动打开、slug、安全免责声明等字段;可创建/重新生成分享链接、启用或禁用分享链接、为嵌入站点铸造重定向令牌;还支持服务端到服务端的令牌预配,跳过 SSO 登录弹窗。
使用方式:基础地址为 https://api.iblai.app,每个请求需带请求头 Authorization: Api-Token $IBLAI_API_KEY。路径变量 {org}=$IBLAI_ORG、{username}=$IBLAI_USERNAME、{mentor} 为智能体唯一 id。写入统一走 PUT …/mentors/{mentor}/settings/,使用 multipart/form-data,只发送变更字段。读取包括 GET …/mentors/{mentor}/public-settings/、GET …/mentors/{mentor}/settings/、GET …/mentors/{mentor}/sharable-link(404 表示尚无分享链接)。SSO 提供方读取使用 LMS 主机 learn.iblai.app。未连接时先运行 /iblai-login 填充环境变量。
限制:PUT 中未包含的字段保持不变,不要重发整个对象;服务端令牌预配受 ibl.ai 管理的开关 ENABLE_PLATFORM_CONSOLIDATED_PROXY_PROVISIONING 控制,未开启时预配端点返回 404,需联系 ibl.ai 启用;平台 API Token 不得暴露在浏览器 JS 中。其他细节暂未提供。