SuperAPI AI 工具集

iblai-api-agent-safety

编程与开发

查看项目

更新于 10-15 22:16

技能介绍

用途:通过 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-api-login 以填充 IBLAI_ORG、IBLAI_USERNAME 和 IBLAI_API_KEY。

读取:GET …/mentors/{mentor}/settings/ 可加载审核/安全的提示词、响应与启用开关;GET …/moderation-logs/?mentor={mentor}&page={n}&page_size={n}&search={q}&target_system={Moderation System|Safety System}&start_time={iso}&end_time={iso} 列出被标记的提示,每行含 username、email、user_full_name,用户已删除时后两项为 null;safety-logs/ 路径返回相同结构。

写入:PUT settings/ 可更新 enable_moderation、enable_safety_system、moderation_system_prompt、moderation_response、safety_system_prompt、safety_response 等字段;未包含的字段保持不变,切勿重发整个对象。DELETE …/moderation-logs/{id}/ 可删除某条标记日志(无请求体),属破坏性操作,需先与用户确认。

限制:删除日志仅移除审计记录,不改变智能体的安全配置;target_system 可按触发系统筛选,并可结合 search、start_time、end_time 缩小审计范围。其余细节资料未提供。