Claira Private
Autres langues
Claira Private fait fonctionner un dossier entièrement sur votre propre modèle, soit une connexion partagée exploitée par votre organisation, soit un modèle local installé sur votre propre ordinateur, pour un prix mensuel fixe, sans jetons.
Claira Private
Les forfaits standard de Claira fonctionnent sur les propres modèles de Claira, hébergés à l'intérieur de la frontière de résidence des données de votre déploiement. Pour la plupart des équipes, cela suffit. Claira Private s'adresse aux dossiers qui ont besoin d'autre chose : chaque fonction IA du dossier s'exécute sur votre propre modèle, et jamais sur l'un de ceux de Claira.
Claira Private est un forfait pour l'ensemble du dossier, choisi à l'activation du dossier, comme autre option que les forfaits standard. Il a un prix mensuel fixe par dossier, sans jetons et sans limites de documents. Voir Tarification et facturation.
Un dossier Claira Private peut joindre votre modèle de deux façons, toutes deux incluses :
| Connexion partagée | Modèle local | |
|---|---|---|
| Où le modèle s'exécute | Sur une infrastructure exploitée par votre organisation, joignable depuis Internet | Sur votre propre ordinateur, ou sur une autre machine de votre réseau |
| Qui lui envoie les documents | Les serveurs de Claira | Votre navigateur, directement |
| Qui l'utilise | Tout le monde dans le dossier | Vous uniquement, dans ce dossier |
| Qui le configure | Toute personne du dossier, une seule fois pour le dossier, sous Paramètres de l'équipe | Chaque utilisateur, dans son propre navigateur, sous Vos paramètres |
| Adresse utilisée | Une adresse publique https:// | http://localhost:11434 et compagnie |
| Idéal pour | Un modèle que votre cabinet héberge pour toute l'équipe de revue | Un modèle sur un portable ou un poste de travail, lorsque le texte des documents ne doit pas quitter la machine |
Les deux concernent des modèles que vous exploitez. Ni l'un ni l'autre n'exige un modèle entraîné ou ajusté pour Claira : un modèle à poids ouverts prêt à l'emploi, servi via l'API chat-completions d'OpenAI, est exactement ce qu'ils attendent.
Choisir Claira Private
Vous choisissez Claira Private lorsque vous activez Claira sur un dossier. L'écran d'activation s'ouvre sur les forfaits standard, de Starter à Enterprise, avec Pro sélectionné. Sous ceux-ci, cliquez sur la ligne étroite Claira Private : son détail remplace la liste, avec Continuer pour poursuivre et Retour aux forfaits standard pour revenir. Choisissez ensuite un mode de paiement, comme pour tout autre forfait. Voir Activation du dossier.
Une fois le dossier actif, ouvrez les Paramètres et configurez votre modèle : une connexion partagée pour tout le dossier, dans la section Connexion partagée sous Paramètres de l'équipe ; un modèle local pour vous-même, dans la section Votre modèle sous Vos paramètres ; ou les deux. C'est aussi dans Votre modèle que chaque personne choisit lequel des deux elle utilise, et l'option utilisée n'y est marquée Utilisé que lorsqu'elle peut exécuter des analyses, ou Non configuré lorsqu'il n'y a encore rien sur quoi s'exécuter. Tant que ni l'un ni l'autre n'est configuré, le dossier n'a aucun modèle sur lequel s'exécuter, et les fonctions IA vous le disent au lieu de s'exécuter. Pour suivre chaque étape en détail, voir Configurer Claira Private.
Changer de forfait. Un dossier ne peut pas passer d'un forfait standard à Claira Private tant qu'il est actif, dans un sens comme dans l'autre. Pour changer, désactivez le dossier, puis activez-le de nouveau en choisissant l'autre option. Voir Forfaits et facturation.
Ce que comprend Claira Private
Sur un dossier Claira Private, chaque fonction IA s'exécute sur votre modèle :
- Les analyses : les revues uniques, les analyses en lot exécutées dans votre navigateur et le Multi-Code.
- Le Mode agent, les Insights, le générateur de requêtes, Réviser avec l’Agent et le Contexte du dossier à partir de documents. Ces fonctions utilisent la connexion partagée, ou votre modèle local tant que vous en avez un d'activé.
Certaines choses fonctionnent différemment des forfaits standard :
- Le traitement en arrière-plan n'est pas disponible dans Claira Private. Les analyses en lot s'exécutent dans votre navigateur ; gardez la fenêtre ouverte jusqu'à la fin de la tâche.
- Les analyses sont limitées au texte. Les analyses d'images, d'audio et de vidéo ne sont pas disponibles, et Analyser comme reste sur Texte.
- Les tâches en lot et les conversations reçoivent des noms standard. Claira les nomme avec sa dénomination descriptive standard plutôt qu'avec un titre rédigé par un modèle.
- Il n'y a ni sélecteur de modèle ni routage automatique des modèles. Le modèle du dossier est celui que vous avez connecté. Claira ne déplace jamais de travail vers l'un de ses propres modèles, et une fonction qui ne peut pas s'exécuter sur votre modèle le dit au lieu de s'exécuter ailleurs.
- Il n'y a pas de jetons. Pas de solde, pas de demandes gratuites quotidiennes, pas de lots de jetons et pas de dépassement. Voir Tarification et facturation.
Connexion partagée
Un point de terminaison de modèle que votre organisation héberge sur l'Internet public, connecté une seule fois pour le dossier. Tout le monde dans le dossier travaille ensuite dessus : les analyses de texte, le Mode agent, les Insights et les autres fonctions IA de Claira sont envoyés à votre point de terminaison. Tout le reste de votre flux de travail demeure inchangé : vos prompts, vos champs connectés et vos résultats.
Avant de commencer
Votre point de terminaison doit :
- Accepter les requêtes au format chat-completions d'OpenAI : la requête
/v1/chat/completionsque la plupart des serveurs de modèles et passerelles comprennent, y compris vLLM, Ollama derrière une passerelle, Azure OpenAI, les proxys compatibles OpenAI et les fournisseurs d'inférence hébergée. - Être joignable depuis Internet en HTTPS, avec un certificat émis par une autorité de certification publiquement reconnue.
- S'authentifier avec une clé API que Claira envoie comme jeton bearer.
Si votre modèle s'exécute sur site, placez-le derrière une passerelle ou un proxy inverse qui l'expose publiquement en HTTPS. Les serveurs de Claira ne peuvent pas atteindre les adresses privées ou internes. Consultez Limites de cette version pour la liste complète, et si le modèle s'exécute sur votre propre machine plutôt que sur une infrastructure partagée, utilisez plutôt un modèle local, conçu exactement pour cela.
Où configurer la connexion
- Ouvrez l'espace de travail du dossier et sélectionnez le panneau Claira.
- Ouvrez le menu Modes et choisissez Paramètres.
- Sous Paramètres de l'équipe, ouvrez la section Connexion partagée et cliquez sur Configurer la connexion partagée (ou sur Modifier la connexion partagée une fois une connexion enregistrée).
La connexion partagée se trouve sous Paramètres de l'équipe parce qu'elle s'applique à tout le dossier. Dans Votre modèle, sous Vos paramètres, l'option Connexion partagée affiche son état, et son bouton Ouvrir dans Paramètres de l'équipe vous mène à cette section.
Le panneau le rappelle, et cela mérite d'être répété : la connexion est partagée avec tout le monde dans le dossier. Toute personne du dossier peut l'utiliser pour ses analyses, la modifier ou la révoquer.
Lorsque la section est fermée, elle nomme la connexion, ou indique Non configuré tant qu'aucune n'est enregistrée. Le panneau affiche l'état de la connexion d'un coup d'œil :
- Non connecté : aucun point de terminaison n'est encore enregistré pour ce dossier.
- Connecté : un point de terminaison est enregistré et répond normalement.
- Attention requise : un point de terminaison est enregistré, mais des requêtes récentes ont échoué ou votre clé a été refusée. Voir Erreurs et reprise.
Chaque champ possède une icône d'information. Survolez-la pour une courte explication et un lien En savoir plus qui ouvre la section correspondante de cette page.
Ce dont vous avez besoin
Nom d'affichage
Le nom que Claira affiche pour votre modèle partout où un modèle est nommé : les sections Connexion partagée et Votre modèle des Paramètres, la boîte de dialogue de confirmation d'analyse en lot et le rapport d'historique des tâches en lot. C'est ainsi que la connexion apparaît aux personnes du dossier.
Où le trouver : c'est vous qui le choisissez. Prenez un nom que vos réviseurs reconnaîtront, par exemple Llama 70B du cabinet ou Modèle de revue (grappe UE). Jusqu'à 80 caractères.
URL du point de terminaison
L'adresse de base à laquelle Claira envoie les requêtes. Claira y ajoute /chat/completions pour chaque requête, et /models lorsqu'elle recherche les noms de modèles que votre point de terminaison propose.
Où la trouver : dans la documentation de votre serveur de modèles ou de votre passerelle, généralement sous l'étiquette base URL. Elle se termine habituellement par /v1, par exemple https://models.example.com/v1. Collez-la sans barre oblique finale et sans /chat/completions à la fin.
À quoi ressemble une bonne valeur :
- Commence par
https://: le simplehttp://est refusé. - Utilise un nom d'hôte public. Les adresses de réseau privé (
10.x,192.168.x,172.16.xà172.31.x),localhost, les adresses de lien local et de métadonnées infonuagiques ainsi que les noms d'hôte*.internalsont refusés. Ceux-là relèvent d'un modèle local. - Ne contient ni nom d'utilisateur, ni mot de passe, ni
#fragmentà l'intérieur de l'adresse. - Ne contient aucune chaîne de requête, à une exception près : Azure OpenAI. Azure adresse un déploiement sous la forme
https://<ressource>.openai.azure.com/openai/deployments/<deploiement>et exige un paramètre?api-version=; une URL portant exactement?api-version=<date>et rien d'autre est donc acceptée, et la version est envoyée avec chaque requête. Toute autre chaîne de requête est refusée.
Identifiant du modèle
Le nom exact du modèle que votre point de terminaison attend dans chaque requête. Claira l'envoie comme valeur model.
Où le trouver : si votre point de terminaison prend en charge la découverte de modèles, Claira liste les noms disponibles dès que vous avez saisi l'URL du point de terminaison et la clé API, avant tout test. Si votre point de terminaison n'offre qu'un seul modèle, Claira le choisit pour vous ; sinon, choisissez-en un dans la liste. Si votre point de terminaison ne liste pas ses modèles, Claira l'indique. Si la liste est vide, si votre point de terminaison propose plus de 200 noms, ou si vous préférez saisir le nom, cliquez sur Saisir manuellement et entrez l'identifiant documenté par votre fournisseur (par exemple meta-llama/Llama-3.3-70B-Instruct, ou un nom de déploiement Azure).
Clé API
Le secret exigé par votre point de terminaison. Claira l'envoie comme jeton bearer avec chaque requête.
Où la trouver : générez-la dans la console de votre fournisseur ou de votre passerelle. Utilisez une clé dédiée à Claira afin de pouvoir la renouveler ou la révoquer sans toucher aux autres systèmes.
Comment Claira la traite : la clé est en écriture seule. Une fois enregistrée, le champ affiche •••• enregistrée. Saisissez une nouvelle clé pour la remplacer., et personne ne peut relire la clé depuis Claira. Elle est stockée chiffrée, jamais écrite dans les journaux, et envoyée uniquement au point de terminaison que vous avez configuré. Pour renouveler la clé, collez la nouvelle et cliquez sur Tester et enregistrer. La clé enregistrée n'est réutilisée que pour l'hôte du point de terminaison avec lequel elle a été enregistrée : si vous remplacez l'URL du point de terminaison par un autre hôte, saisissez aussi la clé de ce point de terminaison avant de tester ou d'enregistrer.
Requêtes simultanées
Le nombre de documents que Claira peut envoyer à votre point de terminaison en même temps pendant une analyse en lot.
À quoi ressemble une bonne valeur : commencez à 1, la valeur par défaut. Après un Tester la connexion réussi, Claira mesure combien de requêtes parallèles votre point de terminaison soutient avec une latence stable et vous propose d'appliquer ce nombre. Voir Optimiser votre connexion. Plage autorisée : 1 à 64.
Fenêtre de contexte
La requête la plus grande, en jetons, que votre modèle accepte : prompt, document et réponse réunis.
Où la trouver : dans la documentation de votre modèle ou les paramètres de lancement de votre serveur, souvent appelée context length ou max model length. Saisissez la vraie valeur : la vérification de contexte long du test de connexion envoie une requête dimensionnée à environ la moitié de cette valeur, si bien qu'une valeur gonflée fait échouer cette vérification. C'est votre point de terminaison qui décide, au moment de l'analyse, si un document tient ; un document qu'il refuse comme trop long est rapporté comme « contenu trop long » dans les résultats d'analyse, quelle que soit la valeur saisie ici. Par défaut : 32 768 jetons.
Jetons de sortie maximum
La réponse la plus longue, en jetons, que Claira demande à votre modèle de produire.
À quoi ressemble une bonne valeur : la valeur par défaut de 8 192 convient aux résumés et aux prompts de codage. Abaissez-la si votre point de terminaison refuse les requêtes qui demandent une sortie volumineuse ; augmentez-la seulement si vos prompts exigent réellement de très longues réponses (la traduction intégrale d'un long document, par exemple) et que votre modèle le permet.
Reconnaissance de résidence
Une case à cocher obligatoire avant l'enregistrement. Elle confirme que vous comprenez que le texte des documents et les prompts envoyés à votre modèle quittent la région de déploiement de Claira et voyagent jusqu'au point de terminaison que vous avez configuré, à votre demande. Les engagements de résidence des données de Claira s'arrêtent à ce point de terminaison ; ce qui se passe ensuite relève de votre entente avec son hébergeur. Voir Confidentialité et sécurité.
Tester la connexion
Deux boutons exécutent les vérifications :
- Tester la connexion exécute toutes les vérifications, calibration comprise, sans rien enregistrer. Une fois le modèle choisi, un seul test suffit pour une première configuration, et vous pouvez l'utiliser plus tard pour mesurer de nouveau votre point de terminaison. Lancé sans modèle, il teste le seul modèle offert par votre point de terminaison, ou vous demande d'en choisir un dans Identifiant du modèle s'il y en a plusieurs.
- Tester et enregistrer exécute les vérifications rapides (tout sauf la calibration) et enregistre la connexion lorsqu'elles réussissent. Il reste désactivé tant que les champs obligatoires et la reconnaissance de résidence ne sont pas remplis.
Chaque vérification est listée avec une étiquette RÉUSSI, ATTENTION ou ÉCHEC, un résultat d'une ligne et un lien En savoir plus.
Vous pouvez exécuter le test de connexion jusqu'à 10 fois par heure pour un dossier. Au-delà, le test est refusé avec un message vous invitant à réessayer plus tard. La connexion enregistrée continue de fonctionner normalement ; cette limite ne s'applique qu'à l'exécution du test lui-même.
L'ensemble du test s'exécute dans une limite de temps d'environ dix minutes. Si votre point de terminaison répond très lentement, les vérifications facultatives qui n'ont pas pu démarrer avant la limite sont marquées ATTENTION comme ignorées : les vérifications qui ont été exécutées sont tout de même rapportées, et une connexion s'enregistre quand même lorsque les vérifications obligatoires réussissent. La vérification Multi-Code n'est jamais ignorée de cette façon : elle s'exécute avant les vérifications facultatives, de sorte qu'un point de terminaison lent ne peut pas laisser Multi-Code désactivé sans vous dire pourquoi. Relancez Tester la connexion lorsque le point de terminaison est moins occupé pour compléter le tableau.
| Vérification | Ce qu'elle confirme | En cas d'avertissement ou d'échec |
|---|---|---|
| URL | L'URL du point de terminaison est bien formée, utilise HTTPS et pointe vers une adresse publique. | ÉCHEC : corrigez l'adresse comme décrit sous URL du point de terminaison. Aucune autre vérification ne s'exécute tant que celle-ci ne réussit pas. |
| Joignabilité | Claira peut ouvrir une connexion sécurisée et votre point de terminaison accepte la clé API sur une requête minimale. | ÉCHEC avec une erreur de clé : la clé a été refusée. Vérifiez les espaces parasites ou une clé expirée. ÉCHEC avec une erreur d'injoignabilité : vérifiez le nom d'hôte, le pare-feu et le certificat (les certificats autosignés ne sont pas acceptés). |
| Modèles | Votre point de terminaison répond à la requête de découverte de modèles. | ATTENTION : la découverte n'est pas disponible. Saisissez l'Identifiant du modèle manuellement. L'enregistrement fonctionne quand même. |
| Complétion | Un prompt de revue représentatif d'environ 1 200 jetons renvoie une vraie réponse. Mesure la latence et les jetons par seconde. | ÉCHEC : l'identifiant du modèle est peut-être erroné, ou le modèle n'a rien renvoyé. Confirmez l'identifiant et essayez une valeur plus petite pour Jetons de sortie maximum. |
| Multi-Code | Trois requêtes d'exemple renvoient un JSON bien formé indexé par alias de champ. | ATTENTION : Multi-Code est désactivé pour cette connexion ; les prompts à champ unique fonctionnent toujours. Un modèle plus capable ou ajusté aux instructions règle généralement le problème. |
| Diffusion en continu | Votre point de terminaison peut diffuser des réponses partielles. | ATTENTION : les réponses des revues uniques apparaissent d'un coup plutôt que mot à mot. Les analyses fonctionnent normalement. |
| Contexte long | Une requête dimensionnée à environ la moitié de la fenêtre de contexte déclarée (jusqu'à environ 48 000 jetons) réussit. | ATTENTION : abaissez la Fenêtre de contexte à ce que le point de terminaison accepte réellement, sinon les documents volumineux échoueront. |
| Calibration | Envoie un nombre croissant de requêtes parallèles (1, 2, 4, 6, 8 et au-delà lorsque votre déploiement le permet) et s'arrête quand la latence dépasse deux fois et demie la latence d'une requête seule ou qu'une erreur apparaît. | Informative : rapporte le parallélisme le plus élevé que votre point de terminaison a soutenu. S'exécute uniquement avec Tester la connexion. |
Une connexion s'enregistre lorsque URL, Joignabilité et Complétion réussissent. Les avertissements sont conservés avec la connexion pour que vous puissiez voir plus tard quelles capacités ont été désactivées et pourquoi.
Optimiser votre connexion
Commencez à 1. Une nouvelle connexion envoie un document à la fois. C'est lent mais sûr : cela ne peut pas surcharger un point de terminaison, et cela vous laisse confirmer les résultats avant de monter en charge.
Appliquez la recommandation. Lorsqu'un Tester la connexion constate que votre point de terminaison soutient plus de requêtes parallèles que votre réglage actuel, une bannière verte indique Votre point de terminaison a soutenu N requêtes simultanées avec une latence stable. Cliquez sur Appliquer la recommandation (N) pour régler Requêtes simultanées à cette valeur en un clic.
Le curseur de vitesse d'analyse suit votre réglage. Pendant une analyse en lot en direct, le curseur Vitesse d'analyse va toujours de La plus lente à La plus rapide, mais son échelle est désormais la capacité de votre connexion : La plus rapide correspond au nombre complet de requêtes simultanées que vous avez configuré, et chaque cran en dessous en envoie proportionnellement moins. Équilibrée, la valeur par défaut, garde un peu de marge.
Quand l'augmenter : le compteur d'échecs reste à zéro, les résultats arrivent proprement et vous voulez que l'exécution se termine plus tôt. Relancez d'abord Tester la connexion si le matériel ou le quota de votre point de terminaison a changé.
Quand le réduire : des documents échouent avec des erreurs « point de terminaison ne répond pas » ou de délai dépassé, ou le tableau de bord de votre point de terminaison montre qu'il sature. Claira protège aussi votre point de terminaison automatiquement : lorsque les erreurs se concentrent, elle envoie temporairement moins de requêtes parallèles que ce que vous avez configuré et revient à votre réglage dès que les réponses sont de nouveau saines. Le panneau affiche Attention requise lorsque la connexion signale Dégradé (la plupart des requêtes récentes ont échoué) ou lorsque votre clé a été refusée ; un taux d'erreur plus modéré ralentit l'exécution sans changer l'état. L'état est partagé entre les serveurs de Claira : une clé refusée ou une série d'échecs constatée n'importe où s'affiche à chaque rafraîchissement jusqu'à ce que votre point de terminaison réponde de nouveau correctement (un Tester la connexion réussi avec votre clé enregistrée compte), et la ligne d'état nomme le dernier problème en clair ; le code d'erreur lui-même se trouve dans Diagnostics.
Ce qui est acheminé vers votre modèle
Sur un dossier Claira Private, tout ce qui utilise un modèle va à votre point de terminaison, pour toute personne du dossier qui n'a pas activé de modèle local :
- Revues uniques : le bouton Analyser le document du Laboratoire de prompts, et le Multi-Code sur un seul document.
- Analyses en lot : les tâches en lot qui s'exécutent dans votre onglet de navigateur. La boîte de dialogue de confirmation affiche une ligne Modèle nommant votre modèle, avec un avertissement en dessous si la connexion requiert actuellement votre attention.
- Multi-Code : chaque champ d'une passe Multi-Code, unique ou en lot, pourvu que le test de connexion ait confirmé que votre modèle renvoie un JSON bien formé.
- Les conversations du Mode agent.
- La génération et la révision des Insights.
- Le Contexte du dossier rédigé à partir de documents, et ses mises à jour depuis le Mode agent. Votre modèle reçoit le texte extrait de chaque document.
- Les suggestions de Réviser avec l’Agent.
- Le générateur de requêtes.
Ce que chacune de ces fonctions peut faire dépend de votre modèle. Le Mode agent, par exemple, a besoin d'un modèle qui prend en charge l'appel de fonctions pour lancer des analyses, proposer des champs ou modifier le Contexte du dossier. Choisissez un modèle capable et ajusté aux instructions pour obtenir les meilleurs résultats.
Rien n'est envoyé à l'un des modèles de Claira à la place. Si la connexion partagée est absente ou révoquée, ces fonctions vous indiquent qu'aucun modèle n'est connecté et ne s'exécutent pas. Les tâches en lot et les conversations sont nommées avec la dénomination descriptive standard de Claira, sans appel de modèle.
Limites de cette version
- Analyses de texte seulement. Analyser comme reste sur Texte. Les analyses Image, Audio, Vidéo et Auto ne sont pas disponibles dans Claira Private.
- Exécutions en direct seulement. Les analyses en lot s'exécutent dans votre onglet de navigateur ; gardez la fenêtre ouverte jusqu'à la fin de la tâche. Le traitement en arrière-plan n'est pas disponible dans Claira Private.
- Point de terminaison HTTPS joignable publiquement avec un certificat d'une autorité de certification publique. Les certificats autosignés et d'AC privée ne sont pas acceptés.
- Aucune liste d'adresses IP autorisées. Claira ne publie pas d'adresses sortantes fixes dans cette version ; votre point de terminaison doit donc accepter les requêtes authentifiées venant d'Internet. Contrôlez l'accès avec la clé API, pas avec une règle de pare-feu.
- Aucune adresse privée. Les noms d'hôte de bouclage, de réseau privé, de lien local et internes sont refusés. Utilisez un modèle local pour un modèle installé sur votre propre machine.
- Une connexion par dossier. Enregistrer un nouveau point de terminaison remplace le précédent pour ce dossier.
- Format chat-completions d'OpenAI seulement. Les points de terminaison qui parlent un autre format de requête ont besoin d'une passerelle compatible devant eux.
Erreurs et reprise
Les erreurs de votre point de terminaison sont rapportées avec les mêmes codes que les autres erreurs d'analyse. Consultez Codes d'erreur pour la référence complète, y compris les codes Claira Private. Les situations propres à votre propre modèle :
Votre point de terminaison ne répond pas. Les documents échouent avec un message « point de terminaison ne répond pas », et pendant une analyse en lot une bannière ambre apparaît au-dessus des résultats en direct dès que plusieurs documents d'affilée échouent ainsi. Si la panne arrête les processus, la tâche est marquée Incomplète : corrigez le point de terminaison ou son chemin réseau, confirmez avec Tester la connexion, puis cliquez sur Reprendre la tâche dans les Tâches en lot : les documents qui ont déjà un résultat ne sont pas réanalysés. Voir Si l'analyse s'arrête avant la fin.
Votre clé API a été refusée. Claira cesse immédiatement d'envoyer des requêtes plutôt que de faire échouer chaque document restant, la bannière indique que le point de terminaison a refusé la clé, et la connexion affiche Attention requise. Collez une clé valide dans le champ Clé API et cliquez sur Tester et enregistrer ; la connexion se rétablit dès que la nouvelle clé est vérifiée, et vous pouvez reprendre la tâche.
Un document est trop volumineux pour votre modèle. Le document échoue avec le message « contenu trop long ». Vérifiez que la Fenêtre de contexte correspond à votre modèle, ou divisez le document.
Une analyse a été refusée avant de démarrer. Une exécution Multi-Code sur une connexion dont la vérification Multi-Code n'a pas réussi est refusée avec un message nommant la raison. Exécutez les champs comme des prompts à champ unique, ou connectez un modèle qui réussit la vérification.
Diagnostics. Sur la ligne connectée du panneau, ouvrez Diagnostics pour voir les erreurs les plus récentes renvoyées par votre point de terminaison (heure, code d'erreur, statut en amont et latence) ainsi que l'état de santé actuel. Partagez cette vue avec la personne qui exploite votre point de terminaison lorsque vous la contactez.
Révoquer la connexion
Sous Paramètres de l'équipe, ouvrez la section Connexion partagée, cliquez sur Modifier la connexion partagée, puis sur Révoquer sur la ligne connectée. Comme la révocation touche tout le monde dans le dossier, Claira vous demande d'abord de confirmer. Une fois la confirmation donnée, Claira cesse immédiatement d'utiliser le point de terminaison et sa clé. Tant que personne ne connecte de nouveau un modèle, les analyses et les autres fonctions IA du dossier sont refusées avec un message indiquant qu'aucun modèle n'est connecté, sauf pour les utilisateurs qui travaillent sur leur propre modèle local. Vous pouvez reconnecter le même point de terminaison ou un autre à tout moment ; saisissez de nouveau la clé à ce moment-là.
Modèle local
Un modèle local fait fonctionner Claira sur un modèle installé sur votre propre ordinateur. Votre navigateur envoie chaque document directement à ce modèle et en relit la réponse. Pour la revue elle-même, le texte des documents ne quitte jamais votre machine : il ne voyage pas jusqu'aux serveurs de Claira, ni jusqu'à ceux de qui que ce soit d'autre.
Tant que votre modèle local est activé, les serveurs de Claira n'effectuent aucun appel de modèle, d'aucune sorte, pour vous sur ce dossier : ni vers les modèles de Claira, ni vers la connexion partagée. Chaque réponse que vous voyez est produite par votre modèle, dans votre navigateur. Et si Claira ne peut pas confirmer si votre modèle local est activé (un bref incident de service, par exemple), elle refuse la demande et vous le dit, plutôt que de deviner ; voir Erreurs du modèle local.
Un modèle local est le vôtre, et propre à chaque dossier. L'activer n'affecte que votre propre travail dans ce dossier ; un collègue du même dossier continue d'utiliser la connexion partagée. C'est important, parce qu'un modèle installé sur une machine est personnel : la revue de personne d'autre n'est interrompue par votre choix.
Ce dont vous avez besoin sur votre machine
- Un serveur de modèles sur votre ordinateur ou votre réseau : Ollama, LM Studio, vLLM ou llama.cpp. Voir Serveurs locaux pris en charge.
- Un modèle téléchargé et chargé dans ce serveur. Un modèle capable et ajusté aux instructions donne des résultats de revue nettement meilleurs qu'un tout petit modèle ; voir Ce qui fonctionne avec un modèle local pour savoir ce dont chaque fonction a besoin.
- Le serveur configuré pour accepter les requêtes de Claira : un réglage par serveur, décrit ci-dessous.
- L'autorisation de Chrome d'atteindre votre propre réseau, accordée une seule fois. Voir L'autorisation du navigateur.
L'activer
- Démarrez votre serveur de modèles et chargez le modèle que vous voulez utiliser.
- Ouvrez les Paramètres dans le panneau Claira, ouvrez la section Votre modèle sous Vos paramètres, puis choisissez Modèle local.
- Sous Serveurs locaux pris en charge, faites le réglage dont votre serveur a besoin : Claira l'indique pour chaque serveur, avec l'adresse de Claira déjà remplie. Redémarrez ensuite le serveur. Voir Serveurs locaux pris en charge.
- Cliquez sur Détecter les serveurs locaux. Claira regarde sur les ports habituels (11434, 1234, 8000 et 8080) et liste tout ce qui répond ; cliquez sur Utiliser ce serveur sur la ligne d'un serveur. Si rien ne répond, cliquez sur Saisir le point de terminaison manuellement et saisissez vous-même l'adresse dans URL du point de terminaison. Pour Claira,
http://localhost:11434,http://localhost:11434/ethttp://localhost:11434/v1sont la même adresse. - Choisissez le Modèle dans la liste renvoyée par votre serveur, et donnez-lui un Nom d'affichage : celui que Claira utilisera dans les Paramètres, l'indicateur et l'historique des tâches. N'ajoutez une Clé API que si votre serveur local en exige une.
- Cliquez sur Confirmer dans ce navigateur. Si Claira joint votre modèle par la fenêtre passerelle, cette fenêtre affiche votre modèle prêt à être confirmé : cliquez sur Confirmer et démarrer dans cette fenêtre, et Claira poursuit.
- Claira exécute une courte série de vérifications sur le modèle et affiche une ligne RÉUSSI, ATTENTION ou ÉCHEC pour chacune : que l'adresse est joignable, que le modèle complète un prompt de revue, s'il renvoie un JSON bien formé pour Multi-Code, s'il prend en charge le mode de sortie JSON et l'appel de fonctions, s'il diffuse en continu, et quelle quantité de travail il peut traiter à la fois. Lorsque les vérifications réussissent, votre modèle local est activé.
Claira confirme que les analyses de ce dossier s'exécutent désormais sur votre modèle dans ce navigateur, et un badge Modèle local apparaît dès lors dans l'interface. Vous pouvez fermer le panneau : votre modèle local reste actif, tout comme la fenêtre passerelle si vous en utilisez une.
Si les capacités de votre modèle changent (vous avez chargé un modèle plus grand, ou augmenté sa fenêtre de contexte), cliquez sur Relancer les vérifications de capacités pour le mesurer de nouveau sans reconfigurer la connexion depuis le début.
Serveurs locaux pris en charge
Les navigateurs refusent qu'une page Web parle à un serveur installé sur votre propre machine, à moins que ce serveur ne déclare explicitement que la page est la bienvenue. Ce réglage s'appelle CORS, et chaque serveur l'écrit à sa manière. Dans tous les cas, c'est l'adresse de Claira que vous inscrivez sur la liste d'autorisation (l'adresse à laquelle Claira elle-même s'exécute, qui ressemble à https://nuix-ca.claira.to), et non l'adresse de votre modèle.
| Serveur | Port habituel | Ce qu'il faut configurer |
|---|---|---|
| Ollama | 11434 | Réglez OLLAMA_ORIGINS sur l'adresse de Claira avant de démarrer Ollama, par exemple OLLAMA_ORIGINS=https://nuix-ca.claira.to ollama serve. Par défaut, Ollama n'accepte les requêtes des navigateurs qu'en provenance de 127.0.0.1 et 0.0.0.0 ; sans ce réglage, il refuse Claira. Sur macOS, définissez-le avec launchctl setenv OLLAMA_ORIGINS <adresse> puis redémarrez Ollama ; sur Linux, ajoutez-le à la surcharge du service systemd ; sur Windows, définissez-le comme variable d'environnement utilisateur et redémarrez Ollama. |
| LM Studio | 1234 | Ouvrez les paramètres du serveur et activez Enable CORS. Si LM Studio s'exécute sur une machine différente de celle de votre navigateur, activez aussi Serve on Local Network. |
| vLLM | 8000 | Généralement rien. vLLM démarre avec --allowed-origins ['*'], ce qui accepte déjà Claira. Si votre déploiement a restreint cette liste, ajoutez-y l'adresse de Claira. |
| llama.cpp / LocalAI | 8080 | Démarrez le serveur avec CORS activé et ajoutez l'adresse de Claira à ses origines autorisées. Si vous l'exécutez derrière un proxy inverse, c'est le proxy qui doit autoriser l'adresse. |
Tout autre serveur qui parle l'API chat-completions d'OpenAI fonctionne également : saisissez son adresse manuellement et configurez son propre réglage CORS de la même façon.
L'autorisation du navigateur
Les versions récentes de Chrome demandent l'autorisation avant de laisser un site Web joindre un serveur installé sur votre ordinateur ou votre réseau. La première fois que Claira contacte votre modèle, Chrome affiche une demande d'autorisation réseau local. Choisissez Autoriser. Claira ne peut pas joindre votre modèle tant que vous ne l'avez pas fait, et si vous fermez ou refusez la demande, les analyses échouent avec un message indiquant que le navigateur n'a pas autorisé l'accès.
Pour changer votre réponse plus tard, ouvrez les paramètres de site de Chrome pour l'adresse de Claira et réglez-y l'autorisation de réseau local.
Pour le service TI : accorder l'autorisation à l'avance. Les administrateurs peuvent l'accorder pour tout le monde avec la stratégie Chrome LocalNetworkAccessAllowedForUrls. Réglez-la sur l'origine de l'interface Claira (l'adresse depuis laquelle Claira est servie, par exemple https://nuix-ca.claira.to), et non sur le point de terminaison du modèle. C'est la page qui émet la requête que la stratégie nomme, pas la destination. La stratégie complémentaire LocalNetworkAccessBlockedForUrls empêchera un modèle local de fonctionner si l'adresse de Claira y figure.
Firefox et Safari n'ont pas de barrière équivalente ; aucune demande n'apparaît donc dans ces navigateurs.
La fenêtre passerelle
Claira s'exécute à l'intérieur de Nuix Discover sous forme de panneau intégré. Les navigateurs ne laissent pas un panneau intégré joindre votre propre réseau, quelle que soit votre réponse à la demande d'autorisation : la restriction porte sur le fait d'être intégré, pas sur l'autorisation. Alors, lorsque c'est nécessaire, Claira ouvre une petite fenêtre séparée à l'adresse propre de Claira, qui n'est pas intégrée et a donc le droit de parler à votre modèle. Chaque requête vers votre modèle passe par cette fenêtre.
- Claira essaie d'abord la voie directe. Dans les navigateurs et les configurations où le panneau lui-même peut joindre votre modèle, aucune fenêtre passerelle n'est nécessaire et aucune ne s'ouvre. Le badge Modèle local vous indique laquelle est utilisée.
- Ouvrez-la depuis le panneau Modèle local ou depuis le badge avec Ouvrir la passerelle. Si votre navigateur bloque la fenêtre contextuelle, autorisez les fenêtres contextuelles pour Claira, ou utilisez le lien que Claira propose à la place.
- Gardez-la ouverte pendant que Claira travaille. C'est là que votre modèle s'exécute. La fermer empêche Claira de joindre votre modèle : le badge passe à l'ambre, et Claira bloque les nouvelles analyses avec un panneau proposant de la rouvrir plutôt que de faire échouer document après document.
- C'est une seule fenêtre, réutilisée. Cliquer de nouveau sur Ouvrir la passerelle ramène au premier plan la fenêtre que vous avez déjà.
- Vous confirmez votre modèle une seule fois. Lorsque vous cliquez sur Confirmer dans ce navigateur et que Claira a besoin de la fenêtre passerelle, elle remplit le formulaire de cette fenêtre avec le modèle choisi, sous Confirmer votre modèle local, et la boîte de dialogue Modèle local vous demande de le confirmer là. Vérifiez-le et cliquez sur Confirmer et démarrer : Claira poursuit d'elle-même dans la boîte de dialogue. Ouverte seule pour la première fois, la fenêtre affiche aussi le titre Confirmer votre modèle local ; Changer le point de terminaison n'apparaît qu'une fois un point de terminaison confirmé dans cette fenêtre.
La fenêtre passerelle affiche l'adresse du point de terminaison et le modèle qu'elle utilise, si le navigateur a accordé l'autorisation de réseau local, si votre modèle répond, combien de requêtes elle a traitées, combien sont en cours, et la dernière erreur s'il y en a eu une. C'est votre preuve que c'est bien votre propre modèle qui fait le travail.
Confirmer et démarrer contacte votre modèle avant d'enregistrer. Lorsque vous confirmez un point de terminaison dans la fenêtre passerelle, Claira lui envoie, depuis cette fenêtre, la même requête de liste de modèles qu'une analyse. Si le serveur ne répond pas, refuse la requête ou rejette votre clé, la fenêtre en donne la raison (le même message qu'une analyse afficherait), l'enregistre sous Dernière erreur et conserve le point de terminaison précédent (ou aucun) jusqu'à ce que vous corrigiez le problème. Le bouton affiche un état d'attente pendant la vérification, et une nouvelle tentative repart de zéro : un point de terminaison qui n'était simplement pas encore démarré peut être confirmé dès qu'il l'est.
Ce que la fenêtre passerelle fait et ne fait pas. Elle ne contacte jamais que le point de terminaison que vous avez confirmé dans cette fenêtre. Le panneau Claira peut remplir le formulaire pour vous, mais rien n'est contacté ni enregistré avant que vous cliquiez sur Confirmer et démarrer ; une adresse provenant d'ailleurs est ignorée, et elle revérifie l'adresse à chaque requête, sans exception. Elle n'envoie jamais votre authentification Nuix ou Claira avec une requête vers votre modèle. Votre clé locale, si vous en avez défini une, est lue depuis ce navigateur et envoyée uniquement à votre modèle.
Ce qui fonctionne avec un modèle local
Certaines fonctions s'exécutent directement sur votre modèle, parce que votre navigateur dispose déjà de tout ce qu'il lui faut. D'autres ont besoin que les serveurs de Claira préparent d'abord les instructions : les serveurs de Claira construisent la requête, votre modèle y répond dans votre navigateur, et les serveurs de Claira interprètent la réponse. Dans les deux cas, la réflexion se fait sur votre machine.
S'exécute directement sur votre modèle
| Fonction | Notes |
|---|---|
| Revue d'un seul document | Diffusée mot à mot, comme avec tout autre modèle. |
| Revue en lot (en direct) | Le bassin complet de processus, le curseur de vitesse d'analyse, le flux en direct, l'annotation des erreurs et la reprise. Le nombre de documents traités à la fois part de ce que votre modèle a mesuré lors de la configuration. |
| Multi-Code (en lot et unique) | Offert lorsque la vérification Multi-Code a réussi pour votre modèle. |
| Utiliser Multi-Code dans le Laboratoire de prompts | Offert sur votre modèle. |
S'exécute sur votre modèle avec Claira qui prépare la requête
Chacune de ces fonctions exige quelque chose de précis de votre modèle. Les vérifications de configuration vous indiquent à l'avance si le vôtre en est capable, et Claira le dit clairement plutôt que d'utiliser discrètement un autre modèle.
| Fonction | Ce dont votre modèle a besoin | S'il n'en est pas capable |
|---|---|---|
| Générateur de requêtes | Texte brut | Sans objet |
| Titres des Insights | Texte brut | Sans objet |
| Contexte du dossier à partir de documents | Mode de sortie JSON | Claira demande plutôt le JSON dans la requête, et signale une erreur claire si la réponse est illisible |
| Réviser avec l’Agent | Mode de sortie JSON | Idem |
| Insights | Une fenêtre de contexte utilisable | Claira lit les documents par lots et fusionne les constats. Si un seul document ne tient pas à lui seul, Claira le dit et vous demande de restreindre la sélection ou d'utiliser un modèle doté d'une fenêtre plus grande |
| Conversation en Mode agent | L'appel de fonctions, pour l'expérience complète | L'Agent se rabat sur une conversation sans outils avec un avis qui reste à l'écran : il peut répondre aux questions et expliquer les choses, mais il ne peut pas lancer d'analyses, proposer des champs ni modifier le Contexte du dossier |
Avec un modèle local, Contexte du dossier à partir de documents n'envoie à votre modèle que le texte extrait de chaque document, jamais son fichier natif. Un document sans texte extrait est laissé de côté, et Claira le nomme lorsque le contexte est mis à jour.
La progression est affichée pendant que votre modèle travaille (Votre modèle local réfléchit…, Analyse des documents 3 sur 7, Fusion des constats, Exécution des outils…) parce qu'un modèle local peut prendre nettement plus de temps qu'un modèle infonuagique.
Inchangé, aucun modèle en jeu
Le Laboratoire de prompts, l'historique des prompts, les épingles et les commentaires, les modèles de prompts, la Migration de champs, la Création de champs, les champs connectés, la lecture, la modification et l'approbation du Contexte du dossier, le pouce vers le haut ou vers le bas sur une réponse, l'utilisation et la facturation, et les exportations se comportent tous exactement comme d'habitude.
Les tâches en lot et les fils de conversation reçoivent toujours un nom automatiquement, avec la dénomination descriptive standard de Claira plutôt qu'un titre rédigé par un modèle. Les titres des Insights, eux, sont rédigés par votre modèle local, comme indiqué ci-dessus.
Non disponible avec un modèle local
| Fonction | Quoi faire à la place |
|---|---|
| Analyses en arrière-plan | Le traitement en arrière-plan n'est pas disponible dans Claira Private. Lancez plutôt les analyses en lot en direct, et gardez la fenêtre ouverte. |
| Analyses d'images, d'audio, de vidéo et de PDF | Votre modèle local ne reçoit que du texte. Analysez ces documents en Texte. |
| Évaluation préliminaire | Le lancement d'une évaluation est refusé avec un message qui l'indique, et rien n'est enregistré. Les évaluations précédentes restent disponibles pour la lecture, le téléchargement et la suppression. Voir Évaluation préliminaire. |
La case Exécuter en tant que tâche en arrière-plan et les options non textuelles du menu Analyser comme ne sont pas proposées, pour que vous ne restiez jamais dans le doute.
Désactiver le modèle local
- Dans la section Votre modèle des Paramètres, cliquez sur l'option Connexion partagée, ou ouvrez Paramètres du modèle local et cliquez sur Utiliser la connexion partagée.
- Claira demande Passer à la connexion partagée ? Cliquez sur Passer à la connexion partagée.
Dès lors, votre travail dans le dossier s'exécute de nouveau sur la connexion partagée, comme celui de tout le monde. Si le dossier n'a pas encore de connexion partagée, les fonctions IA vous indiquent qu'aucun modèle n'est connecté jusqu'à ce que quelqu'un en configure une, ou jusqu'à ce que vous réactiviez votre modèle local.
Comme un modèle local est propre à chaque utilisateur et à chaque dossier, le désactiver dans un dossier n'affecte aucun autre dossier sur lequel vous travaillez, et n'affecte jamais un collègue.
Dépannage d'un modèle local
« Aucun serveur de modèle local n'a répondu sur les ports habituels. » Votre serveur n'est pas en cours d'exécution, il n'a pas encore son réglage, ou il est sur un autre port. Confirmez que le serveur est démarré (ouvrez sa propre adresse dans un onglet de navigateur) et qu'il a le réglage indiqué sous Serveurs locaux pris en charge, redémarrez-le, puis cliquez de nouveau sur Détecter les serveurs locaux, ou cliquez sur Saisir le point de terminaison manuellement.
« Votre modèle local n'a pas été confirmé dans la fenêtre passerelle. » Claira a rempli le formulaire de la fenêtre passerelle avec votre modèle, mais Confirmer et démarrer n'y a pas été cliqué à temps, et rien n'a donc été activé. Cliquez de nouveau sur Confirmer dans ce navigateur, trouvez la fenêtre passerelle (elle est peut-être derrière d'autres fenêtres) et cliquez sur Confirmer et démarrer.
« Votre modèle local ne répond pas. » C'est presque toujours le réglage CORS. Vérifiez que votre serveur autorise l'adresse de Claira exactement telle qu'elle est affichée dans le panneau Modèle local, https:// compris et sans barre oblique finale, et redémarrez le serveur après l'avoir modifiée : la plupart des serveurs ne lisent ce réglage qu'au démarrage. Si le serveur s'exécute sur une autre machine, confirmez qu'il écoute sur le réseau et non uniquement sur sa propre adresse de bouclage (dans LM Studio, c'est Serve on Local Network). Si ce message apparaît sous Confirmer et démarrer dans la fenêtre passerelle, rien n'a été enregistré : corrigez le réglage, redémarrez le serveur, puis cliquez de nouveau sur Confirmer et démarrer.
« Votre point de terminaison a répondu, mais ce navigateur a refusé de l'enregistrer. » La fenêtre passerelle conserve le point de terminaison dans les données de site de ce navigateur, ce qu'une fenêtre privée ou de navigation privée (ou un blocage des données de site pour l'adresse de Claira) empêche. Ouvrez la passerelle dans une fenêtre normale, ou autorisez les données de site pour Claira, puis cliquez de nouveau sur Confirmer et démarrer.
« Votre navigateur n'a pas autorisé Claira à joindre votre réseau local. » Choisissez Autoriser dans la demande de réseau local de Chrome, ou réinitialisez l'autorisation dans les paramètres de site de Chrome pour l'adresse de Claira. Sur un appareil géré, demandez au service TI d'ajouter l'adresse de Claira à LocalNetworkAccessAllowedForUrls. Voir L'autorisation du navigateur.
« La fenêtre passerelle est fermée ou ne répond pas. » Cliquez sur Ouvrir la passerelle et laissez la fenêtre ouverte pendant que vous travaillez. Si votre navigateur a bloqué la fenêtre contextuelle, autorisez les fenêtres contextuelles pour Claira. Les analyses s'arrêtent proprement lorsque la passerelle se ferme en cours d'exécution : corrigez le problème et cliquez sur Reprendre la tâche dans les Tâches en lot ; les documents qui ont déjà un résultat ne sont pas réanalysés.
Multi-Code n'est pas offert. Votre modèle n'a pas renvoyé de JSON bien formé pendant les vérifications. Chargez un modèle plus capable et ajusté aux instructions, augmentez sa limite de sortie si elle était basse, puis cliquez sur Relancer les vérifications de capacités. En attendant, les prompts à champ unique fonctionnent normalement.
L'Agent dit qu'il ne peut pas lancer d'analyses ni modifier le Contexte du dossier. Votre modèle ne prend pas en charge l'appel de fonctions. Il peut tout de même répondre aux questions et expliquer les choses. Chargez un modèle qui prend en charge l'usage d'outils et cliquez sur Relancer les vérifications de capacités, ou désactivez votre modèle local et utilisez la connexion partagée pour ce travail.
« Ce document dépasse la fenêtre de contexte de votre modèle local. » Fractionnez le document avec Unitize, ou chargez un modèle doté d'une fenêtre plus grande. Les modèles locaux ont généralement des fenêtres bien plus petites que celles des modèles hébergés.
Tout est lent. C'est votre matériel, pas Claira. Abaissez le curseur de vitesse d'analyse pour que votre machine ne s'épuise pas, ou chargez un modèle plus petit et plus rapide. Lancer une grosse analyse en lot sur un portable alimenté par sa batterie est nettement plus lent que sur secteur.
Les résultats sont moins bons que prévu. Un petit modèle local est réellement moins capable. Testez de 10 à 25 documents avec la Revue unique avant de vous engager dans une grosse analyse en lot, et resserrez votre prompt (définitions, valeurs permises, format de sortie) avant de blâmer le modèle. Voir Pourquoi vous pourriez ne pas obtenir deux fois la même réponse.
Tarification et facturation
Claira Private coûte 899 $ par dossier et par mois, quelle que soit la façon dont vous connectez votre modèle et quel que soit le nombre de personnes qui travaillent dans le dossier. La connexion partagée et les modèles locaux sont tous deux inclus.
- Aucun jeton. Un dossier Claira Private n'a pas de solde de jetons, pas de demandes gratuites quotidiennes, pas de lots de jetons et pas de dépassement, et rien n'est estimé ni facturé par document.
- Aucune limite de documents. Analysez autant que votre modèle peut en traiter.
- Facturé comme tout autre forfait. Payez par carte ou sur votre facture mensuelle. Ce que votre fournisseur de point de terminaison vous facture, ou ce que coûte l'exploitation de votre propre matériel, relève de votre entente avec lui.
Voir Forfaits et facturation.
Voir aussi
- Forfaits et facturation
- Activation du dossier
- Confidentialité et sécurité
- Codes d'erreur
- Analyse en lot
Besoin d'aide ? Contactez-nous à support@claira.to pour discuter de vos besoins d'intégration de modèle.
Cette page vous a aide?
Continuer la lecture
Contrôles d'activation pour les dossiers sensibles
Comment l'activation explicite de Claira au niveau du dossier et du groupe d'utilisateurs permet aux administrateurs d'exclure entièrement les dossiers restreints du traitement par IA.
Configurer Claira Private
Un guide étape par étape pour un dossier sur Claira Private : l'activer, choisir comment connecter votre propre modèle, le configurer, vérifier qu'il fonctionne et changer plus tard.
Besoin d'aide supplémentaire?
Contactez notre équipe de support à support@claira.to — nous sommes là pour vous aider.