知识库
事件
请求字段、响应对象和当前限制。
路径中的 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 |
请求示例
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 表示没有后续。 |