Comment lancer un agent de test sans saturer la machine

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61

# Comment lancer un agent de test sans saturer la machine

Ce guide montre comment démarrer un des agents de test (Alice, Bob, Riker, Garfield) pour des tests manuels, pour un client ACP comme Zed, ou pour un script. Il suppose que `mm` et llmman sont installés (voir le [tutoriel](../tutorials/premier-echange-acp.md)).

## Démarrer un agent pour un client ACP

Démarrez toujours les agents avec le script, jamais avec `mm` directement :

```bash
scripts/agents.sh run garfield
```

L'agent sert alors ACP sur stdin/stdout. Quand il s'arrête, son slot est libéré et son modèle déchargé. Un troisième agent est refusé :

```text
agents.sh: 2 agent(s) already running, the limit is 2:
  alice.41211
  bob.41388
```

## L'utiliser depuis Zed ou un autre client ACP

Déclarez le script comme commande de l'agent, avec un chemin absolu :

```json
"agent_servers": {
  "Garfield (test)": {
    "type": "custom",
    "command": "/chemin/vers/sidekicks/scripts/agents.sh",
    "args": ["run", "garfield"]
  }
}
```

## Choisir le bon agent

| Pour tester | Agent |
| --- | --- |
| Une conversation simple | `alice` (ou `bob` comme second agent) |
| Les tool calls et les demandes de permission | `riker` |
| Les commandes slash et les skills | `garfield` |

## Vérifier et libérer la mémoire

```bash
scripts/agents.sh ps              # agents actifs, modèles chargés
scripts/agents.sh unload riker    # décharger le modèle d'un agent, s'il est chargé
scripts/agents.sh unload --all    # décharger tous les modèles chargés
```

## Variantes

- **`mm` n'est pas dans le `PATH`** : `MM_BIN=/chemin/vers/mm scripts/agents.sh run alice`.
- **Dans une sandbox Docker** : rien à faire ; le script trouve llmman sur `host.docker.internal:17434` quand `127.0.0.1:17434` ne répond pas. Définissez `LLMMAN_URL` pour imposer une adresse.
- **Garder le modèle chargé entre deux lancements** (tests répétés plus rapides) : `SIDEKICKS_NO_UNLOAD=1 scripts/agents.sh run alice`.
- **Un slot reste pris après un crash** : il se libère tout seul dès que son processus a disparu ; si `ps` bloque sur « could not lock », supprimez `.run/agents/.lock`.

## Voir aussi

- Toutes les commandes et variables → [Référence : scripts/agents.sh](../reference/script-agents.md)
- Pourquoi deux agents au plus → [Mémoire et modèles locaux](../explanation/memoire-et-modeles-locaux.md)