`audit` 操作
本页由机器从英文原文翻译,内容以英文原文为准。 Machine-translated from the English page, which is authoritative.
每个 audit.* 操作接受和返回的确切字段。
每个 op 都是 HTTP 上的 POST /v1/<op>,也是 MCP 工具 loom_<op>。身份字段(org、namespace、agent、user_id、session_id)在传输层能够提供时,由令牌和 MCP 会话填充;对于单用户服务器上不带令牌的 HTTP 调用,除 code.* 和 tracker.*(它们保留各自平面的 org)之外,所有 op 都使用该安装的 org,并且在部分 op 上还会填充其命名空间和 agent;参见身份与命名空间。操作索引解释了角色、类型以及 MCP 的 all 列表。未知的输入字段仍会被处理,并在 ignored_args 中列出。
audit.list
查询审计日志(每行带有防篡改哈希)。
POST /v1/audit.list · MCP loom_audit_list · 角色 viewer · 读取 · 未列在 MCP all 工具集中
| 输入字段 | 类型 | 默认值 | 含义 |
|---|---|---|---|
org |
str |
必填 | 租户(身份元组的第一个元素)。 |
namespace |
str | None |
None |
None:调用方可读取的所有命名空间;指定一个其无权读取的命名空间会返回空页。 |
event_type |
str | None |
None |
精确匹配 |
since |
datetime | None |
None |
仅返回 ts >= since 的行 |
limit |
int |
50 |
每页最多返回的行数,按最新优先;范围 1 到 500。 |
cursor |
str | None |
None |
来自上一页的不透明令牌 |
fields |
list[str] | None |
None |
调用方要读取的输出字段(白名单,依据行模型解析;未知名称会返回 422);未设置时返回所有字段。 |
| 输出字段 | 类型 | 含义 |
|---|---|---|
rows |
list[AuditListRow] |
审计行的一页,按最新优先(相同时间按 request_id 排序)。 |
next_cursor |
str | None |
作为 cursor 传回以获取下一页(更早的一页);当前页为最后一页时为 None。 |