Configuration

Pia stocke sa configuration dans %APPDATA%\Pia\settings.json. Les noms de propriétés sont en camelCase, et les valeurs d’énumération sont écrites telles quelles ("Dark", "Parakeet").

Pour déployer des paramètres sur des appareils gérés, utilise plutôt la Politique d’entreprise — elle utilise les mêmes noms de propriétés.

Apparence et langue

Paramètre	Type	Par défaut	Description
`theme`	`"System"` \| `"Dark"` \| `"Light"`	`"System"`	Thème de l’interface
`uiLanguage`	`"EN"` \| `"DE"` \| `"FR"`	`"EN"`	Langue de l’interface
`targetLanguage`	`"EN"` \| `"DE"` \| `"FR"`	non défini	Langue de sortie par défaut pour Optimize
`targetSpeechLanguage`	`"Auto"` \| `"EN"` \| `"DE"` \| `"FR"`	`"Auto"`	Langue de la reconnaissance vocale

Démarrage et fenêtres

Paramètre	Type	Par défaut	Description
`launchAtStartup`	bool	`true`	Démarrer Pia automatiquement lors de la connexion à Windows
`startMinimized`	bool	`false`	Démarrer masqué dans la barre des tâches
`autoCaptureSelectedText`	bool	`true`	Coller automatiquement le texte sélectionné quand un raccourci déclenche Pia
`defaultWindowMode`	`"Optimize"` \| `"Assistant"`	`"Optimize"`	Mode utilisé par le bouton Nouvelle fenêtre
`autoUpdateEnabled`	bool	`true`	Autoriser la mise à jour automatique au démarrage

Optimize

Paramètre	Type	Par défaut	Description
`defaultOutputAction`	`"CopyToClipboard"` \| `"AutoType"` \| `"PasteToPreviousWindow"`	`"CopyToClipboard"`	Ce qui se passe après Optimize
`autoTypeDelayMs`	integer	`10`	Délai AutoType en millisecondes
`defaultTemplateId`	GUID	non défini	Modèle d’optimisation par défaut

Parole

Paramètre	Type	Par défaut	Description
`sttBackend`	`"Parakeet"` \| `"Whisper"`	`"Parakeet"`	Moteur de reconnaissance vocale
`whisperModel`	`"Tiny"` \| `"Base"` \| `"Small"` \| `"Medium"` \| `"Large"`	`"Base"`	Taille du modèle Whisper (ignoré par Parakeet)
`ttsEnabled`	bool	`false`	Activer la synthèse vocale
`ttsVoiceModelKey`	string	`"en_US-lessac-medium"`	Identifiant de la voix TTS

Fournisseurs et personas

Paramètre	Type	Par défaut	Description
`defaultProviderId`	GUID	non défini	Fournisseur utilisé quand aucun défaut par mode ne s’applique
`useSameProviderForAllModes`	bool	`true`	Utiliser un seul fournisseur d’IA pour Optimize/Assistant
`modeProviderDefaults`	object	`{}`	Mappage du mode de conversation vers le GUID du fournisseur d’IA
`modePersonaDefaults`	object	`{}`	Mappage du mode de conversation vers le GUID de la persona

Assistant et fichiers

Paramètre	Type	Par défaut	Description
`assistantFilesFolder`	string	non défini	Le seul dossier auquel l’assistant peut accéder. Vide ⇒ aucun accès aux fichiers
`assistantDefaultWorkingDirectory`	string	`"Playground"`	Sous-dossier où démarrent les nouvelles discussions. Vide ⇒ la racine du dossier
`assistantFileToolsEnabled`	bool	`true`	Autoriser la lecture et l’écriture de fichiers dans ce dossier
`assistantGitToolsEnabled`	bool	`true`	Autoriser les commandes git dans ce dossier
`assistantSuggestionsEnabled`	bool	`false`	Afficher des invites suggérées sur une discussion vide
`assistantAgentModeDefault`	bool	`false`	Démarrer les nouvelles discussions avec le levier sur Agent (pas d’interface)
`alwaysAllowedTools`	array	`[]`	Permissions des outils permanentes. Gérées depuis la page des paramètres

Historique des chats

Paramètre	Type	Par défaut	Description
`chatHistoryRetentionDays`	integer	`180`	Supprimer les chats non ouverts depuis ce nombre de jours (1 à 730). Un chat favori en est exempté
`chatAutoTitleEnabled`	bool	`false`	Générer un titre court par chat (coûte un appel supplémentaire)

Exécutions d’agent

Consulte le guide Exécutions d’agent pour savoir ce que signifie chaque limite.

Paramètre	Type	Par défaut	Description
`agentMaxSteps`	integer	`24`	Nombre maximal d’étapes dans une exécution interactive
`maxToolRoundsPerStep`	integer	`24`	Nombre maximal de tours d’outils au sein d’une étape
`agentWallClockMinutes`	integer	`20`	Limite de temps pour une exécution interactive
`agentMaxReplans`	integer	`2`	Replanifications autorisées après l’échec d’une étape
`agentPlanReasoningTurnEnabled`	bool	`false`	Ajouter un tour de réflexion sans outils avant la planification
`agentRunAutoApproveBuiltInWrites`	bool	`false`	Ignorer l’approbation des outils d’écriture propres à Pia dans les exécutions d’agent et le mode vocal
`agentPersonaRoster`	object	`{}`	Mode de fonctionnement → GUID des personas que le planificateur peut affecter aux étapes
`scheduledMaxSteps`	integer	`24`	Nombre maximal d’étapes dans une exécution en arrière-plan ou planifiée
`scheduledWallClockMinutes`	integer	`45`	Limite de temps pour une exécution en arrière-plan ou planifiée
`scheduledMaxReplans`	integer	`2`	Replanifications autorisées dans une exécution en arrière-plan ou planifiée
`maxParallelBackgroundRuns`	integer	`2`	Exécutions en arrière-plan simultanées ; les suivantes patientent en file d’attente
`maxParallelRequestsPerProvider`	integer	`4`	Requêtes simultanées que Pia enverra à un même fournisseur (pas d’interface)

Réunions et transcription

Paramètre	Type	Par défaut	Description
`meetingAttendeeDisplayName`	string	non défini	Nom affiché aux autres participants. Vide ⇒ « l’assistant de ‹ton nom› »
`meetingTranscriptFolder`	string	non défini	Dossier dans lequel s’ouvre la boîte de dialogue Enregistrer…
`meetingBrowserSelection`	`"BundledChromium"` \| `"SystemChrome"` \| `"SystemEdge"` \| `"SystemDefault"`	`"BundledChromium"`	Quel navigateur Pia pilote
`meetingAttendeeShowBrowserWindow`	bool	`false`	Afficher la fenêtre du navigateur au lieu de rejoindre masqué
`enableMeetingDiarization`	bool	`true`	Répartir la transcription par intervenant
`meetingSmartSpeakerDetection`	bool	`true`	Laisser Pia ajuster et corriger lui-même l’attribution des intervenants
`speakerEmbeddingThreshold`	float	`0.50`	Sensibilité de correspondance vocale (détection intelligente désactivée)
`meetingMaxSpeakers`	integer	`0`	Limite du nombre d’intervenants distincts. `0` ⇒ aucune limite
`meetingMinSpeechSeconds`	float	`1.5`	Durée de parole nécessaire avant qu’un intervenant soit identifié
`meetingAttendeeRosterSnapshotMinutes`	integer	`2`	Fréquence de relecture de la liste des participants (pas d’interface)

Mémoire et confidentialité

Paramètre	Type	Par défaut	Description
`autoIngestSources`	bool	`true`	Compiler les documents déposés dans le dossier `sources` du coffre
`privacy.tokenizationEnabled`	bool	`true`	Remplacer les données personnelles par des tokens avant d’envoyer le texte à l’IA
`privacy.piiKeywords`	array	`[]`	Tes propres mots-clés PII

Synchronisation et serveur

Paramètre	Type	Par défaut	Description
`syncEnabled`	bool	`false`	Activer la synchronisation Pia Cloud
`serverUrl`	string	non défini	URL du serveur, pour l’auto-hébergement
`trustSelfSignedCertificates`	bool	`false`	Accepter les certificats TLS auto-signés

Clés que Pia gère lui-même

settings.json conserve aussi un état qui n’est pas une préférence : jetons de connexion, matériel de clé de chiffrement et identifiants d’appareil, horodatages de synchronisation et ETags, position et taille de la fenêtre, brouillons non envoyés, largeurs de colonnes et marqueurs de version de schéma. Laisse-les tranquilles — les modifier peut te déconnecter ou, dans le cas des clés de chiffrement, te couper de tes propres données.