> 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/depannage.md).

# Dépannage

| Symptôme                       | Vérifications                                                                                                                                               |
| ------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Commande absente dans Discord  | Sélection du bot, liaison, installation Discord sur le serveur et confirmation du dernier déploiement                                                       |
| Bot hors ligne                 | `npx oft-agt list` puis `status` et `logs` avec l’ID du bon bot                                                                                             |
| État du dashboard indisponible | Actualisez la liaison et comparez au journal de l’agent ; une erreur HTTP peut toucher le dashboard pendant que Discord affiche encore la dernière présence |
| Carte de mise à jour inactive  | Vérifiez la connexion de l’agent ; exécutez `update --bot=IDENTIFIANT` sur l’hôte si nécessaire                                                             |
| Message ou bouton sans effet   | Liaison des blocs, cible existante, durée du bouton, restrictions d’auteur et droits du bot                                                                 |
| Événement silencieux           | Type sélectionné, intents Discord, filtre des bots et présence d’un salon pour le mode choisi                                                               |
| Erreur ou résultat IA vide     | Quota, secret du fournisseur, nom de sortie, connexion et état des outils                                                                                   |
| Action de modération refusée   | Droit du demandeur, droit du bot, hiérarchie des rôles et ID de la cible                                                                                    |

Dans les paramètres, le bouton **Télécharger le diagnostic** fournit les versions et l’état. Accompagnez un signalement de l’heure, du parcours concerné et du code d’erreur affiché. Masquez les données privées avant de transmettre les journaux.

[Liaison et agent](/gestion-du-bot/agent.md) · [Branche d’erreur](/reference/blocs/error-root.md)
