SuperAPI AI 工具集

iblai-api-agent-privacy

编程与开发

查看项目

更新于 10-15 22:16

技能介绍

用途:通过 ibl.ai 平台 API 配置某个智能体的 Privacy Router,控制其如何处理个人数据,例如开启 PII 检测、选择对检测到的敏感信息执行的动作、指定需要监测的实体类型、设置命中 PII 时返回的响应内容,并开关对智能体输出的过滤。

主要能力:可读取当前隐私字段,也可读取匿名(未认证)请求的隐私路由器状态;可写入以下字段:enable_privacy_router(布尔)、privacy_action(redact、mask 或 block)、privacy_entities(检测器名称列表,如 PERSON、EMAIL_ADDRESS、US_SSN 等)、privacy_response(命中时返回的字符串)、enable_privacy_output_filter(布尔,决定是否同样检测智能体输出而不只是用户输入)。其中 block 会终止该轮对话并返回 privacy_response,redact 和 mask 则改写检测到的 PII。

使用方式与约定:基础地址为 https://api.iblai.app,每个请求都需带请求头 Authorization: Api-Token $IBLAI_API_KEY。路径变量中 {org} 对应 $IBLAI_ORG,{username} 对应 $IBLAI_USERNAME,{mentor} 为智能体唯一 id(例如 d17dc729-60fd-4363-81a0-f67d9318b03e)。设置写入统一走 PUT …/users/{username}/mentors/{mentor}/settings/,使用 multipart/form-data,只发送发生变化的字段。读取当前隐私字段用 GET …/mentors/{mentor}/settings/;读取匿名请求状态用 GET …/mentors/{mentor}/public-settings/。尚未连接时先运行 /iblai-api-login 以填充 IBLAI_ORG、IBLAI_USERNAME、IBLAI_API_KEY。

注意事项与限制:PUT 中省略的字段保持不变,不要重发整个对象;privacy_entities 在 multipart/form-data 中需要为每个实体重复一次 -F 键。确认匿名(未认证)请求的生效状态请使用 public-settings/ 读取。其余收费、配额或平台限制暂未提供。