要完整记录操作者,需使用 Workspace API Key,创建方式见认证。旧版 API Key 创建的 Task 操作者信息有限。
概览
操作者(Actor) 标识在 Nonce 中执行操作的主体,用来回答「这个操作是谁做的」,是 Task 审计的基础。 通过操作者可以:- 追踪哪个用户、API Key 或系统进程创建了 Task Batch
- 留下合规和运营所需的审计记录
- 区分手动操作(用户)和自动化操作(API Key 或系统)
操作者类型
操作者 Schema
API 响应中的操作者对象包含以下字段:操作者响应示例
用户操作者:在 API 响应中的使用
Task Batch
查询 Task Batch 时,created_by 字段是创建该 Task Batch 的操作者:
操作者无法解析时(例如用户已被删除),
created_by 可能为 null 或显示为「Unknown」。当前限制
- 旧版 API Key:用旧版 API Key 创建的 Task 可能只有部分操作者信息
- 系统操作:部分自动化操作归属于
system操作者 - 历史数据:较早的记录可能没有操作者信息