Open Index icon

Open Index

Open Index 是一款用于 AI agent 的开源结构化上下文层,帮助开发者构建可搜索的领域专属“知识大脑”,支持本地或通过 HTTP 读取、更新与服务。

Open Index

概述

Open Index 是一款用于为 AI agents 构建结构化上下文层的开源工具。它允许你将一个领域定义为一组文档类型、实体和关系,然后对这些数据进行存储与搜索,使 agents 能够基于比非结构化提示词或文档堆栈更精确的内容进行操作。

该项目围绕一个可创建于本地、通过 stdio 或 HTTP 提供给 agents、并可通过手动编辑或连接器驱动导入保持最新的“知识大脑”来设计。默认配置使用带有 FTS5 的 SQLite,而在需要独立搜索后端的远程或多写入者部署中,也可使用 OpenSearch。

核心能力

结构化领域模型

将一个领域建模为 doc_types、entities 和 relationships,让“知识大脑”拥有明确定义的结构,而不是扁平的提示词或零散笔记。

搜索与检索

可通过终端或 MCP 层搜索实体;在 SQLite 路径下支持模糊搜索和容错拼写,在 OpenSearch 中支持原生 k-NN 搜索。

双存储模式

可按 doc type 选择基于文件或基于索引的存储,把不同类型的数据放在合适的位置,有助于区分人工整理内容与连接器导入的数据。

连接器导入与定时更新

通过运行连接器同步外部数据,包括基于 MCP 的导入,并可通过内置的 run 命令安排连接器定时执行。

MCP 服务与远程访问

通过 stdio 或 HTTP 将“知识大脑”暴露给 agents;远程 HTTP 服务支持 bearer token 认证,并可通过 config 命令打印 MCP 块以便进行 agent 配置。

验证与浏览器 UI

可校验 schema、“知识大脑”设置和实体文件,并提供包含“如何使用”“Schema”“探索”“映射”“分析”和“任务”视图的 UI 供检查。

实际使用场景

  • 客户支持知识大脑

    支持团队可以将产品、问题、用户群和评论建模,让 agents 搜索已知问题,并在新案例出现时保持支持知识的最新状态。

  • 运维与运行手册上下文

    基础设施团队可以将服务、仪表盘、运行手册和告警存入“知识大脑”,让 agents 在排障或更新运维上下文时进行查询。

  • 销售与客户跟踪

    销售或客户管理流程可以映射客户、商机及相关记录,让 agents 基于结构化流程而不是零散笔记开展工作。

  • 本地 agent 设置

    个人开发者可以在仓库中启动一个本地“知识大脑”,为其建立索引,并连接 Claude Code 或其他 MCP 客户端,而无需单独托管服务。

Pros and Cons

Pros

  • 让你能够定义结构化的领域概念,而不是只依赖非结构化上下文。
  • 同时支持本地 stdio 和远程 HTTP 服务,既适合个人使用,也适合团队共享部署。
  • 可以将受 git 跟踪的人工整理实体保存在文件中,同时也支持由搜索数据库管理的基于索引的数据。
  • 包含验证、索引、搜索以及用于在设置后浏览“知识大脑”的 UI。
  • 提供可移植的 Agent Skills 文件以及面向 Claude Code 的便捷配置。

Cons

  • SQLite 是单写入者,因此当有多个写入者需要更新“知识大脑”时,远程或协作式部署需要使用 OpenSearch 路径。
  • 仓库说明 OpenSearch 只在 Docker 路径中预先配置;如果在 Docker 之外运行,你需要自行运维该集群。
  • 文档展示了基于 schema、实体文件、MCP 连接和部署选择的较技术化设置,因此更适合熟悉开发者工具的用户。

FAQ

Open Index 有什么作用?

Open Index 是一个面向 AI agents 的上下文层:它将领域概念存储为结构化实体,支持搜索,并通过 MCP 服务器对外提供,让 agents 可以读写同一个“知识大脑”。

Open Index 如何部署?

仓库展示了本地 stdio 模式、远程 HTTP 模式以及基于 Docker 的部署路径。部署指南说明,本地部署通常适合在一台机器上运行的单个 agent,而远程部署适合团队、云端 agent 或共享同一个“知识大脑”的 CI。

Agents 可以同时读取和写入上下文吗?

可以。文档说明 read 和 write 是默认的 MCP 模式。Agents 可以使用 navigation_guidelines()、search_brain() 和 get_entity() 获取上下文,也可以使用 put_entity() 和 create_doc_type() 更新“知识大脑”。

Open Index 支持 Claude Code 或其他 agent 运行时吗?

可以。文档说明 open-index init 会生成 .mcp.json、CLAUDE.md 和一个编辑技能文件,作为 Claude Code 的便捷配置;该项目也提供了一个可移植的 Agent Skills 文件,供其他运行时使用。

Open Index 支持哪些搜索后端?

项目默认使用带有 FTS5 的 SQLite,并且可以切换到 OpenSearch 以支持远程或多写入者场景。部署指南指出,SQLite 是单写入者,而当多个 agent 需要写入或需要更大规模的语义搜索工作负载时,OpenSearch 是可选方案。

Quick Facts

类别
开发者工具
源域名
github.com
产品类型
开源 agent 上下文层
默认搜索后端
SQLite + FTS5
远程服务
支持 bearer token 认证的 HTTP
主要用户
构建领域专属 AI agents 的开发者