---
title: "Agent 混合搜索场景概述 - OceanBase Database AI V4.6.2 | OceanBase 文档中心"
description: Agent 混合搜索场景概述 说明 本功能在当前版本为实验特性。 Agent 混合搜索场景面向 AI Agent 应用中的记忆、知识库与多用户空间搜索需求：每个用户、每个 Agent、每个会话往往需要独立的数据隔离域，规模可达海量。若为每个隔离域创建独立物理表，元数据与资源开销会随数量线性放大。 本场景基于 Ocea…
image: https://mdn.alipayobjects.com/huamei_22khvb/afts/img/A*OSPzQ6GUQF4AAAAAQHAAAAgAeiGDAQ/original
---
切换语言

- 中文站 - 简体中文
- International - English
- 日本站 - 日本語

文档反馈![](https://mdn.alipayobjects.com/huamei_22khvb/afts/img/A*inJjSpyNOjUAAAAAHtAAAAgAeiGDAQ/original) OceanBase Database AIV 4.6.2

# Agent 混合搜索场景概述

更新时间：2026-08-13 19:27:47

[编辑](https://github.com/oceanbase/oceanbase-database-ai/edit/V4.6.2/zh-CN/250.database-schema-design/600.logical-table/100.agent-hybrid-search-scene/100.overview.md)

#### 说明

本功能在当前版本为实验特性。

Agent 混合搜索场景面向 AI Agent 应用中的记忆、知识库与多用户空间搜索需求：每个用户、每个 Agent、每个会话往往需要独立的数据隔离域，规模可达海量。若为每个隔离域创建独立物理表，元数据与资源开销会随数量线性放大。

本场景基于 OceanBase Database AI 的逻辑表（Logical Table）能力，通过 pyseekdb SDK（`use_namespace=True`）将多个 Namespace 的数据共享底层存储、在逻辑上完成隔离。开发者看到的是独立的 Namespace，无需为每个隔离域创建独立物理表，并在同一套对象模型上完成向量搜索、全文搜索与混合搜索。通过 pyseekdb SDK 基于 Namespace 的用户接口，可以实现多个 Namespace 的数据共享底层存储，在逻辑上完成隔离。

## 核心对象模型

```shell
Client
  └── Collection
        └── Namespace
              └── Record

```

| **对象** | **说明** |
| --- | --- |
| Client | 连接 OceanBase 的入口，管理 Collection 的创建与获取。 |
| Collection | 顶层容器，决定了向量维度、索引类型、分词器等 Schema 配置。一个 Collection 可容纳海量 Namespace。Collection 本身不直接承载数据操作。 |
| Namespace | 数据隔离的基本单元。每个 Namespace 有独立的 `namespace_id`，数据在存储层按 Namespace 隔离。所有 DML 和 DQL 操作都在 Namespace 上执行。 |
| Record | 逻辑概念，表示一条数据记录，由四元组构成，详见下表。 |

Record 四元组具体如下：

| **字段** | **类型** | **说明** |
| --- | --- | --- |
| id | string | 业务主键，在 Namespace 内唯一 |
| document | string | 文本内容，用于全文搜索和自动向量化 |
| embedding | list[float] | 稠密向量，用于向量相似度搜索 |
| metadata | dictionary | 结构化元数据（JSON），用于条件过滤 |

## 核心能力

| **能力** | **说明** |
| --- | --- |
| 大规模用户空间隔离 | 单个 Collection 下可创建海量 Namespace，每个 Namespace 拥有独立数据空间。 |
| 向量搜索 | 基于 IVF 索引的高性能近似最近邻搜索，支持 l2 / cosine / inner_product 距离。 |
| 全文搜索 | 支持 IK / Space / Ngram / Ngram2 / Beng 多种分词器的全文索引。 |
| 混合搜索 | 向量 + 全文多路召回路径，RRF 融合排序。 |
| 在线索引维护 | SPFresh 机制保持 IVF 索引写入后召回率不衰减。 |
| 自动嵌入 | 配置嵌入函数后，写入文本自动生成稠密向量。 |

## pyseekdb SDK 工作模式

pyseekdb 支持两种工作模式，通过 `create_collection` 的 `use_namespace` 参数切换：

| **对比项** | **use_namespace=False（默认）** | **use_namespace=True** |
| --- | --- | --- |
| **适用场景** | 单用户空间、小规模数据 | 多用户空间、大规模数据隔离 |
| **数据隔离** | 无 Namespace 概念，数据直接在 Collection 级别操作 | 通过 Namespace 隔离，不同 Namespace 数据互不可见 |
| **预热** | 不支持 | 远程共享存储部署支持 `namespace.prewarm()` 接口 |
| **冷热分离** | 不支持 | 远程共享存储部署支持热 Namespace 自动过期 |
| **数据操作入口** | `collection.add()` / `collection.query()` | `namespace.add()` / `namespace.query()` |

补充说明如下：

- 本场景使用 `use_namespace=True`。如果只有一份数据、无需多用户空间隔离，可用默认模式（`use_namespace=False`）。
 - 当前 SDK 不支持弱读；Namespace 模式下读写按数据库默认强一致路径使用。

## 适用场景

| **落地方式** | **说明** | **Namespace 粒度建议** |
| --- | --- | --- |
| **Agent Memory** | 对话记忆存储与语义搜索，存储历史消息、上下文和记忆 | 每个 Agent 实例一个 Namespace |
| **RAG 知识库** | 文档切片后的向量 + 全文混合搜索 | 每个知识库一个 Namespace |
| **Codebase 搜索** | 代码片段的语义搜索（如 Cursor Codebase） | 每个代码仓库一个 Namespace |
| **多用户空间 SaaS** | 用户空间间数据严格隔离，访问限流，共享底层物理存储 | 每个用户空间一个 Namespace |

 上一篇 下一篇 ![有帮助](https://gw.alipayobjects.com/mdn/ob_asset/afts/img/A*y6ocSqN8cqsAAAAAAAAAAAAAARQnAQ)![无帮助](https://gw.alipayobjects.com/mdn/ob_asset/afts/img/A*BG9IQJyLHF8AAAAAAAAAAAAAARQnAQ)![反馈](https://gw.alipayobjects.com/mdn/ob_asset/afts/img/A*eTWdQKCRKHwAAAAAAAAAAAAAARQnAQ)[AI](https://www.oceanbase.com/obi) 咨询热线