Dépannage

Cette page couvre les problèmes les plus courants rencontrés par les utilisateurs de Claira et comment les résoudre. Si votre problème ne figure pas ici ou si ces étapes ne suffisent pas, contactez le support avec une description du problème et les codes d'erreur éventuels.

Le panneau Claira est vide ou ne se charge pas

Pourquoi : Le panneau Claira doit être inclus dans votre disposition d'espace de travail Nuix Discover, et Claira doit être activé pour votre dossier et votre groupe utilisateur.

Comment corriger :

1. Vérifiez que votre disposition inclut le panneau Claira. Si vous ne le voyez pas, demandez à l'administrateur du dossier d'ajouter Claira à une disposition.
2. Confirmez que Claira a été activé pour votre dossier. L'activation est au niveau du dossier — si le dossier n'a pas été activé, le panneau ne chargera pas de contenu.
3. Vérifiez que votre groupe utilisateur a accès à Claira. Votre administrateur contrôle quels groupes peuvent voir le panneau Claira.
4. Essayez d'actualiser la page. Parfois, un rechargement résout les problèmes de chargement.

L'analyse média (image / audio / vidéo) reste bloquée ou ne renvoie aucun résultat

Pourquoi : En mode Image, Audio ou Vidéo, Claira télécharge d'abord le fichier source depuis Nuix Discover, puis envoie ce fichier pour analyse. Le mode Texte peut encore fonctionner lorsque cette étape de téléchargement est lente, bloquée ou renvoie un Content-Type générique. Voir Analyses média pour les formats acceptés par chaque mode.

Comment corriger :

1. Confirmez deux étapes réseau dans les outils de développement du navigateur. Vous devriez voir la requête de téléchargement Nuix se terminer (HTTP 200) avant que la requête orchestrateur .../api/v1/orchestrate/chat/completions ne s'exécute. Si le téléchargement reste en attente, le problème vient de Nuix, du réseau ou de la taille du fichier, pas encore de l'étape IA.
2. Attendez pour les gros fichiers. Les très gros téléchargements peuvent prendre plusieurs minutes ; Claira cesse d'attendre après un délai d'expiration et affiche une erreur de téléchargement claire.
3. 403/404 au téléchargement : Consultez votre administrateur Nuix pour l'accès aux documents, les réductions visuelles, les limites de taille de téléchargement et les exigences de jeton de session UIX (les téléchargements doivent utiliser le jeton de session UIX, pas un jeton API personnel).

Le bouton d'analyse est grisé

Pourquoi : Claira exige à la fois un prompt enregistré et un champ connecté avant d'autoriser l'analyse. Si l'un manque, le bouton d'analyse reste désactivé pour éviter des analyses incomplètes.

Comment corriger :

1. Allez dans la zone Prompt et assurez-vous qu'un prompt est rédigé et enregistré.
2. Allez dans la zone Paramètres et confirmez qu'un champ Nuix Discover est connecté.
3. Si les deux sont en place et que le bouton est toujours grisé, vérifiez que la visionneuse de documents a un document chargé (pour les analyses unitaires) ou que vous avez sélectionné des documents dans la liste de navigation (pour les analyses en lot).

Les résultats semblent erronés ou incohérents

Pourquoi : Dans la plupart des cas, des résultats incohérents indiquent un prompt qui pourrait être plus précis. L'IA suit les instructions de manière littérale, et de petites ambiguïtés dans votre prompt peuvent entraîner une sortie variable selon les documents.

Comment corriger :

1. Affinez votre prompt. Soyez plus explicite sur ce que vous voulez. Définissez les termes clés, précisez le format exact de sortie et listez les valeurs de réponse autorisées. Consultez la Vue d'ensemble des prompts.
2. Testez sur des documents connus. Exécutez votre prompt sur des documents dont vous connaissez déjà la bonne réponse. Cela aide à isoler si le problème vient du prompt ou du document.
3. Comparez les paramètres d'analyse et réexécutez. Si les résultats varient, réexécutez le même prompt sur des documents de référence et comparez les sorties avant et après chaque changement.
4. Vérifiez que le document a du texte extrait. Si le document source n'a pas de texte, du texte illisible ou très peu de texte, changez le menu Analyser comme vers Image, Audio ou Vidéo selon le fichier source du document.

L'analyse en lot s'est arrêtée ou a échoué

Pourquoi : Les analyses en lot peuvent s'arrêter pour plusieurs raisons : interruption du navigateur, épuisement des jetons ou erreurs pendant le traitement.

Comment corriger :

1. Vérifiez si la fenêtre du navigateur a été fermée. Les analyses en lot exigent que la fenêtre du navigateur reste ouverte. Si elle a été fermée ou si l'onglet a été quitté, la tâche s'est arrêtée.
2. Vérifiez votre solde de jetons. Si vous avez manqué de jetons en cours de tâche, l'analyse s'arrêtera. Vérifiez votre solde dans la fenêtre contextuelle Utilisation ou dans la zone de confirmation d'analyse en lot.
3. Recherchez des codes d'erreur. Si des documents précis ont échoué, Claira affiche un code d'erreur pour chacun. Consultez la page Codes d'erreur.
4. Reprenez si disponible. Une analyse qui s'est arrêtée avant la fin affiche un badge ambre Incomplète dans l'historique des tâches d'analyse en lot ; ouvrez la tâche pour voir combien de documents doivent encore être analysés, puis cliquez sur Reprendre la tâche pour les terminer (les documents déjà analysés ne sont ni réanalysés ni refacturés). Si vous ne souhaitez pas terminer l'exécution, Annuler la tâche libère les jetons réservés. Voir Si l'analyse s'arrête avant la fin.

Impossible de connecter les champs

Pourquoi : La connexion des champs exige que le champ existe dans Nuix Discover et soit accessible depuis l'intégration Claira.

Comment corriger :

1. Vérifiez que le champ existe dans Nuix Discover. Ouvrez votre dossier dans Nuix Discover et confirmez que le champ à connecter est présent et du bon type.
2. Vérifiez l'identifiant composite du champ. Claira utilise un identifiant composite pour identifier les champs. Si l'identifiant a été saisi manuellement, vérifiez les fautes de frappe.
3. Confirmez que Claira est activé pour votre dossier. Si un administrateur n'a pas activé Claira, les connexions de champs ne seront pas disponibles.
4. Vérifiez les autorisations. Votre compte doit avoir un accès en écriture au champ cible. Demandez à l'administrateur du dossier de vérifier vos autorisations.

Toujours bloqué ?

Si aucune des étapes ci-dessus ne résout votre problème :

1. Notez le message d'erreur exact ou le comportement observé.
2. Enregistrez l'heure, le nom du dossier et les identifiants de documents concernés le cas échéant.
3. Consultez la page Codes d'erreur pour des conseils par code.
4. Contactez-nous avec ces détails à support@claira.to.

---

Besoin d'aide ? Contactez-nous à support@claira.to.