Skip to main content
要完整记录操作者,需使用 Workspace API Key,创建方式见认证。旧版 API Key 创建的 Task 操作者信息有限。

概览

操作者(Actor) 标识在 Nonce 中执行操作的主体,用来回答「这个操作是做的」,是 Task 审计的基础。 通过操作者可以:
  • 追踪哪个用户、API Key 或系统进程创建了 Task Batch
  • 留下合规和运营所需的审计记录
  • 区分手动操作(用户)和自动化操作(API Key 或系统)

操作者类型


操作者 Schema

API 响应中的操作者对象包含以下字段:

操作者响应示例

用户操作者:
API Key 操作者:
系统操作者:

在 API 响应中的使用

Task Batch

查询 Task Batch 时,created_by 字段是创建该 Task Batch 的操作者:
操作者无法解析时(例如用户已被删除),created_by 可能为 null 或显示为「Unknown」。

当前限制

  • 旧版 API Key:用旧版 API Key 创建的 Task 可能只有部分操作者信息
  • 系统操作:部分自动化操作归属于 system 操作者
  • 历史数据:较早的记录可能没有操作者信息