知识库与 Explore API

知识 API 管理语义模型及使内容可检索的数据来源；Explore API 管理问答 Session、选定的 数据源、消息和反馈。来源已经加入模型，不代表它已经完成索引并可被检索。

语义模型

方法与路径

用途

GET /newmoi/semantic-models

列出语义模型

POST /newmoi/semantic-models

创建语义模型

GET /newmoi/semantic-models/:model_id

读取模型

PUT /newmoi/semantic-models/:model_id

更新模型

DELETE /newmoi/semantic-models/:model_id

删除模型

POST .../:model_id/validate

校验模型语义

POST .../:model_id/import

导入模型定义

GET .../:model_id/export

导出模型定义

Entry 位于 /newmoi/semantic-models/:model_id/entries，支持列表、创建、更新与删除。 Entry kind 和 spec 都是契约定义值，不能自行编造自由格式的类型。

来源、文档与分段

来源生命周期包括选择预览、存在性检查、追加、列表、移除、文档读取和治理。本地文件上传 使用 /newmoi/semantic-models/local-files/upload 或其模型级变体。来源任务可通过 .../:model_id/source-jobs 查询，并通过 .../source-jobs/reconcile 执行 Reconcile。

文档来源的分段接口位于：

/newmoi/semantic-models/:model_id/sources/:source_row_id/segments

契约覆盖初始导入、创建、编辑、启停、删除、重新 Embedding，以及选择当前分段版本。 表来源与文档来源的治理操作不同；两者即使出现在同一知识库中，也不能把文档分段操作 套用于表来源。

添加或修改来源后，应持续查询来源任务，直到处理和 Reconcile 完成。若仍检索不到内容， 应先检查来源是否启用、当前分段版本、Embedding 配置与调用者权限，不要直接重复提交 来源。

Explore Session

方法与路径

用途

POST /newmoi/sessions

创建 Session

POST /newmoi/sessions/list

列出 Session

POST /newmoi/sessions/pinned/list

列出已置顶 Session

POST /newmoi/sessions/unpinned/list

列出未置顶 Session

GET /newmoi/sessions/:id

读取 Session

PUT /newmoi/sessions/:id

更新 Session

PUT 或 DELETE /newmoi/sessions/:id/pin

置顶或取消置顶

DELETE /newmoi/sessions/:id

删除 Session

消息接口支持列出 Session 消息、获取最新消息 ID、读取 / 删除消息以及提交赞 / 踩反馈。 消息列表所需的 ID 格式以部署契约为准；除非接口明确要求，不能把不透明的 Session ID 自行转换成整数。

查询选定数据

Explore 数据源发现使用 /newmoi/table/overview、 /newmoi/table/database/tables 和 /newmoi/table/columns。查询来源应由服务端 返回的 Catalog、数据库、表和语义模型 ID 构造；存在同名结果时，不能只按显示名称选择。

Explore 答案可通过 SSE / A2A 风格事件流返回计划、来源和答案更新。客户端应按事件类型 解析，把引用保留为结构化数据，并在终止事件结束。流中断时，Session 或部分消息可能 已经创建；重试问题前先重新读取 Session。

Agent 绑定知识库见 Agent 与 A2A；模型 Provider 与 Embedding 配置见 模型与 Provider。

最后更新于