Coding Tools & @Files

Pia peut lire, chercher et modifier des fichiers texte pour toi — mais seulement dans un dossier que tu choisis. Tout reste limité à ce dossier, donc Pia ne peut pas toucher les fichiers ailleurs sur ton ordinateur.

Choisir un dossier

D’abord, dis à Pia dans quel dossier il est autorisé à travailler.

Ouvre Paramètres → Assistant → Général
Trouve Dossier de fichiers de l’assistant
Clique sur Parcourir… et choisis un dossier

C’est fait — Pia peut maintenant travailler avec des fichiers dans ce dossier. C’est aussi là que se trouve ton coffre de Mémoire.

Deux commutateurs se trouvent en dessous :

Autoriser l’assistant à lire et écrire des fichiers dans ce dossier — le commutateur principal des outils de fichiers. Désactive-le (ou laisse le dossier vide) et Pia n’a plus aucun accès aux fichiers.
Autoriser l’assistant à exécuter des commandes git dans ce dossier — voir Commandes Git plus bas. Il est grisé, avec la mention Git is not installed, si Git n’est pas installé sur ta machine.

Où démarrent les nouveaux chats

Répertoire de travail par défaut pour les nouvelles discussions pointe vers un sous-dossier de ton dossier de fichiers — Playground par défaut. Chaque nouveau chat démarre là plutôt qu’au niveau supérieur, ce qui tient le travail informel à l’écart de ce qui compte vraiment.

Choisis un dossier existant ou tape un nouveau nom, et Pia le crée pour toi. Laisse le champ vide pour démarrer les nouveaux chats à la racine du dossier de fichiers.

Limiter un chat

Chaque chat peut travailler dans un sous-dossier de ton dossier principal, ce qui garde les choses ciblées.

Dans l’Assistant, clique sur le chip du titre du chat en haut
Un flyout s’ouvre avec un sélecteur de dossier
Descends dans un sous-dossier pour limiter ce chat à celui-ci
Besoin d’un dossier qui n’existe pas encore ? Clique sur Nouveau dossier et tape un nom, directement dans le sélecteur — créer un dossier t’y fait entrer
Clique sur l’icône d’accueil pour revenir au dossier principal

Les deux sélecteurs de dossier signifient des choses différentes, et chacun le précise au survol :

Dans le chip du titre du chat — “Dossier de travail pour le prochain nouveau chat” Il définit toujours ce sur quoi démarre le prochain chat, jamais celui dans lequel tu es.
Sur l’état vide, sous Start a conversation with Pia — “Dossier de travail pour ce chat” Clique sur le dossier affiché là pour le changer avant d’envoyer. Une fois le premier message envoyé, un chat garde le dossier qu’il a.

Référencer les fichiers avec @Files

Tu peux pointer Pia vers un fichier précis, au lieu de décrire où il se trouve.

Dans la zone de message, tape @Files suivi d’un nom de fichier
Une liste d’autocomplétion affiche les fichiers correspondants dans le dossier du chat
Choisis-en un pour insérer son chemin dans ton message

Le tag fait deux choses : Pia obtient le chemin exact et lit le fichier directement, sans chercher, et le tour est restreint aux seuls outils de fichiers. Pratique pour poser des questions sur un document ou demander à Pia d’en réécrire une partie. Voir les commandes @ pour les autres domaines.

Ce que Pia peut faire avec tes fichiers

Outil	Ce qu’il fait
`list_files`	Liste le contenu d’un dossier.
`find_files`	Trouve des fichiers par nom ou par motif — “tous les tableurs sous reports” trouve directement au lieu de lister dossier par dossier.
`search_files`	Recherche dans le contenu des fichiers.
`read_file`	Lit un fichier.
`edit_file`	Modifie une partie d’un fichier.
`write_file`	Écrit un fichier entier.
`delete_file`	Supprime un fichier.

Lire, chercher et lister ne nécessitent aucune approbation. Écrire, modifier et supprimer demandent toujours.

Pia sait dans quel dossier il travaille, donc il arrête de deviner des chemins relatifs, et un nom mal orthographié suggère le fichier le plus proche à côté.

Modifier un fichier ne le réécrit pas

Quand Pia change un fichier, il n’envoie que le morceau qui change, si bien qu’une correction d’un seul mot ne peut pas abîmer le reste d’un long document au passage. Tu vois et approuves toujours le même diff.

Les documents Word et les classeurs Excel sont modifiés sur place. Seuls les paragraphes ou les cellules qui changent sont touchés ; tout le reste du fichier est laissé exactement tel quel, y compris une mise en forme que Pia n’a jamais vue.

Chercher dans les documents

Chercher dans le contenu d’un dossier couvre les documents Word, les classeurs Excel et les e-mails Outlook enregistrés, pas seulement le texte brut. Un fichier que Pia ne peut vraiment pas lire est nommé dans le résultat, donc un document impossible à chercher ne ressemble pas à une absence de réponse.

Les e-mails enregistrés sont en lecture seule : Pia n’écrira jamais par-dessus un .msg ou un .eml. Écrire du texte dans un fichier image est refusé plutôt que de le corrompre.

La recherche ignore la casse par défaut, donc chercher “cookie” trouve aussi “Cookies” et inversement. Tu peux demander à Pia de respecter la casse exactement, pour les fois où tu veux le marqueur TODO plutôt que chaque mention du mot.

Images dans ton dossier de fichiers

read_file montre l’image à Pia quand le fichier en est une, plutôt que de la refuser — tu peux donc poser une question sur une capture d’écran par son nom sans la joindre. Pia voit l’image pour une seule réponse, donc pose ta question à son sujet dans le même message. Regarder une image nécessite le fournisseur Pia Cloud, comme toute autre pièce jointe d’image.

search_files compte les images séparément au lieu de lister chaque PNG de l’arborescence comme un fichier qu’il n’a pas pu lire.

Examiner les changements avant qu’ils ne se produisent

Quand Pia veut changer un fichier, il ne fait pas juste continuer. Une carte d’action apparaît affichant :

Le chemin du fichier
Un diff codé par couleur — vert pour les lignes ajoutées, rouge pour les lignes supprimées

Tu choisis alors Refuser, Autoriser une fois, Autoriser cette session, ou Toujours autoriser. Voir Permissions des outils pour ce à quoi chacune de ces options t’engage.

Si un fichier change sur le disque après que Pia l’ait prévisualisé mais avant que tu approuves, le changement est bloqué pour rester sûr. Demande simplement à Pia de relire le fichier et essaie à nouveau.

Commandes Git

Si ton dossier est un dépôt git, Pia peut travailler avec directement. Active Autoriser l’assistant à exécuter des commandes git dans ce dossier dans Paramètres → Assistant → Général.

Lecture seule — aucune approbation nécessaire	Modifie quelque chose — demande toujours
`git_status`, `git_log`, `git_diff`, `git_branch`, `git_show`	`git_init`, `git_add`, `git_commit`, `git_switch`, `git_restore`, `git_stash`

La carte d’approbation affiche la commande exacte avant que quoi que ce soit ne s’exécute. Il y a quelques choses que Pia refuse délibérément de faire :

Rien ne passe par le réseau. Il n’y a ni push, ni pull, ni fetch, ni clone. Publier reste ton affaire.
Tout reste à l’intérieur de ton dossier. Pia ne peut pas atteindre un dépôt en dehors.
Le changement de branche utilise git switch, donc il ne va pas discrètement écraser des changements comme pourrait le faire un checkout égaré.

Permissions des outils

La lecture, la recherche et l’énumération des fichiers sont sûres, donc elles n’ont pas besoin d’approbation. Pour les permissions permanentes que tu as accordées :

Ouvre Paramètres → Assistant → Accès aux outils
Passe en revue ce qui est autorisé jusqu’à la fermeture de Pia et ce qui est autorisé en permanence
Clique sur Oublier ou Révoquer sur ce que tu veux qu’on te redemande

Le guide complet se trouve dans Permissions des outils.

Bon à savoir

Les outils de fichiers fonctionnent sur du texte — texte brut, Word, Excel et e-mails enregistrés. Une image est montrée à Pia comme une image plutôt que lue comme du texte ; les autres fichiers binaires sont ignorés.
Les fichiers très volumineux peuvent être ignorés ou tronqués.
Le contenu de tes fichiers reste sur ton ordinateur. Il n’est envoyé nulle part à moins que tu demandes à Pia de le faire. Voir le guide Confidentialité pour plus d’informations sur la façon dont Pia gère tes données.
Une exécution d’agent ne modifie pas ce dossier pendant qu’elle travaille — elle utilise sa propre copie (ou sa propre branche git) et rapatrie le résultat une fois terminée.

Prochaines étapes

Permissions des outils — ce qui s’exécute sans confirmation
Chats de l’Assistant & Historique — discuter avec Pia