Tutoriel : votre premier lancement de Sidekicks

 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
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97

# Tutoriel : votre premier lancement de Sidekicks

À la fin de ce tutoriel, vous aurez écrit une configuration avec un agent, ouvert Sidekicks avec elle, démarré Alice depuis l'interface, lu son journal, et vu Sidekicks repérer une erreur dans le fichier puis se rétablir quand vous la corrigez.

## Prérequis

- Les outils de [Comment développer l'application](../how-to/developper-l-application.md), et `make install` fait une fois.
- `mm` dans votre `PATH` et llmman lancé, avec le modèle d'Alice téléchargé (voir le tutoriel [premier échange ACP](premier-echange-acp.md)).
- Un terminal ouvert à la racine du dépôt.

## Étape 1 — Écrire une configuration

Tapez :

```bash
cat > /tmp/sidekicks-tutorial.yaml <<EOF
version: 1
ui:
  language: fr
agents:
  - name: alice
    title: Alice (assistante)
    icon: "👩"
    command: $PWD/scripts/agents.sh
    args: [run, alice]
    workspace: $PWD/agents/alice
channels:
  - name: général
    agents: [alice]
EOF
```

Nous avons maintenant une configuration avec un agent, Alice, lancé par le script du projet. La ligne `language: fr` affiche l'interface en français ; sans elle, l'interface est en anglais.

## Étape 2 — Ouvrir Sidekicks avec cette configuration

Tapez :

```bash
SIDEKICKS_CONFIG=/tmp/sidekicks-tutorial.yaml make dev
```

Après une minute la première fois, la fenêtre de Sidekicks s'ouvre. Vous devriez voir, à gauche, **CHANNELS** avec `# général`, et **AGENTS** avec `👩 Alice (assistante)` et le mot « arrêté » en dessous. En bas, la barre d'état indique « 0 agent actif ».

## Étape 3 — Démarrer Alice

Passez la souris sur Alice : un bouton ▶ apparaît à droite. Cliquez dessus.

Vous devriez voir la pastille d'Alice passer à l'orange (« démarre… ») puis au vert (« prêt »), et la barre d'état indiquer « 1 agent actif ».

## Étape 4 — Lire son journal

Cliquez sur **Journal** dans la barre d'état. Un panneau s'ouvre en bas avec les lignes d'Alice, en commençant par :

```text
mm v1.0.3 | config: …/agents/alice/agent.yaml | provider: llmman | …
[acp] initialize: client "sidekicks" protocolVersion=1 …
```

C'est ce qu'Alice écrit pour qui s'occupe de l'agent ; Sidekicks le garde pour vous.

## Étape 5 — Faire une erreur exprès

Cliquez sur **Settings** dans la barre d'état. Il indique « ✓ Configuration valide ». Puis, dans un second terminal, cassez le fichier :

```bash
sed -i.bak 's/    command:/    comand:/' /tmp/sidekicks-tutorial.yaml
```

En moins d'une seconde, un bandeau rouge apparaît au centre, et **Settings** affiche :

```text
ligne 3 — agents[0] : il manque la clé « command »
ligne 6 — agents[0].comand : clé inconnue « comand » ; vouliez-vous dire « command » ?
```

Alice est toujours listée : Sidekicks garde la dernière configuration valide.

## Étape 6 — Corriger

```bash
mv /tmp/sidekicks-tutorial.yaml.bak /tmp/sidekicks-tutorial.yaml
```

Le bandeau disparaît et Settings affiche de nouveau « ✓ Configuration valide », sans redémarrer.

## Étape 7 — Arrêter

Passez sur Alice et cliquez sur ■ : sa pastille devient grise. Fermez la fenêtre : si Alice tournait encore, Sidekicks aurait arrêté l'agent et libéré son modèle.

## Et maintenant ?

Vous avez lancé Sidekicks, piloté la vie d'un agent et vu comment la configuration est vérifiée. Pour aller plus loin :

- Toutes les clés du fichier → [Référence : le fichier de configuration](../reference/configuration.md)
- Ce que veut dire chaque état → [Référence : agents, channels et événements](../reference/agents-et-evenements.md)
- Pourquoi les agents démarrent et s'arrêtent ainsi → [Mémoire et modèles locaux](../explanation/memoire-et-modeles-locaux.md)