Tutoriel : votre premier agent, sans écrire de configuration

 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

# Tutoriel : votre premier agent, sans écrire de configuration

À la fin de ce tutoriel, vous aurez ajouté un agent à Sidekicks avec l'assistant « Ajouter un agent », discuté avec lui, et l'aurez retrouvé avec la palette de commandes. Vous n'ouvrirez pas une seule fois le fichier de configuration.

## Prérequis

- Sidekicks installé : voir [Installer Sidekicks](../how-to/installer-sidekicks.md).
- `mm` installé, et llmman démarré avec le modèle d'Alice téléchargé (voir [Votre premier échange ACP avec un agent de test](premier-echange-acp.md)).
- Le dépôt de Sidekicks sur votre ordinateur : le dossier d'Alice, `agents/alice`, contient son `agent.yaml`. Ci-dessous, c'est `~/sidekicks/agents/alice` ; utilisez votre propre chemin.

L'interface est en anglais par défaut ; avec `ui.language: fr`, elle est en français. Les libellés ci-dessous sont ceux de l'interface en français.

## Étape 1 — Ouvrir Sidekicks

Ouvrez Sidekicks depuis votre dossier Applications (ou votre menu d'applications).

Vous devez voir le logo de Sidekicks, « Bienvenue dans Sidekicks », trois étapes numérotées et un bouton bleu **＋ Ajouter mon premier agent**. Si des agents sont déjà listés à gauche, utilisez plutôt **＋ Ajouter un agent** sous la liste : la suite est identique.

## Étape 2 — Dire qui est l'agent

Cliquez sur **＋ Ajouter mon premier agent**. Dans **Nom affiché**, tapez :

```text
Alice (assistante)
```

Vous devez voir **Nom utilisé avec @** se remplir tout seul avec `alice-assistante`. Remplacez-le par `alice` : c'est le nom avec lequel vous l'appellerez.

## Étape 3 — Dire comment le démarrer

Laissez **Sur cet ordinateur** sélectionné. Remplissez :

| Champ | Valeur |
| --- | --- |
| Programme | `mm` |
| Arguments | `-acp -config agent.yaml` |
| Dossier de l'agent | `~/sidekicks/agents/alice` (ou **Choisir…** puis le dossier) |

Cliquez sur **Ajouter l'agent**.

Vous devez voir l'assistant se fermer, **🤖 Alice (assistante)** apparaître sous **AGENTS** et sous **MESSAGES DIRECTS**, et sa conversation s'ouvrir au centre avec « Écrivez votre premier message à Alice (assistante). »

## Étape 4 — Discuter avec Alice

Cliquez dans la zone de texte en bas, tapez ceci et appuyez sur Entrée :

```text
Bonjour Alice, présente-toi en une phrase.
```

Vous devez voir la pastille d'Alice passer à l'orange pendant qu'elle démarre et répond, puis sa phrase s'afficher mot à mot.

## Étape 5 — La retrouver au clavier

Cliquez sur **# general** à gauche. Puis appuyez sur **⌘K** (Ctrl+K sous Linux et Windows) et tapez `ali`.

Vous devez voir une liste avec **Alice (assistante)** en premier. Appuyez sur Entrée : sa conversation revient au centre.

## Et maintenant ?

Vous avez ajouté un agent sans toucher au YAML, discuté avec lui et circulé au clavier. Pour aller plus loin :

- Pour ajouter un agent qui tourne dans Docker ou dans une sandbox sbx → [Ajouter un agent](../how-to/ajouter-un-agent.md)
- Pour réunir plusieurs agents dans un channel → [Un channel avec deux agents](premier-channel.md)
- Tous les raccourcis → [Raccourcis clavier](../reference/raccourcis-clavier.md)
- Ce que l'assistant a écrit → [Le fichier de configuration](../reference/configuration.md)