Ajouter un agent

Ce guide montre comment ajouter un agent depuis la fenêtre de Sidekicks, avec l'assistant « Ajouter un agent », quel que soit l'endroit où il tourne : sur cet ordinateur, dans un conteneur Docker ou dans une sandbox sbx. Il suppose que le programme de l'agent parle ACP (pour mm : l'argument -acp).

Étapes

Ouvrez l'assistant : ＋ Ajouter mon premier agent sur l'écran d'accueil, ＋ Ajouter un agent sous la liste des agents, ou ⇧⌘N (Ctrl+Maj+N sous Linux et Windows).
Qui est-ce ? Remplissez Nom affiché (par exemple Garfield (traducteur)). Nom utilisé avec @ le suit ; changez-le si vous en voulez un plus court (minuscules, chiffres, - et _, en commençant par une lettre). L'icône et la description sont facultatives.
Où tourne-t-il ? Choisissez l'environnement, puis remplissez ce qu'il demande (voir plus bas).
Comment le démarrer ? Remplissez Programme, Arguments (sur une ligne, comme dans un terminal ; les guillemets regroupent des mots) et Dossier de l'agent. Le dossier est créé s'il n'existe pas.
Cliquez sur Ajouter l'agent. Sa conversation directe s'ouvre dès que la configuration est rechargée.

Quand l'agent ne peut pas être ajouté (un nom déjà pris, par exemple), l'assistant dit pourquoi et n'écrit rien.

Variantes

Sur cet ordinateur : le programme tourne ici, dans le dossier de l'agent. Si Sidekicks, ouvert depuis le Finder, ne trouve pas le programme, indiquez son chemin complet (which mm dans un terminal le donne). Sidekicks lit le PATH de votre shell au démarrage : c'est rarement nécessaire.
Dans un conteneur Docker : indiquez le Nom du conteneur. Le conteneur doit tourner, avec le dossier de l'agent monté au même chemin, et contenir le programme : voir Lancer un agent dans un conteneur Docker. Sidekicks démarre l'agent avec docker exec -i <conteneur> <programme> <arguments>.
Dans une sandbox sbx : indiquez le Nom de la sandbox. Elle doit exister, avec le dossier de l'agent au même chemin : voir Lancer un agent dans une sandbox sbx. Sidekicks démarre l'agent avec sbx exec -i <sandbox> <programme> <arguments>.
Les options que l'assistant ne demande pas (env, afterStop, un autre workspacePath) : ajoutez l'agent avec l'assistant, puis complétez son entrée dans Settings.

Voir aussi

Ce que l'assistant écrit : Le fichier de configuration
Modifier ou changer la configuration
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


# Ajouter un agent

Ce guide montre comment ajouter un agent depuis la fenêtre de Sidekicks, avec l'assistant « Ajouter un agent », quel que soit l'endroit où il tourne : sur cet ordinateur, dans un conteneur Docker ou dans une sandbox sbx. Il suppose que le programme de l'agent parle ACP (pour `mm` : l'argument `-acp`).

## Étapes

1. Ouvrez l'assistant : **＋ Ajouter mon premier agent** sur l'écran d'accueil, **＋ Ajouter un agent** sous la liste des agents, ou **⇧⌘N** (Ctrl+Maj+N sous Linux et Windows).
2. **Qui est-ce ?** Remplissez **Nom affiché** (par exemple `Garfield (traducteur)`). **Nom utilisé avec @** le suit ; changez-le si vous en voulez un plus court (minuscules, chiffres, `-` et `_`, en commençant par une lettre). L'icône et la description sont facultatives.
3. **Où tourne-t-il ?** Choisissez l'environnement, puis remplissez ce qu'il demande (voir plus bas).
4. **Comment le démarrer ?** Remplissez **Programme**, **Arguments** (sur une ligne, comme dans un terminal ; les guillemets regroupent des mots) et **Dossier de l'agent**. Le dossier est créé s'il n'existe pas.
5. Cliquez sur **Ajouter l'agent**. Sa conversation directe s'ouvre dès que la configuration est rechargée.

Quand l'agent ne peut pas être ajouté (un nom déjà pris, par exemple), l'assistant dit pourquoi et n'écrit rien.

## Variantes

- **Sur cet ordinateur** : le programme tourne ici, dans le dossier de l'agent. Si Sidekicks, ouvert depuis le Finder, ne trouve pas le programme, indiquez son chemin complet (`which mm` dans un terminal le donne). Sidekicks lit le `PATH` de votre shell au démarrage : c'est rarement nécessaire.
- **Dans un conteneur Docker** : indiquez le **Nom du conteneur**. Le conteneur doit tourner, avec le dossier de l'agent monté au même chemin, et contenir le programme : voir [Lancer un agent dans un conteneur Docker](lancer-un-agent-dans-docker.md). Sidekicks démarre l'agent avec `docker exec -i <conteneur> <programme> <arguments>`.
- **Dans une sandbox sbx** : indiquez le **Nom de la sandbox**. Elle doit exister, avec le dossier de l'agent au même chemin : voir [Lancer un agent dans une sandbox sbx](lancer-un-agent-dans-une-sandbox.md). Sidekicks démarre l'agent avec `sbx exec -i <sandbox> <programme> <arguments>`.
- **Les options que l'assistant ne demande pas** (`env`, `afterStop`, un autre `workspacePath`) : ajoutez l'agent avec l'assistant, puis complétez son entrée dans **Settings**.

## Voir aussi

- Ce que l'assistant écrit : [Le fichier de configuration](../reference/configuration.md)
- [Modifier ou changer la configuration](modifier-ou-changer-la-configuration.md)
- [Tutoriel : votre premier agent, sans écrire de configuration](../tutorials/premier-agent.md)