> For the complete documentation index, see [llms.txt](https://doc-builder.oftone.fr/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://doc-builder.oftone.fr/gestion-du-bot/agent.md).

# Liaison et agent

L’agent associe la machine au projet sélectionné, reçoit les déploiements et exécute le bot. Prévoyez **Node.js 22.5 ou plus** et l’accès à Internet pour la connexion à Builder et Discord.

![Page de liaison de l’agent](https://60737511-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fvr5qJH1qHoP102m8JQrh%2Fuploads%2Fgit-blob-1150d078567d3c7da17a0e0aafea01a8135688fd%2Fliaison.png?alt=media)

Sur la machine d’hébergement, dans un dossier de votre choix :

```bash
npm install oft-agt
npx oft-agt connect
```

Ouvrez le lien donné par le terminal, connectez-vous avec Discord et saisissez le code à durée limitée. Sélectionnez le bot à lier, puis configurez le token Discord dans le formulaire prévu. L’agent tourne en arrière-plan après la liaison. Déployez les commandes enregistrées pour lancer le bot.

![Formulaire du token, laissé vide pour la démonstration](https://60737511-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fvr5qJH1qHoP102m8JQrh%2Fuploads%2Fgit-blob-482bc3ac02d1eebd6e20d20c9c374388e2fb29f7%2Fliaison-token.png?alt=media)

| Commande locale                                    | Usage                                                                                                                 |
| -------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------- |
| `npx oft-agt help` · `npx oft-agt list`            | Aide et liste des instances                                                                                           |
| `npx oft-agt start --bot=IDENTIFIANT`              | Lance l’instance choisie sans nouvelle saisie de token                                                                |
| `npx oft-agt stop --bot=IDENTIFIANT` · `restart`   | Arrête ou relance cette instance                                                                                      |
| `npx oft-agt status --bot=IDENTIFIANT`             | État et versions installées                                                                                           |
| `npx oft-agt logs --bot=IDENTIFIANT` · `live-logs` | Dernières lignes ou journal en direct                                                                                 |
| `npx oft-agt update --bot=IDENTIFIANT`             | Installe la version officielle et redémarre cette instance                                                            |
| `npx oft-agt autostart enable --bot=IDENTIFIANT`   | Démarrage automatique de cette instance ; modes `disable` et `status` également disponibles                           |
| `npx oft-agt remove --bot=IDENTIFIANT --yes`       | Supprime l’instance locale arrêtée et sa configuration ; à utiliser seulement si vous souhaitez réellement la retirer |

Remplacez `IDENTIFIANT` par le préfixe affiché dans `list`. Sélectionnez explicitement le bot quand plusieurs installations cohabitent. Sur Windows le démarrage automatique se fait à l’ouverture de session ; sur Linux via le service utilisateur systemd. Le démarrage avant connexion sous Linux dépend du maintien de la session systemd utilisateur.

La carte de mise à jour du dashboard utilise le paquet officiel signé. Si l’agent est hors ligne, utilisez la mise à jour ciblée depuis la machine. Préservez les données locales lorsque vous transférez une instance. Consultez [Dépannage](/gestion-du-bot/depannage.md) avant une nouvelle liaison.
