SuperAPI AI 工具集

iblai-api-agent-privacy

安全与审计

查看项目

更新于 10-15 22:16

技能介绍

用途:通过 ibl.ai 平台 API 配置某个智能体的隐私路由器,控制其如何处理个人数据,并审计流经智能体的敏感数据。

主要能力:启用 PII 检测;选择 allow、redact、mask 或 block 动作;指定要监控的实体类型(如 PERSON、EMAIL_ADDRESS、US_SSN);设置检测到 PII 时返回的响应;开启输出过滤;查看租户级只读 PII/PHI 检测审计日志(privacy-flags)。

认证与约定:基础 URL 为 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 settings/ 加载当前隐私字段;GET public-settings/ 查看匿名请求的隐私路由器状态;GET privacy-flags/ 列出检测记录,支持 mentor、rail、action_taken、source、session_id、username、start_time、end_time、search、page、page_size 等过滤;GET privacy-flags/{id}/ 获取单条记录。

写入字段:enable_privacy_router、privacy_action、privacy_entities、privacy_response、enable_privacy_output_filter、disable_chathistory、disable_privacy_mode。示例: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 "enable_privacy_router=true" -F "privacy_action=redact" -F "privacy_entities=PERSON" -F "privacy_entities=EMAIL_ADDRESS" -F "privacy_entities=US_SSN" -F "privacy_response=I can't process personal information. Please remove it and try again." -F "enable_privacy_output_filter=true"

限制:PUT 中省略的字段保持不变,不要重发整个对象。block 会终止本轮并返回 privacy_response;redact/mask 改写检测到的 PII;allow 仅记录检测并原样放行。两个 Incognito 标志最多设置一个,同时为 true 时后端优先按 disable_chathistory 处理。privacy_entities 为检测器名称列表,multipart 中每个实体重复一次 -F 键。privacy-flags/ 为只读审计日志,无写入或删除接口,仅存实体类型,不含原始个人数据。