> Discover all available pages from the documentation index: https://mastra.zisheng.pro/fr/llms.txt

# AgentFSFilesystem

Stocke les fichiers dans une base de données Turso/SQLite par l’intermédiaire du SDK [AgentFS](https://github.com/nichochar/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](https://mastra.zisheng.pro/fr/reference/workspace/filesystem).

## Installation

**npm**:

```bash
npm install @mastra/agentfs
```

**pnpm**:

```bash
pnpm add @mastra/agentfs
```

**Yarn**:

```bash
yarn add @mastra/agentfs
```

**Bun**:

```bash
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`.

```typescript
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é :

```typescript
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 :

```typescript
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`): Identifiant unique de cette instance de système de fichiers (Default: `Auto-generated`)

**displayName** (`string`): Nom d’affichage lisible dans l’interface utilisateur (Default: `'AgentFS'`)

**icon** (`FilesystemIcon`): Identifiant de l’icône dans l’interface utilisateur (Default: `'database'`)

**description** (`string`): Courte description de ce système de fichiers pour l’interface utilisateur

**readOnly** (`boolean`): Lorsque la valeur est true, toutes les opérations d’écriture sont bloquées (Default: `false`)

## 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