DépannageCopy Anchor Link

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 pasCopy Anchor Link

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ésultatCopy Anchor Link

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).

L'analyse indique que le fichier du document est trop volumineuxCopy Anchor Link

Pourquoi : Une analyse exécutée dans votre navigateur envoie le fichier du document à Claira en une seule requête et lit les fichiers jusqu'à 23 Mo. Une analyse en arrière-plan téléverse le fichier par parties et lit les fichiers jusqu'à 50 Mo. Le message indique la taille du fichier et la limite qui s'applique. Rien n'a été envoyé à l'IA, et rien n'est facturé. Voir Limites de taille de fichier.

Comment corriger :

1. Pour un fichier jusqu'à 50 Mo, sélectionnez le document dans Nuix Discover, lancez une analyse en lot et cochez Exécuter en tant que tâche en arrière-plan. Le traitement en arrière-plan doit être configuré sur le dossier, et Claira ne le propose que dans ce cas.
2. Pour analyser plutôt le texte du document, réglez Analyser comme sur Texte. Claira ne le propose que si le document a du texte extrait.
3. Lorsque vous analysez de nombreux documents, laissez Analyser comme sur Auto : Auto lit le texte extrait d'un document lorsque son fichier est trop volumineux, et n'ignore le document que s'il n'a pas de texte non plus.
4. Pour un fichier de plus de 50 Mo sans texte extrait, faites-en extraire le texte (OCR ou transcription) dans Nuix Discover, puis analysez-le comme Texte.

L'analyse image indique que le fichier n'est pas un format pris en chargeCopy Anchor Link

Pourquoi : Une analyse image envoie le fichier même du document à l'IA : ce fichier doit donc être dans un format que Claira sait lire. Le message indique le type de fichier que Nuix Discover associe au document. Discover enregistre le format réel d'un fichier lors de l'ingestion, si bien qu'un document numérisé enregistré en .pdf peut s'avérer être un autre type de fichier. Voir Analyses média pour les formats lus par l'analyse image, y compris les images TIFF et JPEG 2000.

Comment corriger :

1. Vérifiez le type de document dans Nuix Discover. S'il s'agit d'un format qui contient du texte, comme un fichier Word ou un courriel, réglez Analyser comme sur Texte. S'il s'agit d'un fichier audio ou vidéo, choisissez ce mode.
2. Si le message indique que le document n'a pas non plus de texte extrait, une analyse texte ne peut pas le lire. Enregistrez le fichier d'origine en PDF standard, par exemple avec Enregistrer sous ou Imprimer en PDF dans une visionneuse PDF, chargez cette copie dans le dossier et lancez une analyse image dessus.
3. Si le message indique que Claira n'a pas pu préparer le fichier image du document, le fichier TIFF ou JPEG 2000 est endommagé, compte plus de 500 pages ou est trop volumineux une fois converti. Scindez ou réenregistrez le fichier, puis chargez-le de nouveau.
4. Toujours en échec ? Signalez le problème en indiquant l'identifiant du document.

Le bouton d'analyse est griséCopy Anchor Link

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érentsCopy Anchor Link

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éCopy Anchor Link

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 champsCopy Anchor Link

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é ?Copy Anchor Link

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. Consultez Signaler un problème pour savoir quoi inclure.

---

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