儲存空間

Mastra 會透過 src/mastra/ 直屬的 storage.ts 檔案設定項目的預設儲存空間。該檔案會預設匯出一個儲存空間，取代記憶體、Workflow、可觀測性及其他儲存領域所使用的內置記憶體內儲存空間。

本頁說明檔案式慣例。如需了解後端選擇、儲存領域、保留政策及 Provider 詳情，請參閱儲存空間概覽。

快速開始

使用 LibSQLStore 建立由本機檔案支援的儲存空間：

src/mastra/storage.ts

import { LibSQLStore } from '@mastra/libsql'

export default new LibSQLStore({
  id: 'mastra-storage',
  url: 'file:./mastra.db',
})

Mastra 會先註冊此儲存空間，然後才註冊檔案式 Agent 和 Workflow，因此依賴儲存空間的基礎功能會連接至此儲存空間，而非預設的記憶體內儲存空間。

生產環境後端

storage.ts 可以匯出任何 Mastra 儲存適配器，例如 LibSQL、PostgreSQL 或 MongoDB。如需設定模式、Provider 支援及結構描述詳情，請參閱儲存空間概覽、可觀測性訊號支援及儲存空間參考。

與程式碼設定的優先次序

以程式碼註冊的儲存空間優先於 storage.ts。如果整個項目使用一個儲存空間已足夠，請使用 storage.ts；如果設定取決於 src/mastra/index.ts 中的執行階段連接方式，請使用程式碼註冊。