Dépannage
Cette page liste des problèmes fréquents et leurs causes habituelles. Commencez par consulter les logs et les lignes de vie des composants.
Les composants ne démarrent pas
Erreurs de connexion à MongoDB. Tock nécessite un replica set MongoDB, même avec un seul nœud :
tock_mongo_url doit contenir le paramètre replicaSet et le replica set doit être initialisé
(voir Installation).
Erreur no 'tock_encrypt_pass' set. Hors environnement de dev (tock_env différent de dev), la propriété
tock_encrypt_pass est obligatoire dès que des données sont chiffrées (voir Sécurité).
Je ne peux pas me connecter à Tock Studio
Les identifiants sont refusés. Par défaut, les identifiants sont admin@app.com / password. Si tock_users
et tock_passwords sont définis, ils remplacent cet utilisateur par défaut (voir Authentification Tock Studio).
La connexion réussit, mais la session est aussitôt perdue. Hors environnement de dev, le cookie de session
n'est envoyé qu'en HTTPS. Servez Tock Studio en HTTPS, ou définissez tock_https_env=false si le TLS est géré par un
proxy qui transmet des requêtes HTTP. Avec plusieurs instances de bot_admin, les sessions ne sont pas partagées : utilisez
une seule instance, ou des sessions persistantes (sticky sessions) sur le répartiteur de charge.
Le bot ne répond pas
Dans Test > Test, le bot répond par une erreur. Le connecteur de test appelle le bot à l'Application base url
de sa configuration, dans Settings > Configurations : cette URL doit être joignable depuis le service bot_admin
(par exemple http://bot_api:8080 avec les descripteurs tock-docker, voir Configuration).
En mode Bot API, rien ne se passe. Consultez les logs de votre bot : la clé d'API doit être celle de la
configuration, et le bot doit joindre le service bot_api (mode WebSocket) ou être joignable par lui
(mode WebHook, voir Bot API).
Le bot répond avec une autre story. La phrase n'est pas reconnue comme l'intention attendue : qualifiez-la dans Language Understanding > Inbox sentences (voir Compréhension du langage), et vérifiez que l'intention est l'intention principale de la story, dans Stories & Answers > All stories.
Les nouvelles phrases ne sont pas prises en compte. Le modèle est reconstruit par le service build_worker peu de temps
après la validation d'une phrase : vérifiez que ce service fonctionne, et consultez les constructions dans
Model Quality > Model Builds.
Le RAG ne répond pas
Le bot répond par une erreur technique. L'orchestrateur Gen AI n'est pas joignable : vérifiez
tock_gen_ai_orchestrator_server_url dans les services bot_api et bot_admin, et la ligne de vie de l'orchestrateur
(/health-check). Depuis Tock 26.3.0, le prompt Question answering doit aussi produire un objet JSON
(voir Mettre à jour Tock).
Les réponses ne citent jamais de document. Vérifiez qu'une session d'indexation est sélectionnée dans les réglages du RAG, et que la base vectorielle configurée dans Tock Studio ou par les variables d'environnement est celle où les documents ont été indexés : la base vectorielle par défaut n'est pas la même dans Tock Studio et les bots, et dans l'orchestrateur (voir Vector DB settings). Le diagnostic de recherche montre les documents trouvés pour une question.
La construction du modèle échoue
OutOfMemoryError dans le build_worker. La mémoire nécessaire augmente avec le nombre de phrases, d'intentions et
d'entités : voir les recommandations de mémoire.
Chat with Tock