# 事件 (/docs/api/native/knowledge/events)



[快速开始：官方 Python SDK](/docs/cloud/services/knowledge/quickstart)

[基础地址与鉴权](/docs/api/native/knowledge)

路径中的 ID 使用已有资源的 ID。示例中的环境变量由调用者设置。

## 列出事件 [#列出事件]

`GET /knowledge/v1/vector_stores/{vector_store_id}/events`

按序号升序读取此知识库事件，软删除期间仍可读取。将 next\_seq 作为 after\_seq 继续查询；next\_seq 为 null 表示当前已到末尾。例如 ?after\_seq=0\&limit=20。

### 参数 [#参数]

| 名称                | 位置与类型          | 说明                                            |
| ----------------- | -------------- | --------------------------------------------- |
| vector\_store\_id | path: string   | 必填；创建或列表返回的知识库 ID；不要使用显示名称。 最短字符数: 1          |
| after\_seq        | query: integer | 返回 seq 更大的事件；使用 next\_seq 继续。当前忽略非数字文本。 默认: 0 |
| limit             | query: integer | 每页条数。 最小: 1; 最大: 100; 默认: 20                  |

### 请求示例 [#请求示例]

```bash
curl -X GET "https://api.deepraxis.ai/knowledge/v1/vector_stores/${VECTOR_STORE_ID}/events" \
  -H "Authorization: Bearer $PRAXIS_API_KEY"
```

### 响应 [#响应]

HTTP 200

| 字段 | 类型 | 说明 |
| --- | --- | --- |
| data | object[] | 必有; seq 大于 after_seq 的事件，按 seq 升序返回。 |
| data[].seq | integer | 必有; 库内递增事件序号；将返回的 next_seq 作为 after_seq 继续查询。; 最小: 1 |
| data[].id | string | 必有; 服务端生成的事件 UUID。 |
| data[].type | "vector_store.created" / "vector_store.updated" / "vector_store.expired" / "vector_store.deleted" / "vector_store.restored" / "file.attached" / "file.stage_changed" / "file.completed" / "file.failed" / "file.cancelled" / "file.removed" / "batch.created" / "batch.completed" / "batch.cancelled" | 必有; 此知识库记录的库、文件入库或批次事件类别。 |
| data[].processed_at | integer | 必有; Unix 时间戳，单位秒。 |
| data[].vector_store_id | string | 必有; 资源 ID。; 最短字符数: 1 |
| data[].file_id | string / null | 必有; 关联的源 File ID；无关联文件时为 null。 |
| data[].batch_id | string / null | 必有; 关联的文件批次 ID；无关联批次时为 null。 |
| data[].data | object | 必有; 事件详情；阶段变化含 stage，入库失败含 code，其它事件可为空对象。 |
| next_seq | integer / null | 必有; 作为下一页的 after_seq；null 表示没有后续。 |

[错误码与错误对象](/docs/api/native/knowledge/errors)