ClairaClaira Help Desk
Revue IA

Analyse en lot

Autres langues

Lancer une analyse en lot dans Claira pour traiter plusieurs documents avec une même invite.

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. L'en-tête Analyse en lot vous renvoie ce que vous avez choisi : 3 documents sélectionnés dès qu'il y a une sélection, et Sélectionnez un ou plusieurs documents pour commencer tant qu'il n'y en a pas, afin qu'une liste vide indique l'étape suivante au lieu de compter le vide. Sur un volet étroit, la pastille se réduit au seul nombre ; survolez-la pour lire la phrase complète.
L'analyse en lot consomme des jetons. Le coût dépend du mode d'entrée et de l'activation du Multi-Code (le Multi-Code ajoute 1 jeton par document). Si votre solde ne couvre pas la tâche, Claira la bloque, sauf si Autoriser les dépassements est activé pour le dossier; dans ce cas, les jetons au-delà de votre solde sont facturés 0,10 $ chacun.

Le champ sur lequel Claira vous place

Claira retient le champ dans lequel vous travaillez sur ce dossier et le propose comme point de départ dans les autres modes. Le Laboratoire de prompts et l'Analyse en lot partagent un seul champ de destination : modifiez-le dans l'un ou l'autre, ou dans la confirmation de l'analyse en lot, et l'autre affiche aussitôt le même champ. Le bouton Lancer l'analyse en lot sur # documents du Laboratoire de prompts écrit donc toujours dans le champ qu'affiche le Laboratoire de prompts. Ce même champ amorce une nouvelle ligne Multi-Code ainsi que le Champ source de la Migration de champs.

Trois points méritent d'être connus :

  • Il n'appartient qu'à vous. Le champ retenu par Claira vous est personnel, dossier par dossier. Chacun de vos collègues conserve le sien, et choisir un champ ne modifie jamais ce que les autres voient.
  • Ce n'est qu'un point de départ. Chaque sélecteur reste entièrement modifiable, et le changer n'a aucun effet sur une analyse en cours, sur une analyse déjà exécutée ni sur une tâche déjà mise en file. Une analyse en cours continue d'écrire dans le champ avec lequel elle a démarré, et la reprise d'une tâche écrit dans le champ de cette tâche sans modifier vos sélecteurs.
  • Un champ déconnecté laisse le sélecteur vide. Si le champ retenu par Claira a depuis été déconnecté du dossier, le sélecteur s'ouvre simplement vide et vous attend. Claira ne substitue jamais discrètement un autre champ : une analyse écrite dans un champ que vous n'avez pas choisi est bien plus longue à défaire qu'un clic supplémentaire.

Choisir un champ n'exige plus rien dans la zone d'invite. Vous pouvez ouvrir un dossier, choisir votre champ de destination, puis rédiger l'invite ensuite : le choix est enregistré à lui seul.

Chaque ligne du sélecteur porte aussi un petit repère. Un cercle coché signifie que vous avez déjà utilisé ce champ dans ce dossier ; un cercle vide, que vous ne l'avez pas encore utilisé ; une horloge, que le champ attend encore les accès de votre administrateur de dossier. Les deux premiers repères parlent de votre propre travail : un champ dans lequel un collègue a déjà lancé une analyse s'affiche donc encore comme non utilisé. Survolez un repère pour en lire la signification.

Le champ que vous avez choisi porte une coche à gauche de sa ligne, comme dans n'importe quelle liste déroulante. Dans les sélecteurs du Prompt Lab et de l'Analyse en lot, survolez cette coche pour vous rappeler qu'il s'agit aussi du champ que Claira vous proposera lors de votre prochaine analyse de ce type.

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.
    • Lorsque votre dossier a un champ journal des requêtes, une case Écrire la requête dans le journal des requêtes de chaque document, avec le nom de ce champ en dessous. Cochez-la pour ajouter la requête de cette analyse au journal des requêtes de chaque document codé, afin que toute personne qui examine un document plus tard sache quelle requête a produit sa valeur ; les entrées précédentes du journal des requêtes sont conservées. Laissez-la décochée pour ne pas modifier le journal des requêtes. Dans les dossiers que vous utilisiez déjà, la case est décochée au départ ; un dossier que vous ouvrez pour la première fois reprend votre dernier choix dans vos autres dossiers. Ensuite, Claira mémorise votre dernier choix pour le dossier. Les analyses que l'Agent lance pour vous suivent aussi ce choix mémorisé. Survolez l'icône d'information à côté pour un rappel de son effet. Lorsque la requête est trop longue pour être écrite dans chaque document (voir Prompts très longs), la case n'est pas disponible et une note en dessous l'indique : l'analyse s'exécute sans le journal des requêtes, et la requête reste conservée dans l'historique des requêtes et dans les détails de la tâche.
    • Sur les dossiers où le traitement en arrière-plan est configuré (le traitement en arrière-plan n'est pas disponible dans Claira Private), une case Exécuter en tant que tâche en arrière-plan, proposée pour tous les types d'analyse (Texte, Image, Audio, Vidéo et Auto), pour les analyses à champ unique comme Multi-Code. Pour une analyse Image, Audio, Vidéo ou Auto, la fenêtre précise que Claira téléverse d'abord le fichier de chaque document. Si vous avez sélectionné un modèle que le traitement en arrière-plan ne peut pas exécuter, l'analyse en arrière-plan utilise à la place le modèle par défaut de Claira, et la fenêtre l'indique. Sur un dossier qui n'a pas encore de jeton d'API, lorsque Claira en détient un que vous pouvez utiliser, la section Exécution propose plutôt de le connecter en un clic (voir Connecter un jeton depuis une analyse ou la Migration de champs).
  5. Démarrez la tâche :
    • Dans le Laboratoire de prompts, cliquez sur Lancer l'analyse en lot sur # documents (affiché seulement si plus d'un document est sélectionné).
    • En mode Analyse en lot, cliquez sur Analyser la liste.
Laissez la fenêtre du navigateur ouverte pendant l'exécution : la fermer interrompt la tâche. Cela ne vaut que pour les exécutions au premier plan : une tâche démarrée avec Exécuter en tant que tâche en arrière-plan continue côté serveur après la fermeture de la fenêtre (pour une analyse Image, Audio, Vidéo ou Auto, une fois ses fichiers téléversés).

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 rien que l'analyse ait pu lire (aucun texte ni média lisible, un texte dépassant la limite de taille, un fichier de plus de 23 Mo dans une analyse Image, Audio ou Vidéo, ou un fichier que le modèle d'IA n'a pas pu lire), 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. Vous vous demandez pourquoi des documents échouent ? Survolez le nombre de documents échoués pour obtenir une explication, en langage clair, des causes courantes, et la confirmation que les documents échoués ne sont pas facturés.

Quand l'analyse se termine

Passé la moitié, une courte note sous la barre de progression indique À mi-chemin., puis Presque fini. à partir de 90 %.

Quand une analyse exécutée dans votre navigateur se termine, une carte récapitulative prend la place du panneau de progression. Elle commence par le résultat, par exemple 2 908 documents codés, affiche la même barre de résultats en couleur avec le nombre de documents codés, en échec et ignorés, et propose l'étape suivante : un Insight suggéré pour la tâche lorsqu'il y en a un, et Voir les détails pour ouvrir la tâche complète. Fermez la carte avec le X dans son coin ; lancer une autre analyse la remplace aussi. La notification avec les mêmes décomptes s'affiche toujours en haut du panneau.

Quand tous les documents ont été codés, la carte ajoute une petite coche, une phrase amicale et, quand l'exécution en franchit une, une étape marquante comme Ce dossier vient de dépasser 10 000 documents codés. Quand des documents ont échoué, la carte commence plutôt par les échecs. Vous pouvez désactiver ces touches dans les Paramètres : voir Célébrations.

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 bien en dessous de La plus rapide : les résultats arrivent dans le panneau des résultats en direct à un rythme que vous pouvez suivre, et les erreurs de ressources restent 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.

Déplacer une analyse en direct vers l'arrière-plan

Vous avez lancé une analyse dans votre navigateur et devez maintenant fermer votre portable ? Inutile de l'annuler et de tout recommencer. Pendant qu'une analyse en direct s'exécute, un bouton Envoyer en arrière-plan figure à côté d'Annuler l'analyse. Il confie le reste de l'exécution aux serveurs de Claira et conserve tout ce qui est déjà fait.

Cliquez dessus : Claira vous indique combien de documents sont déjà codés et combien seront terminés en arrière-plan. Confirmez, et Claira :

  • Cesse d'envoyer de nouveaux documents depuis votre navigateur et termine ceux déjà en cours, ce qui prend quelques instants.
  • Confie les documents restants aux serveurs sous le même numéro de tâche, afin que votre référence de champ de journal (par exemple SC067) retrouve toujours l'ensemble de l'exécution dans Nuix Discover.
  • Laisse intact chaque document déjà codé. Rien n'est analysé deux fois et rien ne vous est facturé une seconde fois : les jetons de toute l'exécution ont été réservés à son démarrage.
  • Réessaie les documents qui ont échoué pendant la portion en direct.
  • Continue d'écrire la requête dans le journal des requêtes, si vous avez coché Écrire la requête dans le journal des requêtes de chaque document au démarrage de l'analyse. Les documents déjà codés gardent l'unique entrée reçue pendant la portion en direct.

Pour une analyse Image, Audio, Vidéo ou Auto, Claira téléverse d'abord depuis votre navigateur les fichiers des documents restants, avec la même progression Téléversement des fichiers de la tâche #NNN qu'une nouvelle analyse en arrière-plan (voir Téléversement des fichiers des analyses image, audio, vidéo et Auto). Laissez Claira ouverte jusqu'à la fin du téléversement ; l'analyse se poursuit ensuite en arrière-plan.

Une fois le transfert terminé, la même confirmation verte La tâche #NNN s'exécute en arrière-plan s'affiche, et vous pouvez fermer Claira ou Nuix Discover en toute sécurité. Claira vous envoie un courriel une fois l'analyse terminée.

Le bouton apparaît pendant l'exécution d'une analyse en direct et est disponible dès que celle-ci est admissible au traitement en arrière-plan. S'il est grisé, survolez-le : Claira vous en explique la raison, le plus souvent parce que le traitement en arrière-plan n'est pas configuré pour ce dossier, ou parce que l'exécution utilise un modèle que le traitement en arrière-plan ne peut pas exécuter. Lorsque le dossier n'a pas encore de jeton d'API mais que Claira en détient un que vous pouvez utiliser, le bouton reste disponible : Claira demande Connecter un jeton d'API et envoyer en arrière-plan ?, et Connecter et envoyer connecte le jeton et transfère l'analyse en une seule étape. Sur un dossier Claira Private, le bouton n'est pas affiché : le traitement en arrière-plan n'est pas disponible dans Claira Private.

Le déplacement vers l'arrière-plan est irréversible : une tâche en arrière-plan ne peut pas être ramenée dans votre navigateur. Vous pouvez toutefois l'arrêter depuis la liste Tâches en arrière-plan en cours.

Suivi des tâches en arrière-plan

Au démarrage d'une exécution en arrière-plan, le panneau des résultats en direct ne s'affiche pas : une tâche en arrière-plan traite tout côté serveur et n'envoie rien à votre navigateur. À sa place, Claira affiche d'abord un avis Attribution de votre numéro de tâche… : laissez Claira ouverte pendant ces quelques instants, le temps que l'analyse soit confiée aux serveurs. Dès que le numéro de tâche est attribué, l'avis est remplacé par une confirmation verte, La tâche #NNN s'exécute en arrière-plan, ce qui signifie que vous pouvez désormais fermer Claira ou Nuix Discover en toute sécurité. À partir de là, suivez l'exécution dans la liste des Tâches en arrière-plan en cours. Une analyse Image, Audio, Vidéo ou Auto téléverse ses fichiers entre ces deux étapes : voir Téléversement des fichiers des analyses image, audio, vidéo et Auto.

Si l'attribution du numéro de tâche prend plus de temps que d'habitude, par exemple sur une connexion lente, Claira vous le signale et vérifie pendant cinq minutes au plus si la tâche a démarré : laissez Claira ouverte pendant ce temps. Si elle trouve la tâche, l'exécution se poursuit normalement. Si elle ne peut pas le confirmer, elle vous invite à vérifier vos tâches en lot avant de relancer l'analyse, car la tâche est peut-être déjà en cours et un second démarrage analyserait deux fois les mêmes documents.

Lorsqu'une analyse en lot s'exécute comme tâche de traitement en arrière-plan, une légende des couleurs figure en haut de la liste des Tâches en arrière-plan en cours, et chaque carte de tâche affiche une barre de progression à codes de couleur qui se remplit de gauche à droite à mesure que les documents avancent dans l'exécution : vert (Terminé) pour les résultats déjà écrits dans Nuix Discover, bleu (Analyse en cours) pour les documents en cours de traitement par l'IA, y compris ceux dont le traitement par l'IA est terminé et qui attendent d'être écrits, ambre pour les documents prêts et en file pour la soumission à l'IA, et rose (Ignorés) pour les documents qui ne seront pas analysés. L'étiquette ambre suit ce que l'exécution lit : Texte extrait dans une analyse Texte, et Fichier extrait dans une analyse Image, Audio, Vidéo ou Auto, où ce qui a été recueilli est le fichier même du document. Le rose couvre tous les documents mis de côté, quelle que soit l'étape qui les a écartés : aucun texte lisible ou texte dépassant la limite de taille dans une analyse Texte, et aucun fichier lisible par l'analyse ou fichier trop volumineux pour être analysé dans les autres modes, y compris ceux repérés pendant le téléversement des fichiers par Claira. Les documents ignorés passent au rose en direct, pendant que l'exécution est encore en cours : ils ne restent pas dans une couleur d'attente jusqu'à la fin. Une couleur vous échappe ? Survolez son entrée dans la légende pour obtenir une courte description, en langage clair, de cette étape. Chaque segment affiche son nombre de documents à l'intérieur de la barre ; lorsqu'un segment est trop étroit pour son nombre, survolez-le pour voir le décompte dans une infobulle. 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.

Quand une tâche en arrière-plan se termine. Inutile de garder Tâches en lot ouvert pour le savoir. Si une tâche en arrière-plan que vous avez lancée se termine pendant que Claira est fermé, une carte Pendant votre absence s'affiche en haut de Claira la prochaine fois que vous l'ouvrez dans ce dossier, avec chaque tâche terminée, son résultat et son statut. Choisissez Voir dans Tâches en lot pour ouvrir la liste, ou fermez la carte avec son X. Si la tâche se termine pendant que Claira est ouvert, dans n'importe quel mode, une notification vous prévient à la place, par exemple La tâche #014 est terminée : 2 908 codés., avec un bouton Voir. Chaque fin de tâche n'est annoncée qu'une fois. Les tâches que vous avez annulées et celles lancées par d'autres personnes dans le dossier ne sont pas annoncées ; vous les trouverez dans l'Historique des tâches d'analyse en lot.

Les exécutions en arrière-plan prennent en charge tous les types d'analyse (Texte, Image, Audio, Vidéo et Auto), et 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. Lorsque vous cochez Écrire la requête dans le journal des requêtes de chaque document, une tâche en arrière-plan ajoute à chaque document codé la même entrée de journal des requêtes qu'une analyse en direct.

Téléversement des fichiers des analyses image, audio, vidéo et Auto

Une analyse Image, Audio, Vidéo ou Auto en arrière-plan a besoin du fichier propre à chaque document : Claira téléverse donc d'abord ces fichiers depuis votre navigateur, pour une nouvelle analyse comme pour Envoyer en arrière-plan.

  • Laissez Claira ouverte pendant le téléversement des fichiers. Dès que le numéro de tâche est attribué, la carte d'analyse en lot affiche Téléversement des fichiers de la tâche #NNN, avec un décompte tel que « 120 fichiers téléversés sur 500 » et un bouton Suspendre le téléversement. Une fois le téléversement terminé, l'analyse s'exécute en arrière-plan et la confirmation verte La tâche #NNN s'exécute en arrière-plan s'affiche : vous pouvez dès lors fermer Claira ou Nuix Discover en toute sécurité, et le courriel de fin de tâche arrive comme d'habitude.
  • Un téléversement interrompu vous attend. Si Claira est fermée ou si le téléversement est suspendu, la tâche attend dans Tâches en arrière-plan en cours avec l'état Téléversement et une ligne telle que « En attente des fichiers : 120 téléversés sur 500 ». Toute personne travaillant dans le dossier peut choisir Terminer le téléversement sur cette ligne, dans Historique des tâches d'analyse en lot ou dans les détails de la tâche pour téléverser le reste depuis son propre navigateur. Les fichiers déjà téléversés sont conservés, et les documents que cette personne ne peut pas ouvrir dans Nuix Discover sont ignorés et ne sont pas facturés.
  • Après 24 heures, l'analyse démarre avec ce qu'elle a. Si personne ne termine le téléversement dans les 24 heures, Claira lance l'analyse avec les fichiers déjà téléversés ; les documents restants ne sont ni analysés ni facturés. Si aucun fichier n'a été téléversé, la tâche est annulée et entièrement remboursée.
  • Annuler une tâche en Téléversement l'abandonne. L'analyse en arrière-plan n'a pas encore commencé : il n'y a donc aucun résultat à conserver.
  • Un fichier inutilisable n'est pas facturé. Une analyse en arrière-plan lit les fichiers jusqu'à 50 Mo (une analyse dans votre navigateur lit les fichiers jusqu'à 23 Mo), et les images TIFF et JPEG 2000 sont converties automatiquement. Un document dont le fichier n'a pas pu être téléchargé, dépassait 50 Mo, n'était pas dans un format lisible pour le type d'analyse, ou n'a jamais été téléversé reçoit une note E-FETCH dans le champ de destination et n'est pas facturé.

Une analyse média en arrière-plan coûte les mêmes jetons que la même analyse dans votre navigateur, et une analyse Auto facture chaque document au type auquel il a été résolu. Les analyses que l'Agent lance en Mode agent avec Image, Audio, Vidéo ou Auto s'exécutent toujours dans votre navigateur ; seules les analyses de texte lancées par l'Agent peuvent s'exécuter en arrière-plan.

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. Une tâche Multi-Code reprend avec les champs et les prompts avec lesquels elle a commencé, quel que soit le contenu actuel de la carte Multi-Code.
  • 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.

Une tâche à champ unique reprend avec le prompt et le réglage Analyser comme avec lesquels elle a été lancée, même si vous avez modifié depuis le prompt dans le Laboratoire de prompts ou le menu Analyser comme. Si Claira ne peut pas lire le prompt avec lequel la tâche a été lancée, la tâche n'est pas reprise et aucun document n'est analysé. Réessayez dans un instant, ou lancez une nouvelle analyse en lot pour les documents restants.

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.

Une tâche en arrière-plan annulée est définitive et n'a donc pas de bouton Reprendre la tâche : les jetons réservés pour ses documents non terminés ont déjà été retournés à votre solde. Pour analyser les documents qu'elle n'a pas terminés, lancez une nouvelle analyse en lot.

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.

Retrouver une tâche passée

La liste Historique des tâches d'analyse en lot contient toutes les analyses en lot exécutées sur le dossier, par n'importe quel membre de l'équipe, et propose deux façons de la réduire :

  • Rechercher par nom de tâche, par personne qui l'a lancée ou par numéro de tâche. Les deux écritures du numéro fonctionnent : 014 et 14 trouvent la même tâche.
  • Filtrer avec l'icône d'entonnoir à côté du champ de recherche. Elle ouvre un panneau listant Tout le monde, puis vous, puis chacun de vos collègues ; cochez les noms dont vous voulez voir les tâches. Un petit chiffre sur l'icône indique combien de filtres sont actifs, et Effacer les filtres, au bas du panneau, remet la liste complète. Les filtres ne sont pas mémorisés : à la réouverture de Claira, vous repartez de la liste complète.

Les exécutions encore en cours en arrière-plan ne figurent pas dans cette liste. Elles restent dans Tâches en arrière-plan en cours, juste au-dessus, jusqu'à leur fin : aucune exécution n'est donc affichée deux fois.

La liste de l'historique et celle des tâches en cours utilisent la même mise en page de carte, et le titre de chaque carte porte une étiquette Arrière-plan lorsque l'exécution est côté serveur, ainsi qu'une étiquette ambre Annulation en cours pendant le traitement d'une annulation. Survolez l'une ou l'autre pour lire sa signification.

La carte de chaque tâche terminée affiche son résultat sur une ligne : le nombre de documents réussis et le nombre en échec, par exemple 1 372 réussis · 66 en échec. La ligne d'une tâche annulée commence par Annulé. Une tâche encore en cours, ou arrêtée avant la fin, indique plutôt où elle en est.

Pour savoir pourquoi des documents ont échoué ou ont été ignorés, ouvrez la tâche. Sous les compteurs, Raisons des échecs et Raisons des documents ignorés listent chaque raison une seule fois avec le nombre de documents concernés, du plus grand au plus petit, par exemple Le modèle d'IA n'a pas renvoyé de réponse ou Aucun texte à analyser. Les raisons sont :

RaisonSignification
Trop volumineux pour être analysésLe texte ou le fichier du document dépasse la taille acceptée par l'analyse.
Type de fichier non pris en charge par cette analyseLe fichier n'est pas dans un format que ce type d'analyse lit.
Fichier que le modèle d'IA n'a pas pu lireLe modèle d'IA n'a pas pu ouvrir le fichier du document, par exemple un PDF sans aucune page ou un fichier endommagé (ignoré).
Lecture impossible depuis Nuix DiscoverClaira n'a pas pu obtenir le texte ou le fichier du document.
Bloqués par le filtre de sécurité du modèle d'IALe modèle d'IA a refusé de répondre.
Le modèle d'IA n'a pas renvoyé de réponseLe service d'IA était occupé, indisponible ou a manqué de temps.
La réponse de l'IA était inutilisableLe modèle d'IA a répondu, mais la réponse était vide ou illisible.
Écriture impossible dans le champ de destinationNuix Discover n'a pas accepté le résultat.
Aucun texte à analyserLe document n'a pas de texte extrait (ignoré).

Les documents en échec et ignorés ne sont pas facturés. Pour une tâche à champ unique, chaque document en échec porte aussi une note dans son champ de destination qui nomme l'erreur ; consultez Codes d'erreur.

La version du prompt utilisée par une tâche

Ouvrez une tâche pour afficher ses détails. Au-dessus du prompt, Version du prompt nomme la version du prompt que la tâche a utilisée, numérotée comme dans l'historique des prompts (« Version 4 sur 5 »), avec l'insigne vert Finale lorsqu'il s'agit de la version que votre équipe a marquée comme finale. En dessous :

  • Une note ambre indique Cette analyse n'a pas utilisé la version finale lorsqu'une autre version du même prompt est marquée comme finale, et nomme cette version. C'est la façon la plus rapide de repérer une analyse qui a utilisé une formulation provisoire ou dépassée.
  • Lorsqu'aucune version n'est marquée comme finale, une note indique si des versions plus récentes du prompt existent.
  • Ouvrir dans l'historique des prompts ouvre les détails de cette version, où vous pouvez la comparer aux versions qui la précèdent et la suivent, et voir toutes les autres analyses en lot qui l'ont utilisée.

La version est reconnue d'après la formulation elle-même : une analyse est donc liée à sa version quelle que soit la personne qui l'a lancée, y compris les analyses en lot lancées avant l'existence de ce lien. Quelques tâches ne peuvent pas être situées :

  • Claira n'a pas enregistré la version du prompt utilisée par cette analyse s'affiche pour certaines analyses Multi-Code lancées avant l'existence de ce lien, lorsque Claira n'a pas pu rattacher l'analyse à sa configuration avec certitude.
  • Une tâche dont le prompt est plus ancien que les entrées affichées par l'historique des prompts l'indique, plutôt que de deviner une version.

Les numéros de version suivent le regroupement de l'historique des prompts : ils peuvent donc changer lorsque votre équipe ajoute des versions. Une analyse qui a utilisé la « Version 4 sur 5 » affiche « Version 4 sur 6 » dès qu'une sixième version existe.

Commentaires sur une tâche

Chaque tâche en lot dispose d'un fil de commentaires, le même que celui des prompts dans l'Historique des prompts. Servez-vous-en pour noter à quoi servait une exécution, afin que la personne qui ouvrira la tâche plus tard dispose du contexte : de quel échantillon il s'agissait, d'où venaient ses documents, ce que vous testiez, ou ce que vous avez décidé après avoir examiné les résultats.

  • Ouvrez la tâche en cliquant dessus dans Historique des tâches d'analyse en lot (ou dans Tâches en arrière-plan en cours tant qu'elle s'exécute). Commentaires se trouve sous la requête de la tâche.
  • Saisissez votre commentaire et cliquez sur Ajouter un commentaire. Il est enregistré avec votre nom et la date, et toutes les personnes qui travaillent dans le dossier peuvent le lire.
  • Pour retirer un commentaire, cliquez sur l'icône de corbeille à côté. Vous ne pouvez supprimer que vos propres commentaires.

Une tâche qui a des commentaires affiche une icône de bulle et le nombre de commentaires sur sa carte dans la liste de l'historique : vous repérez ainsi les exécutions annotées sans avoir à les ouvrir une à une. Les commentaires figurent aussi dans le Rapport d'historique des tâches en lot, sous la requête de chaque tâche.

Commentaires de l'Agent. Dans le mode Agent, vous pouvez demander à Claira ce que l'équipe a noté sur une tâche, ou lui demander d'ajouter un commentaire pour vous. Quand l'Agent lance une analyse en lot, il laisse aussi une note sur la nouvelle tâche : pourquoi il l'a lancée, à quoi elle sert et ce qu'elle fait. La carte d'analyse affiche cette note avant le début de l'analyse. Un commentaire écrit par l'Agent porte votre nom et est marqué Ajouté par l'Agent, et vous pouvez le supprimer comme vos propres commentaires.

Les suppressions de commentaires sont consignées. Supprimer un commentaire le retire de la tâche, mais la suppression elle-même est conservée pour les registres de conformité de votre organisation : qui a supprimé quel commentaire, à qui il appartenait et quand. Le texte du commentaire n'est pas conservé. Les administrateurs de l'organisation voient ces enregistrements dans le fil Activité du portail d'administration.

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.
  • Les commentaires de la tâche, chacun avec son auteur et sa date, et marqués lorsque l'Agent les a écrits.

Le rapport commence par la tâche la plus récente et remonte le temps, si bien que l'exécution que vous cherchez le plus souvent se trouve en première page. Un nom de tâche long se répartit sur deux lignes sur sa carte au lieu d'être coupé : deux tâches aux noms voisins restent distinguables. Chaque page du rapport se termine par une ligne qui nomme Claira, le rapport, le dossier et la date de l'exportation, avec Page 3 sur 11 en vis-à-vis, à droite, et à partir de la deuxième page un petit en-tête courant rappelle le titre du rapport.

Si les commentaires ne peuvent pas être chargés pendant la création du rapport, le rapport est tout de même produit, et son résumé indique que les commentaires n'ont pas pu être chargés : une tâche imprimée sans commentaires n'est donc pas prise pour une tâche qui n'en a aucun.

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. Si votre forfait est renouvelé avant la fin de la tâche, les jetons du forfait qu'elle a réservés sans les utiliser ne sont pas restitués. Voir Ce qu'une analyse en lot rembourse.

  • 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 à 10 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 ; lorsque les dépassements sont désactivés, 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.

  • Si une analyse terminée laisse au dossier moins de 15 % de ses jetons mensuels, ou le fait passer en dépassement, le message qui signale la fin de l'analyse propose Acheter des jetons. Voir Quand une analyse en lot vous laisse peu de jetons.

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é. Cela inclut un document dont le champ contient déjà exactement cette réponse, par exemple lorsque vous analysez à nouveau les mêmes documents avec la même requête.
  • En échec : l'IA a renvoyé une erreur, sa réponse n'a pas pu être utilisée ou écrite dans le champ de destination, ou les réessais ont été épuisés. Remboursé.
  • Ignoré : le document n'a rien que l'analyse puisse lire : aucun texte extrait, un type de fichier que le mode choisi ne lit pas, un texte ou un fichier dépassant la limite de taille, ou un fichier que le modèle d'IA n'a pas pu lire. 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.

Avant un gros lot, testez l'invite sur 10 à 25 documents en revue unique (la revue unique est gratuite, sur tous les forfaits) pour valider la formulation.
  • 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.

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


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

Cette page vous a aide?

Besoin d'aide supplémentaire?

Contactez notre équipe de support à support@claira.to — nous sommes là pour vous aider.

On this page