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 : l'icône est un emoji, ou une lettre affichée dans un rond coloré ; laissée vide, le rond contient la première lettre du nom affiché.
Où tourne-t-il ? Choisissez l'environnement, puis remplissez ce qu'il demande (voir plus bas).
Comment le démarrer ? Remplissez Programme (choisissez mm, docker-agent ou docker agent dans la liste, ou tapez-en un autre), 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, depuis le fichier de configuration de l'agent : choisissez le programme, puis déposez le fichier YAML de l'agent sur Le fichier de configuration de l'agent (ou cliquez sur Choisir un fichier…). Le dossier de l'agent devient celui du fichier ; pour mm, docker-agent et docker agent, les arguments sont remplis (--acp --config <fichier>, serve acp <fichier>). Pour un autre programme, tapez les arguments. Changer de programme ensuite les remplit de nouveau. Chaque champ reste modifiable. Cela fonctionne aussi dans une sandbox sbx ou dans un conteneur Docker, si le fichier est dans un dossier que la sandbox partage, ou que le conteneur monte, au même chemin (il y est lu).
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 exister (Sidekicks le démarre s'il est arrêté), 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>. Pour que le conteneur soit recréé quand il a disparu, déposez son compose.yaml sur Recréer le conteneur s'il a disparu et choisissez le service, ou tapez les commandes : voir Redémarrer ou recréer le conteneur.
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>. Pour que la sandbox soit recréée quand elle a disparu, déposez son sbxenv.yaml sur Recréer la sandbox si elle a disparu, ou tapez les commandes : voir Recréer la sandbox quand elle a disparu.
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
27


# 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 : l'icône est un emoji, ou une lettre affichée dans un rond coloré ; laissée vide, le rond contient la première lettre du nom affiché.
3. **Où tourne-t-il ?** Choisissez l'environnement, puis remplissez ce qu'il demande (voir plus bas).
4. **Comment le démarrer ?** Remplissez **Programme** (choisissez `mm`, `docker-agent` ou `docker agent` dans la liste, ou tapez-en un autre), **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, depuis le fichier de configuration de l'agent** : choisissez le programme, puis déposez le fichier YAML de l'agent sur **Le fichier de configuration de l'agent** (ou cliquez sur **Choisir un fichier…**). Le dossier de l'agent devient celui du fichier ; pour `mm`, `docker-agent` et `docker agent`, les arguments sont remplis (`--acp --config <fichier>`, `serve acp <fichier>`). Pour un autre programme, tapez les arguments. Changer de programme ensuite les remplit de nouveau. Chaque champ reste modifiable. Cela fonctionne aussi **dans une sandbox sbx** ou **dans un conteneur Docker**, si le fichier est dans un dossier que la sandbox partage, ou que le conteneur monte, au même chemin (il y est lu).
- **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 exister (Sidekicks le démarre s'il est arrêté), 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>`. Pour que le conteneur soit recréé quand il a disparu, déposez son `compose.yaml` sur **Recréer le conteneur s'il a disparu** et choisissez le service, ou tapez les commandes : voir [Redémarrer ou recréer le conteneur](lancer-un-agent-dans-docker.md#redémarrer-ou-recréer-le-conteneur).
- **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>`. Pour que la sandbox soit recréée quand elle a disparu, déposez son `sbxenv.yaml` sur **Recréer la sandbox si elle a disparu**, ou tapez les commandes : voir [Recréer la sandbox quand elle a disparu](lancer-un-agent-dans-une-sandbox.md#recréer-la-sandbox-quand-elle-a-disparu).
- **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)