用途:通过 ibl.ai 平台 API 配置某个 agent 的嵌入/组件设置,让该 agent 能部署在外部网站上。
主要能力:可读写匿名访问开关、自定义 CSS/JS、website_url、mode(default/advanced)、is_context_aware、mentor_visibility、附件按钮、语音通话与语音录制开关、show_catalogue、starter_prompts、SSO 及 sso_provider、auto_open、slug、safety_disclaimer;可创建/重新生成分享链接、启用或停用分享链接;可为嵌入站点签发重定向令牌。
使用方式:基址 https://api.iblai.app,每个请求带 Authorization: Api-Token $IBLAI_API_KEY。路径变量 {org}=$IBLAI_ORG,{username}=$IBLAI_USERNAME,{mentor} 为 agent 唯一 id。读取用 GET …/mentors/{mentor}/public-settings/ 与 …/settings/;写入统一走 PUT …/mentors/{mentor}/settings/,multipart/form-data,只提交变更字段。分享链接用 POST/PUT …/mentors/{mentor}/sharable-link。示例:curl -X PUT "https://api.iblai.app/dm/api/ai-mentor/orgs/$IBLAI_ORG/users/$IBLAI_USERNAME/mentors/$MENTOR/settings/" -H "Authorization: Api-Token $IBLAI_API_KEY" -F "allow_anonymous=true" -F "embed_show_attachment=true"。
服务端令牌预置:可调用 POST …/consolidated-token/provision/ 解析或创建用户并签发 axd_token、dm_token、edx_jwt_token,再在自有后端拼装 ibl-data(tenant、current_tenant、tenants、userData 为 JSON 字符串),通过 iframe src 的 ibl-data= 查询参数或 postMessage { type: "MENTOR:AUTH_UPDATE", authData } 传给嵌入组件,从而跳过 SSO 弹窗。该接口以 Platform API Token 服务端调用,不可在浏览器 JS 中暴露密钥。
限制:预置接口受 ibl.ai 管理的开关 ENABLE_PLATFORM_CONSOLIDATED_PROXY_PROVISIONING 控制,未开启返回 404;platform_key 必须等于令牌所属 org;邮箱与用户名指向不同用户、越权或达到单用户令牌上限返回 403;新用户尚未同步到 DM 返回 503 并带 Retry-After,可原样重试。SSO 提供方读取走 learn.iblai.app,而非 api.iblai.app。GET sharable-link 返回 404 表示尚无分享链接。PUT 中未出现的字段保持不变,不应整体重发。创建分享链接与重定向令牌会对外发布,需先与用户确认。未连接时先运行 /iblai-api-login 填充环境变量。