AgentFSFilesystem

Stocke les fichiers dans une base de données Turso/SQLite par l’intermédiaire du SDK AgentFS. Les fichiers sont conservés d’une session à l’autre dans une base de données SQLite locale, ce qui fournit aux Agents un stockage durable sans service cloud externe. Pour plus de détails sur l’interface, consultez l’interface WorkspaceFilesystem.

Installation

npm

npm install @mastra/agentfs

pnpm

pnpm add @mastra/agentfs

Yarn

yarn add @mastra/agentfs

Bun

bun add @mastra/agentfs

Utilisation

Ajoutez un AgentFSFilesystem à un Workspace et attribuez-le à un Agent. Vous devez fournir au moins l’une des valeurs agentId, path ou agent lors de l’instanciation de la classe AgentFSFilesystem.

import { Agent } from '@mastra/core/agent'
import { Workspace } from '@mastra/core/workspace'
import { AgentFSFilesystem } from '@mastra/agentfs'

const workspace = new Workspace({
  filesystem: new AgentFSFilesystem({
    agentId: 'my-agent',
  }),
})

const agent = new Agent({
  id: 'file-agent',
  name: 'file-agent',
  model: 'openai/gpt-5.6-sol',
  workspace,
})

Utiliser un chemin de base de données explicite

Par défaut, les bases de données sont stockées dans le répertoire .agentfs, avec l’agentId comme nom de fichier. Vous pouvez indiquer un chemin de base de données personnalisé :

import { AgentFSFilesystem } from '@mastra/agentfs'

const filesystem = new AgentFSFilesystem({
  path: '/data/my-agent.db',
})

Utiliser une instance AgentFS déjà ouverte

Si vous devez gérer vous-même le cycle de vie d’AgentFS :

import { AgentFS } from 'agentfs-sdk'
import { AgentFSFilesystem } from '@mastra/agentfs'

const agent = await AgentFS.open({ id: 'my-agent' })

const filesystem = new AgentFSFilesystem({
  agent, // caller manages open/close
})

Paramètres du constructeur

Vous devez fournir au moins l’une des valeurs agentId, path ou agent.

agentId?:

string

ID de l’Agent ; crée la base de données dans .agentfs/<agentId>.db

path?:

string

Chemin explicite du fichier de base de données, utilisé à la place d’agentId

agent?:

AgentFS

Instance AgentFS déjà ouverte. Lorsqu’elle est fournie, l’appelant gère son cycle de vie, notamment son ouverture et sa fermeture.

id?:

string

= Auto-generated

Identifiant unique de cette instance de système de fichiers

displayName?:

string

= 'AgentFS'

Nom d’affichage lisible dans l’interface utilisateur

icon?:

FilesystemIcon

= 'database'

Identifiant de l’icône dans l’interface utilisateur

description?:

string

Courte description de ce système de fichiers pour l’interface utilisateur

readOnly?:

boolean

= false

Lorsque la valeur est true, toutes les opérations d’écriture sont bloquées

Propriétés

id:

string

Identifiant de l’instance du système de fichiers

name:

string

Nom du Provider ('AgentFSFilesystem')

provider:

string

Identifiant du Provider ('agentfs')

readOnly:

boolean | undefined

Indique si le système de fichiers est en mode lecture seule