Open Index icon

Open Index

Open Index 是一個開源的 AI agents 結構化上下文層,協助開發者建立可搜尋的領域知識庫,供 agents 本機或透過 HTTP 讀取、更新與提供服務。

Open Index

概覽

Open Index 是一個用於為 AI agents 建立結構化上下文層的開源工具。它讓你將一個領域定義為一組 doc types、entities 和 relationships,接著儲存並搜尋這些資料,讓 agents 能在比非結構化提示或文件傾倒更精確的內容上運作。

此專案以可建立在本機、透過 stdio 或 HTTP 提供給 agents 服務,並可透過手動編輯或由連接器驅動的匯入維持最新狀態的「brain」為核心。預設設定使用 SQLite 與 FTS5,而 OpenSearch 則可用於需要獨立搜尋後端的遠端或多寫入者部署。

核心功能

結構化領域模型

將一個領域建模為 doc_types、entities 與 relationships,讓 brain 擁有明確結構,而不是扁平的提示或臨時筆記。

搜尋與檢索

可從終端機或透過 MCP 層搜尋實體;SQLite 路徑支援模糊、容錯拼字搜尋,而 OpenSearch 則支援原生 k-NN 搜尋。

雙重儲存模式

透過依 doc type 選擇檔案支援或索引支援的儲存方式,將不同類型的資料放在適當位置,有助於區分經人工整理的內容與由連接器匯入的資料。

連接器匯入與排程更新

透過執行連接器來同步外部資料,包括基於 MCP 的匯入,並可透過內建的 run 指令排程連接器執行。

MCP 服務與遠端存取

可透過 stdio 或 HTTP 將 brain 暴露給 agents;遠端 HTTP 服務支援 bearer-token 驗證,並提供 config 指令輸出供 agent 設定用的 MCP 區塊。

驗證與探索 UI

可驗證 schema、brain 設定與實體檔案,並提供包含 How to use、Schema、Explore、Map、Analytics 與 Jobs 檢視的 UI 以供檢查。

實際使用案例

  • 客戶支援知識 brain

    支援團隊可以將產品、問題、區段與留言建模,讓 agents 能搜尋已知問題,並在新案例出現時維持支援知識的最新狀態。

  • 營運與 runbook 上下文

    基礎架構團隊可以在 brain 中儲存服務、儀表板、runbooks 與警報,讓 agents 在排除問題或更新作業上下文時查詢。

  • 業務與客戶追蹤

    業務或客戶管理流程可以對客戶、交易與相關紀錄進行映射,讓 agents 依據結構化管道作業,而不是零散筆記。

  • 本機 agent 設定

    單人開發者可以在儲存庫中啟動本機 brain、建立索引,並連接 Claude Code 或其他 MCP client,而不需要另行代管服務。

Pros and Cons

Pros

  • 讓你定義結構化的領域概念,而不必只依賴非結構化上下文。
  • 同時支援本機 stdio 與遠端 HTTP 服務,可涵蓋單人使用與團隊共享設定。
  • 可將經過整理、以 git 追蹤的實體存放在檔案中,同時也支援由搜尋資料庫擁有的索引式資料。
  • 包含驗證、索引、搜尋,以及設定完成後可用來探索 brain 的 UI。
  • 提供可攜式的 Agent Skills 檔案與 Claude Code 的便利功能,協助 agent 設定。

Cons

  • SQLite 是單一寫入者,因此當不只一個寫入者會更新 brain 時,遠端或協作式設定需要使用 OpenSearch 路徑。
  • 儲存庫註明 OpenSearch 只在 Docker 路徑中預先設定;若要在 Docker 外執行,則需要自行維運叢集。
  • 文件展示了一套相當技術性的設定,包含 schema、實體檔案、MCP 串接與部署選擇,因此較適合熟悉開發者工具的使用者。

FAQ

Open Index 是做什麼的?

Open Index 是 AI agents 的上下文層:它會將領域概念儲存為結構化實體、可進行搜尋,並透過 MCP 伺服器提供給 agents,使它們可以讀取與更新同一個 brain。

Open Index 如何部署?

該儲存庫展示了本機 stdio 模式、遠端 HTTP 模式,以及以 Docker 為基礎的部署路徑。部署指南指出,本機設定通常用於單一機器上的單一 agent,而遠端設定則適合需要共享同一個 brain 的團隊、雲端 agents 或 CI。

agents 可以同時讀取和寫入上下文嗎?

可以。文件說明預設的 MCP 模式同時支援讀取與寫入。agents 可以使用 navigation_guidelines()、search_brain() 與 get_entity() 取得上下文,並用 put_entity() 與 create_doc_type() 更新 brain。

Open Index 支援 Claude Code 或其他 agent 執行環境嗎?

可以。文件指出 open-index init 會為 Claude Code 建立 .mcp.json、CLAUDE.md 與編輯技能作為便利功能,而專案也為其他執行環境提供可攜式的 Agent Skills 檔案。

Open Index 支援哪些搜尋後端?

該專案預設使用 SQLite 與 FTS5,並可切換到 OpenSearch 以支援遠端或多寫入者設定。部署指南註明 SQLite 是單一寫入者,而當有多個 agents 寫入或需要更大型的語意搜尋工作負載時,OpenSearch 是可用選項。

Quick Facts

類別
開發者工具
來源網域
github.com
產品類型
開源 agent 上下文層
預設搜尋後端
SQLite + FTS5
遠端服務
具備 bearer-token 驗證的 HTTP
主要使用者
建立領域專屬 AI agents 的開發者