> ## Documentation Index
> Fetch the complete documentation index at: https://docs.lighton.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Clés de Configuration

> En utilisant ces valeurs de clés de configuration, les administrateurs peuvent adapter l'environnement Paradigm pour mieux répondre aux besoins de leur organisation.

La section Config Key (Paramètres) 'admin/settings/' du panneau d'administration de Paradigm permet aux administrateurs système de modifier les paramètres qui impactent toutes les entreprises et utilisateurs connectés à l'instance.

## General

**DEFAULT\_LANGUAGE**

Spécifie la langue par défaut pour l'interface système et les communications. Cela affecte :

* La langue des emails d'invitation envoyés aux nouveaux utilisateurs
* Les pages de création de mot de passe et de connexion
* L'ensemble de l'interface utilisateur de Paradigm

Valeur par défaut : en

**DEFAULT\_SUPPORT\_EMAIL**

Définit l’adresse email de support **par défaut au niveau de l’instance**.\
Cette adresse est **pré-remplie automatiquement** lors de la création d’une nouvelle company (dans les **Chat settings** admin).

**Propriétés**

* **Valeur par défaut :** `support@lighton.ai`
* **Obligatoire :** Oui
* **Surcharge possible :** Oui, au niveau **company** par un company admin

**Fonctionnement**

1. Un **system admin** définit l’adresse mail de support dans la **configuration de l’instance**.\
   → Cette valeur devient l’**adresse de support par défaut**.
2. À chaque création de **company**, cette adresse est **pré-saisie** dans les **Chat settings** de l’admin de la company.
3. **Quand est-elle utilisée ?**\
   Lorsqu’un utilisateur clique sur **“Flag a bug”** dans l’interface de chat, le rapport complet (contexte + détails) est envoyé à l’adresse configurée dans les **Chat settings**.
4. **Surcharge côté company (cas confidentialité)**\
   Si un client ne souhaite pas que les tickets arrivent chez LightOn, un **company admin** peut remplacer l’adresse de support pour sa company.\
   → Dans ce cas, les rapports de bug sont envoyés à l’**adresse définie par la company**, et non à LightOn.

**SUPPORT\_URL**

Spécifie l'URL où les utilisateurs peuvent accéder aux articles d'aide, tutoriels et documentation.

Valeur par défaut : [https://lighton.mintlify.app/en](https://lighton.mintlify.app/en)

🧭 Note : Ce portail de support est propulsé par Mintlify, qui fournit une expérience de documentation et d'onboarding fluide. Vous pouvez remplacer ou supprimer cette intégration à tout moment via cette page de configuration si votre organisation utilise une autre plateforme de documentation. Par défaut, Mintlify respecte les réglementations de conformité standard de l'industrie, garantissant la sécurité et la confidentialité des données pour votre documentation.

**LOG\_RETENTION\_PERIOD\_DAYS**

Détermine le nombre de jours pendant lesquels les données de log sont conservées avant d'être anonymisées pour se conformer aux politiques de conservation des données.

Valeur par défaut : 180

**THEME**

Définit le thème ou l'identité visuelle actuel pour l'interface système. Affecte les couleurs, polices et présentation visuelle générale.

Valeur par défaut : Paradigm New Branding

## Agent

**IS\_AGENT\_ON**

Active ou désactive la fonctionnalité de mode agentique au niveau de l'instance. Lorsqu'elle est activée, le modèle peut exécuter plusieurs requêtes séquentielles à travers différents outils pour accomplir des tâches complexes, plutôt que d'être limité à un seul appel d'outil par interaction.

Valeur par défaut : True

🧭 Note : L'activation de cette clé de configuration rend le mode agent disponible au niveau de l'instance. Une fois activé, vous devez naviguer vers les paramètres de chat de votre choix pour activer le mode agent pour une entreprise spécifique.

## API

**DEFAULT\_API\_KEY\_DURATION**

Définit la durée d'expiration par défaut pour les clés API créées via l'interface Paradigm.

Valeur par défaut : 180 jours

**HEALTHCHECK\_ALERTING\_COOLDOWN**

Définit l'intervalle minimum entre deux alertes de vérification d'état pour éviter la fatigue d'alertes.

Valeur par défaut : 240 jours

**HEALTHCHECK\_ALERTING\_EMAIL**

Spécifie l'adresse email recevant les notifications d'échec de vérification d'état.

**IS\_API\_ON**

Indique si la fonctionnalité API est activée pour l'accès programmatique.

Valeur par défaut : Yes

## Authentication

**ACCESS\_GRANT\_DURATION\_HOURS**

Spécifie la période de validité pour l'accès temporaire de débogage aux données anonymisées.

Valeur par défaut : 336 heures

**DEFAULT\_SSO\_PERMISSIONS\_FOR\_COMPANY\_ADMINS**

Détermine si les administrateurs d'entreprise peuvent configurer leur propre SSO par défaut.

Valeur par défaut : False

**IS\_SSO\_ON**

Active ou désactive le Single Sign-On (SSO) au niveau de l'instance.

Valeur par défaut : False

**SCIM\_INSTANCE\_ACTIVATION**

Active ou désactive la fonctionnalité System for Cross-domain Identity Management (SCIM).

Valeur par défaut : False

**SESSION\_IDLE\_TIMEOUT**

Définit la durée d'inactivité (en secondes) avant la déconnexion automatique.

Valeur par défaut : 1440 secondes

## Chat

**DOCANALYSIS\_V2\_BATCH\_SIZE**

Définit combien de documents sont traités par lot pour DocAnalysis.

Valeur par défaut : 5

**DOCANALYSIS\_V2\_STRATEGY**

Définit la stratégie de traitement pour l'analyse de documents (vitesse vs. précision).

Valeur par défaut : large Avant la version Sunny Seal : small

**DOCANALYSIS\_V2\_VERBOSE\_IN\_TOOL\_CALL\_ADMIN**

Active la journalisation détaillée pour DocAnalysis dans le tableau de bord administrateur.

Valeur par défaut : False

**DOCANALYSIS\_V2\_VISUAL\_ON**

Active ou désactive les complétions Visual Language Model (VLM) dans DocAnalysis.

Valeur par défaut : False

**IS\_CHAT\_RESPONSE\_SHARING\_ON**

Active ou désactive la fonctionnalité de partage des réponses de chat au niveau de l'instance. Lorsqu'elle est activée, les utilisateurs peuvent partager les réponses générées par l'IA via des icônes de partage affichées dans l'interface de chat. Cette fonctionnalité est utile pour la collaboration, le partage de connaissances et la mise en évidence d'insights précieux au sein des organisations.

Valeur par défaut : True

🧭 Note : L'activation de cette clé de configuration rend la fonctionnalité de partage de réponses disponible au niveau de l'instance. Une fois activée, vous devez naviguer vers les paramètres de chat de votre choix pour activer le partage de réponses pour une entreprise spécifique.

⚠️ Considération de confidentialité : Les réponses partagées peuvent contenir des informations sensibles. Assurez-vous que votre organisation dispose de politiques appropriées concernant le contenu pouvant être partagé en externe ou au sein des équipes.

**IS\_EPHEMERAL\_MODE\_ON**

Active ou désactive la fonctionnalité de mode éphémère globalement. Le mode éphémère permet aux utilisateurs de créer des sessions de chat privées qui ne sont pas enregistrées dans l'historique des conversations et sont automatiquement supprimées 10 minutes après leur création, garantissant la confidentialité et la vie privée pour les cas d'usage sensibles au sein des organisations.

Valeur par défaut : True

🧭 Note : L'activation de cette clé de configuration rend le mode éphémère disponible au niveau de l'instance. Une fois activé, vous devez naviguer vers les paramètres de chat de votre choix pour activer le mode éphémère pour une entreprise spécifique.

**IS\_KG\_DOCUMENT\_TAGGING\_ON**

Active ou désactive le marquage automatique du Knowledge Graph lors de l'ingestion de documents.

Valeur par défaut : False

**IS\_KG\_QUERY\_SUGGESTION\_ON**

Active les suggestions de requêtes basées sur le Knowledge Graph.

Valeur par défaut : False

**IS\_KG\_TOOL\_ROUTING\_ON**

Active le routage d'outils basé sur des mots-clés pour améliorer l'efficacité de l'utilisation des outils.

Valeur par défaut : False

**IS\_MODELS\_CHOICE\_ON**

Permet aux utilisateurs de sélectionner différents modèles pour le traitement.

Valeur par défaut : No

**KG\_SUMMARY\_LANGUAGES**

Spécifie les langues disponibles pour les résumés du Knowledge Graph.

Valeur par défaut : en

## Data

**LOG\_RETENTION\_PERIOD\_DAYS**

Détermine le nombre de jours pendant lesquels les données de log système sont conservées avant d'être automatiquement anonymisées pour se conformer aux politiques de conservation et de confidentialité des données. Cela garantit que les logs d'activité utilisateur et les événements système sont gérés conformément aux réglementations de protection des données telles que le RGPD.

Valeur par défaut : 180 jours

🧭 Note : Après la période de conservation spécifiée, les logs sont anonymisés plutôt que supprimés, permettant la surveillance continue du système et le dépannage tout en protégeant la vie privée des utilisateurs. Les organisations ayant des exigences de conformité spécifiques peuvent avoir besoin d'ajuster cette valeur en fonction de leurs obligations réglementaires.

## Datasources

**DATASOURCES\_DOWNLOAD\_LIMIT**

Nombre maximum de sources de données importées en parallèle.

Valeur par défaut : 10 documents

**DATASOURCES\_MAX\_DOC\_PER\_IMPORT**

Nombre maximum de documents importés en un seul lot.

Valeur par défaut : 500

**DATASOURCES\_MAX\_DOCS\_PER\_PAGE**

Nombre maximum de fichiers téléchargés par page lors du scraping.

Valeur par défaut : 100

**DATASOURCES\_MAX\_PAGES\_PER\_SCRAPE**

Nombre maximum de pages explorées en une session de scraping.

Valeur par défaut : 750

**DATASOURCES\_MAX\_RETRIES**

Nombre maximum de tentatives pour les importations échouées.

Valeur par défaut : 5

**DATASOURCES\_SUCCESS\_RATE\_THRESHOLD**

Définit le seuil pour considérer une importation comme réussie.

Valeur par défaut : 0.5

**DATASOURCES\_UPLOAD\_SESSION\_LIMIT**

Nombre maximum de sources de données téléchargées en parallèle.

Valeur par défaut : 10

## Documents

**AUDIO\_INGESTION\_URL**

URL du service d'ingestion audio.

**IS\_DOC2QUERY\_ON**

Active ou désactive la fonctionnalité doc2query pour l'expansion de requêtes.

Valeur par défaut : False

**IS\_OFFLINE\_INGESTION\_ON**

Active l'ingestion et le système de tâches hors ligne, nécessaires pour l'analyse visuelle des documents et le traitement de longue durée pendant l'ingestion.

🧭 **Note** : Cela active deux actions supplémentaires pour les administrateurs de type Instance DPOs et Company DPOs dans la page Documents de l'administration :

* Exécuter le pipeline de texte : sur les documents **dont le statut n'est pas "embedded"** : relance le parsing et l'embedding avec les configurations par défaut actuelle
* Exécuter le pipeline de vision : sur les documents \*\*dont le statut vision n'est pas "embedded"\*\* : relance le parsing et l'embedding vision avec les configurations actuelle du pipeline vision

<img src="https://mintcdn.com/lighton/rNvFOJLCB2HP18og/images/config-keys-pipelines.png?fit=max&auto=format&n=rNvFOJLCB2HP18og&q=85&s=ccaed93fa3be4e9f81efa53672f232bd" alt="image.png" title="image.png" style={{ width:"51%" }} width="496" height="278" data-path="images/config-keys-pipelines.png" />

**Valeur par défaut** : True

**IS\_VISUAL\_INGESTION\_ON**

Active le traitement des éléments visuels lors de l'ingestion de documents.

Valeur par défaut : True

**MAX\_DOCS\_LIBRARY\_SIZE**

Nombre maximum de documents stockés dans la bibliothèque.

Valeur par défaut : 1000

**MAX\_DOCUMENT\_SIZE**

Taille maximale autorisée par document.

Valeur par défaut : 100 MB

**STORAGE\_LIMIT\_COMPANY / CUSTOM / PERSONAL / RANGE**

Définit les limites de stockage (en MB ou nombre de documents) par entreprise, utilisateur ou type de données.

Valeurs par défaut :

* Company : 102400 MB
* Custom : 10240 MB
* Personal : 10240 MB
* Range : 1–10000000 documents

**UPLOAD\_SESSION\_MAX\_CONCURRENT\_UPLOADS**

Nombre maximum de téléchargements simultanés par session.

Valeur par défaut : 20

**UPLOAD\_SESSION\_QUEUE\_COOLDOWN\_PERIOD**

Temps de refroidissement (en minutes) entre les vérifications de file d'attente lors des téléchargements.

**UPLOAD\_SESSION\_QUEUE\_MAX\_PARALLEL\_PROCESSING\_DOCS**

Nombre maximum de documents traités simultanément dans une session de téléchargement.

Valeur par défaut : 10

## Pipeline

### **DEFAULT\_PIPELINE**

Spécifie la version par défaut du pipeline d'ingestion de documents.

Valeur par défaut : v2.1.1

### DEFAULT\_PARSER\_MODEL

Modèle de vision par défaut utilisé pour le parsing vision (parser 2.2.x).

Doit être un nom technique valide du modèle vision utilisé pour le parsing, le VLM doit avoir été déclaré avec l'attribut parser défini à true pour être sélectionnable.

\*\*\*\*Valeur par défaut \*\*:\*\* LightOnOCR

<img src="https://mintcdn.com/lighton/rNvFOJLCB2HP18og/images/config-keys-default-parser.png?fit=max&auto=format&n=rNvFOJLCB2HP18og&q=85&s=23b0c59692fdb86c135f50dbc4c6203e" alt="image.png" width="692" height="273" data-path="images/config-keys-default-parser.png" />

### VLM\_SLIDING\_WINDOW\_SIZE

Paramètre de parsing vision seulement : Nombre maximum de pages par document pouvant être envoyées et maintenues actives dans la file d'attente de parsing simultanément (fenêtre glissante).

\*\*\*\*Valeur par défaut \*\*:\*\* 25

### **EMBEDDING\_MODEL\_MIGRATION\_IN\_PROGRESS**

Indique si une migration de modèle d'embeddings est actuellement en cours. Lorsqu'elle est activée, le système migre activement les embeddings de documents vers une nouvelle version de modèle, ce qui peut temporairement affecter les performances de recherche et les capacités de traitement de documents. Pendant la migration, les utilisateurs peuvent continuer à utiliser la plateforme, mais certaines fonctionnalités de RAG et de recherche peuvent connaître des performances réduites.

Valeur par défaut : False

🧭 Note : Ce paramètre est généralement géré par les administrateurs LightOn lors des mises à niveau de la plateforme. Lorsqu'une migration est active, évitez de télécharger de gros volumes de documents ou d'effectuer des opérations de recherche intensives. Les utilisateurs seront notifiés lorsque la migration sera terminée et que les performances complètes seront restaurées.

⚠️ Avertissement : N'activez pas manuellement ce flag sauf sur instruction du support LightOn, car il est automatiquement géré lors des mises à jour de modèles d'embeddings.

## Custom Script

Permet aux administrateurs d'ajouter ou de remplacer des scripts personnalisés dans le contenu HTML de l'instance Paradigm. Par défaut, cette fonctionnalité intègre Product Fruits, une plateforme d'onboarding et d'engagement utilisateur.

**Description**

Par défaut, LightOn inclut Product Fruits, qui :

* Fournit un onboarding interactif pour les nouveaux utilisateurs
* Notifie les utilisateurs des nouvelles versions ou périodes de maintenance
* Offre une aide contextuelle pour guider les utilisateurs lors de leurs premiers pas
* Effectue un suivi d'utilisation anonyme pour améliorer l'expérience utilisateur et les performances de la plateforme

Product Fruits est 100% conforme aux standards de protection des données de l'industrie. Il peut être personnalisé avec l'identité visuelle de votre organisation, et vous aurez accès à un compte administrateur pour gérer les flux d'onboarding et les communications in-app.

💡 Recommandation : Nous recommandons fortement de conserver l'intégration Product Fruits par défaut pour soutenir l'amélioration continue de la plateforme et l'accompagnement des utilisateurs.

Valeur par défaut : Activé (clé d'instance Paradigm)

🧭 Vous pouvez désactiver ou remplacer ce script à tout moment via la page Config Keys si votre organisation utilise un autre outil d'onboarding ou d'analytics.
