用途:通过 ibl.ai 平台 API 配置智能体的审核(moderation)与安全(safety)系统,包括启用开关、系统提示词和响应,并查看、删除被标记的审核日志。适用于设置护栏或审计被标记内容。
认证与约定:基础地址为 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-login 以填充 IBLAI_ORG、IBLAI_USERNAME 和 IBLAI_API_KEY。
读取:GET …/settings/ 可加载审核/安全提示词、响应和启用开关;GET …/moderation-logs/ 可列出被标记的提示,支持 mentor、page、page_size、search、target_system(Moderation System 或 Safety System)、start_time、end_time 等参数。
写入:PUT …/settings/ 更新审核/安全字段,可发送 enable_moderation、enable_safety_system、moderation_system_prompt、moderation_response、safety_system_prompt、safety_response。DELETE …/moderation-logs/{id}/ 删除某条被标记日志,无请求体,属破坏性操作,需先与用户确认。
限制与注意:PUT 中未包含的字段保持不变,切勿重发整个对象;安全与审核的提示词、响应、开关均通过同一 settings/ 端点持久化;target_system 用于按触发系统筛选日志,可结合 search、start_time、end_time 缩小审计范围;删除审核日志仅移除审计记录,不会改变智能体的安全配置。