用途:通过 ibl.ai 平台 API 读取单个智能体的审计日志,获取"谁在何时改了什么"的变更轨迹,用于排查智能体的配置改动。操作全程只读,不会修改智能体状态。
主要能力:审计日志接口支持按操作码(action)、操作者邮箱(actor_email)以及日期范围(from_date/to_date)进行筛选,结果通过 limit 和 offset 分页,资料中示例默认每页 20 条。
认证与约定:基础地址为 https://api.iblai.app;每个请求需携带请求头 Authorization: Api-Token $IBLAI_API_KEY。路径变量中 {org} 对应 $IBLAI_ORG,{username} 对应 $IBLAI_USERNAME,{mentor} 为智能体的唯一 ID。尚未连接时,先运行 /iblai-api-login 以填充 IBLAI_ORG、IBLAI_USERNAME 和 IBLAI_API_KEY。
读取接口: GET https://api.iblai.app/dm/api/ai-mentor/orgs/{org}/users/{username}/mentors/audit-logs/?limit=20&offset={n}&mentor={mentor}&action={code}&actor_email={e}&from_date={d}&to_date={d}
示例(按单个操作者与日期范围读取首页):
curl -s
"https://api.iblai.app/dm/api/ai-mentor/orgs/$IBLAI_ORG/users/$IBLAI_USERNAME/mentors/audit-logs/?limit=20&offset=0&mentor=$MENTOR&actor_email=jane@example.com&from_date=2026-01-01&to_date=2026-06-12"
-H "Authorization: Api-Token $IBLAI_API_KEY"
使用说明:action、actor_email、from_date、to_date 均为可选筛选,不需要时省略即可;from_date 与 to_date 使用 ISO 日期(例如 2026-06-12)。该技能不暴露创建、更新或删除接口,无法写入。
适用场景:调查智能体的配置变更、追踪特定人员在一段时间内对智能体的操作。
限制:仅为只读审计查询,不提供写操作;需要有效的 API Key、组织与用户名等认证参数。收费、价格、具体平台覆盖范围等资料暂未提供。