# 知识库 API (/docs/api/native/knowledge)



（待译）

Knowledge turns uploaded files into searchable knowledge bases with asynchronous ingestion and inspectable text segments. Concepts and behavior follow OpenAI vector stores (stores, file attachments, batches and search), so OpenAI vector stores experience applies. Differences: search has no next page (native results count chunks, while the compatible URL groups files); auto ranking does not rerank, so request default-2024-11-15 for reranking; chunk sizes use estimated tokens rather than a model tokenizer; ingestion accepts at most 100000000 bytes per file and also supports images and XLSX; native deletion retains a readable, restorable store for seven days. Start with `praxis.knowledge.vectorStores.create`, passing file\_ids from File uploads to begin ingestion.

把文件加入知识库，按语义和关键词搜索相关分段。使用 API Key 作为 Bearer 凭据，建议从服务端调用。

`https://api.deepraxis.ai/knowledge/v1`

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

| 资源                                        | 用途               |
| ----------------------------------------- | ---------------- |
| [知识库](/docs/api/native/knowledge/stores)  | 创建、读取、更新、删除与恢复   |
| [文件](/docs/api/native/knowledge/files)    | 添加、读取、更新属性、移除与重试 |
| [批量](/docs/api/native/knowledge/batches)  | 成批添加文件、读取状态与取消   |
| [搜索](/docs/api/native/knowledge/search)   | 检索相关文本分段         |
| [分段](/docs/api/native/knowledge/segments) | 读取分段、位置与关键词      |
| [事件](/docs/api/native/knowledge/events)   | 读取知识库与文件处理事件     |

[错误码](/docs/api/native/knowledge/errors) · [上限与格式支持](/docs/cloud/services/knowledge/limits-and-errors) · [OpenAI vector stores](/docs/api/compatible/openai/vector-stores)