用途:通过 ibl.ai 平台 API 读写智能体的核心设置,是带界面 Settings 标签页的无界面版本,使用相同数据与端点。适用于配置智能体的基本身份与能力。
主要能力:读取分类选项、加载当前设置、检测沙箱配置;写入身份(名称、描述、分类、头像)、可见性与能力开关(匿名、精选、LTI、附件、语音通话与录音、claw、虚拟机、记忆组件、多查询 RAG、可复制);复制智能体;删除智能体。
使用方式:基础地址 https://api.iblai.app,每个请求带 Authorization: Api-Token $IBLAI_API_KEY。路径变量 {org}=$IBLAI_ORG、{username}=$IBLAI_USERNAME、{mentor}=智能体唯一 id。设置写入统一走 PUT …/users/{username}/mentors/{mentor}/settings/,使用 multipart/form-data,只发送变更字段。未连接时先运行 /iblai-api-login 填充环境变量。
读取端点:GET …/mentor/categories/ 获取分类;GET …/mentors/{mentor}/settings/ 加载全部字段;GET …/mentors/{mentor}/claw-config/ 检测沙箱接线(404 表示未连接)。写入端点:PUT settings/ 更新设置;POST …/mentors/{mentor}/fork/ 复制(需 new_mentor_name、destination_platform_key,可选 clone_documents);DELETE …/users/{username}/{mentor}/ 删除(无请求体)。
限制:PUT 中省略的字段保持不变,不要重发整个对象;categories 需传数字分类 id 而非名称;删除与复制按 {username} 作用域,设置读写使用 users/{username}/mentors/{mentor}/ 路径;删除为破坏性操作,需先与用户确认;virtual_machine_* 三个键配置 Linux VM 沙箱,其引用的网络策略与密钥按组织管理。