Analyse en lot

Une analyse en lot applique la même invite et le même raccordement de champs à plusieurs documents à la fois. Vous pouvez inclure jusqu'à 999 999 documents dans une seule tâche d'analyse en lot, sur tous les forfaits — voir Forfaits et facturation pour la capacité en jetons par forfait. Vous sélectionnez les documents dans la liste de navigation Nuix Discover et Claira les traite automatiquement.

Avant de lancer une analyse en lot

1. Un champ connecté. Dans Paramètres Claira, connectez le champ Nuix Discover qui recevra les résultats. Voir Champs si besoin.
2. Une invite enregistrée. Rédigez et enregistrez votre invite dans la zone Invite. Testez d'abord avec la revue unique sur un échantillon. La revue unique est gratuite sur tous les forfaits et tous les types de média — l'analyse en lot est la seule à consommer des jetons.
3. Une sélection de documents. Dans la liste de navigation Nuix Discover, sélectionnez les documents à traiter.

Comment lancer une analyse en lot

1. Dans Nuix Discover, sélectionnez les documents dans la liste de navigation.
2. Ouvrez le panneau Claira et choisissez un point d'entrée :
   • Aller au mode Analyse en lot.
   • Rester en Laboratoire de prompts et utiliser le bouton de démarrage en lot dans la section Requête.
3. Vérifiez l'invite et le champ de destination.
4. Consultez la confirmation. Claira affiche :
   • L'utilisation estimée de jetons pour cette exécution à côté de votre solde de jetons disponible, en haut de la fenêtre, avec une confirmation indiquant si la tâche tient dans votre solde ou peut entraîner des frais supplémentaires
   • Le nombre de documents dans votre sélection
   • Votre mode d'entrée d'analyse actuel
   • La durée estimée de la tâche
   • Le champ de destination où seront écrits les résultats. Pour une analyse Multi-Code, cette ligne affiche plutôt un résumé Analyse multi-codes indiquant le nombre de champs concernés.
   • Sur les dossiers où le traitement en arrière-plan est configuré, une case Exécuter en tant que tâche en arrière-plan lorsque l'exécution y est admissible : analyses Texte avec un modèle par défaut de Claira, pour les analyses à champ unique comme Multi-Code (pour le Multi-Code, son propre sélecteur Analyser comme doit être sur Texte).
5. Démarrez la tâche :
   • Dans le Laboratoire de prompts, cliquez sur (affiché seulement si plus d'un document est sélectionné).
   • En mode Analyse en lot, cliquez sur .

Suivi et résultats

La progression s'affiche dans le panneau Claira. Les résultats sont écrits directement dans le champ Nuix Discover connecté pendant que la tâche s'exécute encore — rien à exporter ni à transférer. Les analyses au premier plan écrivent le résultat de chaque document dès qu'il se termine, et les analyses en arrière-plan — y compris les très grandes — écrivent les résultats progressivement, par groupes, tout au long de l'exécution plutôt qu'en une seule fois à la fin. Vous pouvez donc commencer la relecture dans Discover dès que des documents se terminent, pendant que le reste de la tâche continue. Les résultats déjà écrits sont conservés même si une tâche ne va pas jusqu'au bout : si vous annulez une tâche en arrière-plan en choisissant d'écrire les résultats terminés, ou si une exécution échoue en cours de route, tout ce qui était terminé reste dans le champ.

Un panneau Résultats en direct diffuse chaque document terminé au fur et à mesure, du plus récent au plus ancien, pour suivre les résultats en temps réel. Pour en lire un en entier, survolez-le avec le curseur : l'entrée s'agrandit, et le flux se met en pause tant que le curseur reste sur la liste — ainsi l'entrée que vous lisez reste en place au lieu d'être repoussée vers le bas à l'arrivée de nouveaux résultats. Éloignez le curseur de la liste et le flux reprend, en ajoutant tout ce qui est arrivé pendant votre lecture. Pour une analyse Multi-Code, chaque entrée présente les valeurs extraites sous forme de lignes Champ : valeur — une par champ de destination — de la même manière que la réponse Multi-Code d'un document unique.

Pendant l'analyse, les compteurs au-dessus des résultats en direct suivent chaque issue séparément : traités compte les documents qui ont produit un résultat — les mêmes que ceux listés dans le panneau des résultats en direct — tandis que ignorés compte les documents sans texte ni média lisible (ou dont le texte dépasse la limite de taille), et échoués compte les documents en erreur. Seuls les documents ayant produit un résultat apparaissent dans le panneau des résultats en direct ; les documents ignorés et en échec ne figurent que dans les compteurs.

Ajuster la vitesse d'analyse

Les analyses en lot en direct — celles qui s'exécutent dans votre onglet de navigateur — comportent un curseur Vitesse d'analyse dans la zone de progression, avec cinq positions de La plus lente à La plus rapide. Il contrôle le nombre de documents que Claira traite en même temps :

• Les positions plus lentes allègent la charge sur le service d'IA. Utilisez-les lorsque des documents échouent avec des erreurs de disponibilité des ressources — aux vitesses les plus lentes, ces erreurs disparaissent presque entièrement.
• Les positions plus rapides terminent la tâche plus tôt, mais risquent davantage de rencontrer des erreurs de disponibilité des ressources, surtout aux heures d'affluence. Les documents qui échouent ainsi sont remboursés automatiquement et peuvent être analysés de nouveau depuis la liste des Tâches en lot.
• Équilibrée, la valeur par défaut, s'exécute volontairement un peu en dessous de la vitesse maximale de Claira — le juste milieu entre terminer rapidement et garder les erreurs de ressources rares. Chaque nouvelle analyse démarre à Équilibrée.

Vous pouvez déplacer le curseur à tout moment pendant l'analyse. Le changement prend effet immédiatement pour les documents suivants — les documents déjà en cours d'analyse terminent simplement à leur rythme — et la durée estimée se met à jour selon la nouvelle vitesse. Le curseur s'applique uniquement aux exécutions en direct ; les tâches de traitement en arrière-plan sont cadencées côté serveur.

Il n'est pas nécessaire d'interagir avec l'interface pendant l'analyse — l'ajustement de la vitesse est entièrement facultatif. Gardez simplement la fenêtre du navigateur ouverte et laissez Claira parcourir la liste.

Suivi des tâches en arrière-plan

Lorsqu'une analyse en lot s'exécute comme tâche de traitement en arrière-plan, la carte de la tâche en cours dans la liste des Tâches en lot affiche une barre de progression à codes de couleur qui se remplit de gauche à droite à mesure que les documents avancent dans l'exécution : vert pour les résultats déjà écrits dans Nuix Discover, sarcelle pour les documents dont le traitement par l'IA est terminé et qui attendent d'être écrits, bleu pour les documents soumis au traitement par l'IA, et jaune pour les documents dont le texte est encore en extraction. Sous la barre, une ligne de décompte par phase n'apparaît que tant qu'elle est informative — la ligne d'extraction disparaît une fois l'extraction terminée, et les phases à zéro sont masquées. Les nombres se mettent à jour chaque fois que vous actualisez la vue des Tâches en lot — il n'y a rien à configurer, et vous pouvez fermer Nuix Discover à tout moment ; l'exécution continue côté serveur et Claira vous envoie un courriel une fois terminée.

Les exécutions en arrière-plan sont conçues pour surmonter les interruptions par elles-mêmes : les brèves défaillances de service, les redémarrages et les longues attentes sont absorbés silencieusement et la tâche continue simplement. Les analyses de très longue durée sont elles aussi poursuivies automatiquement en coulisse — la tâche continue simplement et la barre continue d'avancer ; vous n'avez jamais rien à relancer. Si vous recevez un courriel d'échec, cela signifie que l'exécution a réellement cessé de progresser et nécessite votre attention — ouvrez les Tâches en lot et utilisez Reprendre pour la poursuivre exactement là où elle s'était arrêtée.

Les exécutions en arrière-plan prennent en charge aussi bien les analyses à champ unique que les analyses Multi-Code. Une tâche Multi-Code en arrière-plan code chacun de vos champs configurés pour chaque document, exactement comme le ferait l'exécution au premier plan ; si certains champs n'ont pas pu être écrits pour un document, le journal des documents de la tâche indique lesquels.

Noms des tâches

Claira nomme chaque tâche en lot automatiquement à partir de votre consigne peu après le début de l'exécution. Vous pouvez changer le nom à tout moment :

• Le renommer — cliquez sur le nom de la tâche dans la liste des Tâches en lot ou en haut des détails de la tâche, saisissez le nouveau nom, puis appuyez sur Entrée (ou cliquez ailleurs) pour enregistrer. Appuyez sur Échap pour annuler.
• Demander un nouveau nom à l'IA — dans les détails de la tâche, cliquez sur la petite icône d'actualisation à côté du nom (son infobulle indique Régénérer le titre avec l'IA). Claira relit votre consigne et propose un nom neuf — utile quand le nommage automatique ne s'est pas terminé ou que le nom ne reflète pas l'objectif de l'exécution.

Si l'analyse s'arrête avant la fin

Une analyse en lot s'exécute dans l'onglet de votre navigateur. Si l'exécution est interrompue avant que chaque document ait une issue — par exemple l'onglet a été fermé, la connexion a été perdue, ou une rafale d'erreurs du service d'IA a arrêté les processus — la tâche est marquée Incomplète au lieu de Terminée, afin que des documents non analysés ne soient jamais présentés à tort comme traités.

Une tâche Incomplète est facile à terminer plus tard :

• Ouvrez l'onglet Tâches en lot et repérez le badge ambre Incomplète. Les détails de la tâche indiquent exactement combien de documents doivent encore être analysés.
• Cliquez sur Reprendre la tâche pour analyser les documents restants. Les documents qui ont déjà un résultat ne sont pas réanalysés et ne sont pas facturés une seconde fois.
• Si vous préférez ne pas terminer l'exécution, cliquez sur Annuler la tâche dans les détails de la tâche. Les jetons réservés pour les documents non analysés sont libérés vers votre solde.

Tant qu'une tâche est Incomplète, les jetons réservés pour ses documents restants restent en attente afin que la reprise ne puisse jamais vous facturer deux fois. Ils sont réglés automatiquement quand la tâche se termine ou quand vous l'annulez.

L'annulation d'une tâche en arrière-plan fonctionne différemment. Cliquer sur Annuler la tâche pour une exécution en arrière-plan ouvre d'abord une boîte de dialogue : si des documents ont déjà terminé le traitement par l'IA, elle vous indique approximativement combien — « Environ N documents ont terminé leur traitement » (ou une formulation générique lorsque le décompte n'est pas encore connu) — et propose trois choix :

• Écrire les résultats et annuler — Claira enregistre les résultats terminés dans le champ de destination avant d'arrêter la tâche. Vous n'êtes facturé que pour les documents réellement écrits ; les jetons réservés pour tout le reste sont retournés à votre solde.
• Abandonner et annuler — la tâche s'arrête sans rien écrire de plus. C'est permanent — les résultats terminés mais non écrits ne peuvent pas être récupérés — et les jetons réservés pour les documents non écrits sont retournés à votre solde.
• Continuer l'exécution — ferme la boîte de dialogue et laisse la tâche continuer comme si de rien n'était.

Aucun courriel n'est envoyé pour une tâche annulée.

Les exécutions en arrière-plan protègent aussi le travail accompli quand un problème survient alors que personne ne surveille : si une analyse rencontre un échec dont elle ne peut pas se remettre, Claira écrit d'abord automatiquement tout ce qui était déjà terminé avant de marquer la tâche comme échouée, et le courriel de notification rapporte des décomptes honnêtes de ce qui a été écrit et de ce qui ne l'a pas été. Les documents qui n'ont pas pu être terminés reçoivent une note explicative ERROR_LOG dans le champ de destination, comme les autres erreurs par document.

Rapport d'historique des tâches en lot

Pour un dossier audit-friendly de chaque tâche en lot exécutée sur un dossier, cliquez sur l'icône de téléchargement en haut de l'onglet Tâches en lot. Le PDF contient une carte par tâche affichant :

• Le numéro de tâche, son nom et le badge de type de média (auto, texte, image, audio ou vidéo).
• Le statut, le taux de réussite et le décompte des documents réussis / échoués / ignorés.
• Le texte complet de la requête envoyée au modèle.
• Le nom du modèle face client (ex. « Claira par défaut (CA) ») et la configuration de la tâche (température, langue, champ de destination).
• Les jetons utilisés.

C'est le dossier canonique de ce qui a été exécuté sur le dossier — utile pour les revues qualité, la défensibilité, ou le partage avec un client.

Utilisation des jetons

L'utilisation des jetons dépend de la sélection dans le menu Analyser comme. Le tarif par document est facturé uniquement pour les documents que l'IA analyse avec succès — les documents en échec, ignorés et en attente (annulés) sont remboursés automatiquement lorsque la tâche atteint un état terminal.

• Mode Auto (par défaut) : 1 à 20 jetons par document réussi, selon le mode que Claira choisit pour ce document (texte=1, image=5, audio=10, vidéo=20). La tâche réserve le tarif du pire cas (20 / doc) au départ et rembourse la différence à mesure que chaque document est résolu.
• Mode Texte : 1 jeton par document réussi
• Mode Image (un seul champ) : 5 jetons par document réussi
• Mode Audio (un seul champ) : 10 jetons par document réussi
• Mode Vidéo (un seul champ) : 20 jetons par document réussi

Avec le Multi-Code, le coût par document correspond au tarif média de base plus 1 jeton fixe — identique quel que soit le nombre de champs multi-codes actifs que vous configurez (de 1 à 8 champs, le coût est le même) :

• Texte + Multi-Code : 2 jetons par document.

• Image + Multi-Code : 6 jetons par document.

• Audio + Multi-Code : 11 jetons par document.

• Vidéo + Multi-Code : 21 jetons par document.

• Claira réserve le coût total de la tâche au départ et vérifie votre solde de jetons avant de commencer ; une analyse ne démarrera pas si elle dépasse vos jetons disponibles.

• À la fin de la tâche, les documents qui ne se sont pas terminés avec succès sont recrédités à votre réserve sous forme d'une entrée refund au grand livre de facturation.

• Pour vérifier votre solde actuel, consultez le nombre de jetons affiché dans la fenêtre de confirmation de l'analyse en lot ou dans la fenêtre Utilisation.

Ce qui compte comme document réussi

Une tâche en lot traite chaque document que vous avez sélectionné. À la fin de la tâche, chaque document est dans l'un de ces états :

• Terminé — l'IA a renvoyé une réponse. Facturé.
• En échec — l'IA a renvoyé une erreur, le modèle n'a pas pu lire le fichier, ou les réessais ont été épuisés. Remboursé.
• Ignoré — le type de document n'est pas pris en charge dans le mode choisi ou le contenu est illisible. Remboursé.
• En attente — la tâche s'est terminée (annulation, abandon, ou autre raison) avant que le document soit analysé. Remboursé.

Si la tâche est Incomplète (l'analyse s'est arrêtée avant la fin — voir Si l'analyse s'arrête avant la fin), les documents pas encore analysés restent En attente et leurs jetons réservés restent en attente jusqu'à ce que vous repreniez la tâche ou l'annuliez.

Les décomptes réussis / échec / ignorés apparaissent par tâche dans le Rapport d'historique des tâches en lot.

• Gardez une configuration enregistrée par flux de travail pour réduire les écarts de configuration.
• Consignez vos choix de modèle, de gabarit et de correspondance de champs dans votre journal de dossier à des fins d'auditabilité.
• Lorsque les résultats varient de façon inattendue, relancez le même échantillon avant de modifier plusieurs paramètres à la fois.

Menu déroulant Analyser comme (auto / texte / image / audio / vidéo)

Par défaut, l'analyse en lot utilise Auto — Claira choisit le meilleur mode pour chaque document au moment de l'analyse, donc une production mixte est traitée correctement sans pré-tri. Auto, Texte, Image, Audio et Vidéo sont tous disponibles sur tous les forfaits, Starter inclus.

• Auto (par défaut) : Claira examine chaque document et choisit Texte / Image / Audio / Vidéo à la volée. Facturé au tarif du mode résolu (1 / 5 / 10 / 20 jetons par document). Jusqu'à 20 jetons / doc sont réservés à la création de la tâche ; la différence est remboursée à mesure que chaque document est résolu vers un mode moins coûteux. Voir Analyses média pour la hiérarchie complète.
• Texte : Claira envoie le texte extrait Nuix. 1 jeton/doc (champ unique), ou 2 jetons/doc en Multi-Code.
• Image : Claira joint le fichier image / PDF source. 5 jetons/doc (champ unique), ou 6 jetons/doc en Multi-Code.
• Audio : Claira joint le fichier audio source. 10 jetons/doc (champ unique), ou 11 jetons/doc en Multi-Code.
• Vidéo : Claira joint le fichier vidéo source. 20 jetons/doc (champ unique), ou 21 jetons/doc en Multi-Code.

Ce que le modèle reçoit selon le mode

• Texte : l'invite et le texte extrait Nuix dans le corps de la requête.
• Image : l'invite et le fichier source en pièce jointe. Formats acceptés : PDF, PNG, JPEG, WebP, GIF, BMP, HEIC, HEIF.
• Audio : l'invite et le fichier audio source en pièce jointe. Formats acceptés : MP3, WAV, AAC, OGG, FLAC, M4A, AIFF.
• Vidéo : l'invite et le fichier vidéo source en pièce jointe. Formats acceptés : MP4, MOV, WebM, AVI, MKV, MPEG, 3GP, FLV, WMV.

Si une partie du fichier est illisible ou absente, Claira demande au modèle d'indiquer la limite et de fournir la meilleure réponse possible.

Si une analyse échoue à cause du mode d'entrée

Quand un document ne peut pas être analysé dans le mode choisi, Claira affiche un message actionnable. Lorsque c'est possible, Claira inspecte les fichiers source du document et indique le mode qui fonctionnerait — par exemple, une analyse Texte sur un document audio uniquement écrit « ce document semble être un contenu audio — essayez l'analyse Audio » dans le champ.

Exemples courants :

• Fichier source indisponible ou type MIME non pris en charge pour le mode choisi : changez le menu Analyser comme vers un autre mode et relancez.
• Texte extrait manquant en mode Texte : passez au mode média suggéré (ou Image si aucune suggestion n'est disponible).

Dépannage : analyse média bloquée ou sans résultat

Pourquoi : en mode Image, Audio ou Vidéo, Claira télécharge d'abord le fichier source auprès de Nuix Discover, puis envoie ce fichier au modèle. Le mode Texte peut encore fonctionner lorsque cette étape est lente ou bloquée.

Que faire :

1. Vérifiez deux requêtes réseau dans les outils de développement du navigateur. La requête de téléchargement Nuix doit se terminer (HTTP 200) avant l'appel à l'orchestrateur .../api/v1/orchestrate/chat/completions. Si le téléchargement reste en attente, le problème est côté Nuix, réseau ou taille de fichier, pas encore l'IA.
2. Les gros fichiers peuvent prendre du temps ; après un délai, Claira affiche une erreur de téléchargement explicite si la réponse n'arrive pas.
3. 403/404 sur le téléchargement : voir l'administrateur Nuix pour les droits d'accès, les réductions marquées, les limites de taille et le jeton de session UIX (pas le jeton API personnel).

Étapes suivantes

• Comprendre les résultats
• Analyses média — formats image, audio et vidéo acceptés par mode
• Dépannage

Besoin d'aide ? Écrivez à support@claira.to.