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

# WorkspaceSandbox

**Ajouté dans :** `@mastra/core@1.1.0`

L'interface `WorkspaceSandbox` définit la manière dont les Workspaces exécutent des commandes et gèrent les processus en arrière-plan.

## Propriétés

**processes** (`SandboxProcessManager`): Gestionnaire des processus en arrière-plan. S'il n'est pas implémenté, les Tools de gestion des processus ne seront pas disponibles. Consultez la référence de SandboxProcessManager.

## Méthodes

### `start()`

Démarre le Sandbox. Cette méthode est appelée automatiquement par `workspace.init()` ou lors du premier appel à `executeCommand()`.

```typescript
await sandbox.start()
```

Cette méthode prépare le Sandbox à l'exécution de commandes.

### `stop()`

Arrête le Sandbox.

```typescript
await sandbox.stop?.()
```

### `destroy()`

Nettoie les ressources du Sandbox. Cette méthode est appelée par `workspace.destroy()`.

```typescript
await sandbox.destroy()
```

### `executeCommand(command, args?, options?)`

Exécute une commande shell.

```typescript
const result = await sandbox.executeCommand('ls', ['-la', '/docs'])
const result = await sandbox.executeCommand('npm', ['install', 'lodash'])
```

**Paramètres :**

**command** (`string`): Commande à exécuter

**args** (`string[]`): Arguments de la commande

**options** (`Options`): Options de configuration.

**options.timeout** (`number`): Délai d'expiration de l'exécution, en millisecondes

**options.cwd** (`string`): Répertoire de travail de la commande

**options.env** (`Record<string, string>`): Variables d'environnement supplémentaires

**options.onStdout** (`(data: string) => void`): Fonction de rappel pour le flux de sortie standard

**options.onStderr** (`(data: string) => void`): Fonction de rappel pour le flux d'erreur standard

### `getInfo()`

Renvoie l'état du Sandbox et les informations sur ses ressources.

```typescript
const info = await sandbox.getInfo()
// { status: 'running', resources: { memoryMB: 512, cpuPercent: 5 } }
```

### `getInstructions(opts?)`

Renvoie une description du fonctionnement de ce Sandbox. Elle est injectée dans le message système de l'Agent lorsque le Workspace lui est attribué.

```typescript
const instructions = sandbox.getInstructions?.()
// 'Local command execution. Working directory: "/workspace".'
```

**Paramètres :**

**opts.requestContext** (`RequestContext`): Transmis à la fonction instructions si celle-ci a été fournie au constructeur.

**Renvoie :** `string`

## Voir aussi

- [Référence de SandboxProcessManager](https://mastra.zisheng.pro/fr/reference/workspace/process-manager)
- [Sandbox](https://mastra.zisheng.pro/fr/docs/workspace/sandbox)
- [Classe Workspace](https://mastra.zisheng.pro/fr/reference/workspace/workspace-class)
- [Interface de système de fichiers](https://mastra.zisheng.pro/fr/reference/workspace/filesystem)