Coding Tools & @Files

Pia kann Textdateien für dich lesen, durchsuchen und bearbeiten — aber nur in einem Ordner, den du auswählst. Alles bleibt auf diesen Ordner beschränkt, sodass Pia keine Dateien anderswo auf deinem Computer anfassen kann.

Einen Ordner wählen

Sag Pia zuerst, in welchem Ordner es arbeiten darf.

Öffne Einstellungen → Assistent → Allgemein
Suche den Eintrag Assistenten-Dateiordner
Klicke auf Durchsuchen… und wähle einen Ordner

Das war’s — Pia kann nun mit den Dateien in diesem Ordner arbeiten. Dort liegt auch dein Speicher-Tresor.

Darunter liegen zwei Schalter:

Dem Assistenten erlauben, Dateien in diesem Ordner zu lesen und zu schreiben — der Hauptschalter für die Datei-Tools. Schalte ihn aus (oder lass den Ordner leer), und Pia hat überhaupt keinen Dateizugriff.
Dem Assistenten erlauben, Git-Befehle in diesem Ordner auszuführen — siehe Git-Befehle weiter unten. Er ist ausgegraut mit Git ist nicht installiert, wenn kein Git auf deinem Rechner installiert ist.

Wo neue Chats starten

Standard-Arbeitsverzeichnis für neue Chats zeigt auf einen Unterordner deines Dateiordners — ab Werk Playground. Jeder neue Chat startet dort und nicht im obersten Ordner — das hält beiläufige Arbeit von allem fern, was wichtig ist.

Wähle einen vorhandenen Ordner oder gib einen neuen Namen ein, und Pia legt ihn für dich an. Lass das Feld leer, um neue Chats im obersten Ordner des Dateiordners zu starten.

Einen einzelnen Chat eingrenzen

Jeder Chat kann auf einen Unterordner deines Hauptordners beschränkt werden — das hält die Dinge übersichtlich.

Klicke im Assistenten oben auf den Chat-Titel
Ein Flyout mit einer Ordnerauswahl öffnet sich
Navigiere in einen Unterordner, um diesen Chat darauf zu beschränken
Brauchst du einen, der noch nicht existiert? Klicke direkt in der Auswahl auf Neuer Ordner und gib einen Namen ein — das Anlegen eines Ordners führt dich direkt hinein
Klicke auf das Haus-Symbol, um zum obersten Ordner zurückzukehren

Die beiden Ordnerauswahlen bedeuten unterschiedliche Dinge, und beim Draufzeigen sagt jede, welches:

Im Chat-Titel — „Arbeitsordner für den nächsten neuen Chat“ Sie legt immer fest, worin der nächste Chat startet, nie den, in dem du gerade bist.
Im Leerzustand, unter Starte eine Unterhaltung mit Pia — „Arbeitsordner für diesen Chat“ Klicke auf den dort angezeigten Ordner, um ihn vor dem Senden zu ändern. Ist die erste Nachricht einmal gesendet, behält ein Chat den Ordner, den er hat.

Dateien mit @Files referenzieren

Du kannst Pia direkt auf eine Datei verweisen, statt zu beschreiben, wo sie liegt.

Gib im Nachrichtenfeld @Files gefolgt von einem Dateinamen ein
Eine Autovervollständigung zeigt passende Dateien aus dem Chat-Ordner
Wähle eine aus, um ihren Pfad in deine Nachricht zu übernehmen

Das bewirkt zweierlei: Pia kennt den exakten Pfad und liest die Datei direkt, ohne zu suchen — und für diese Antwort stehen nur die Datei-Tools zur Verfügung. Praktisch, um Fragen zu einem Dokument zu stellen oder Pia zu bitten, einen Teil davon umzuschreiben. Weitere Bereiche findest du unter @-Befehle.

Was Pia mit deinen Dateien tun kann

Tool	Was es tut
`list_files`	Listet den Inhalt eines Ordners auf.
`find_files`	Findet Dateien nach Name oder Muster — „jede Tabelle unter reports“ trifft direkt, statt Ordner für Ordner aufzulisten.
`search_files`	Durchsucht den Inhalt von Dateien.
`read_file`	Liest eine Datei.
`edit_file`	Ändert einen Teil einer Datei.
`write_file`	Schreibt eine ganze Datei.
`delete_file`	Löscht eine Datei.

Lesen, Durchsuchen und Auflisten brauchen keine Zustimmung. Schreiben, Ändern und Löschen fragen immer nach.

Pia bekommt gesagt, in welchem Ordner es arbeitet, sodass es nicht mehr bei relativen Pfaden rät, und ein falsch geschriebener Name schlägt die naheliegende, ähnlich benannte Datei vor.

Eine Datei zu bearbeiten schreibt sie nicht neu

Wenn Pia eine Datei ändert, sendet es nur das Stück, das sich ändert, sodass eine Korrektur um ein einziges Wort nicht den Rest eines langen Dokuments auf dem Weg verstümmeln kann. Du siehst und genehmigst weiterhin denselben Diff.

Word-Dokumente und Excel-Arbeitsmappen werden direkt an Ort und Stelle bearbeitet. Nur die Absätze oder Zellen, die sich ändern, werden angefasst; alles andere in der Datei bleibt genau, wie es war — einschließlich Formatierung, die Pia nie gesehen hat.

Innerhalb von Dokumenten suchen

Die Inhaltssuche eines Ordners deckt Word-Dokumente, Excel-Arbeitsmappen und gespeicherte Outlook-Mail ab, nicht nur reinen Text. Eine Datei, die Pia wirklich nicht lesen kann, wird im Ergebnis namentlich genannt, sodass ein nicht durchsuchbares Dokument nicht wie eine fehlende Antwort aussieht.

Gespeicherte Mail ist nur lesbar: Pia schreibt keine .msg- oder .eml-Datei. Text in eine Bilddatei zu schreiben wird verweigert, statt sie zu beschädigen.

Die Suche ignoriert standardmäßig Groß-/Kleinschreibung, sodass eine Suche nach „cookie“ auch „Cookies“ findet und umgekehrt. Pia lässt sich auch bitten, Großbuchstaben exakt zu berücksichtigen — für die Fälle, in denen du die Markierung TODO suchst und nicht jede Erwähnung des Wortes.

Bilder in deinem Dateiordner

read_file zeigt Pia das Bild, wenn die Datei ein Bild ist, statt es abzulehnen — so kannst du nach einem Screenshot beim Namen fragen, ohne ihn anzuhängen. Pia sieht das Bild für eine Antwort lang, also frag im selben Zug, was du dazu wissen willst. Ein Bild anzusehen braucht den Anbieter Pia Cloud, wie jeder andere Bildanhang.

search_files zählt Bilder gesondert, statt jedes PNG im Baum als Datei aufzuführen, die es nicht lesen konnte.

Änderungen prüfen, bevor sie passieren

Wenn Pia eine Datei ändern will, legt es nicht einfach los. Stattdessen erscheint eine Aktionskarte mit:

dem Dateipfad
einem farbcodierten Diff — grün für hinzugefügte Zeilen, rot für entfernte Zeilen

Du wählst dann Ablehnen, Einmal zulassen, Diese Sitzung zulassen oder Immer zulassen. Wozu dich jede dieser Optionen verpflichtet, steht unter Tool-Berechtigungen.

Ändert sich eine Datei auf der Festplatte, nachdem Pia die Vorschau erstellt hat, aber bevor du zustimmst, wird die Änderung sicherheitshalber blockiert. Bitte Pia dann, die Datei erneut zu lesen, und versuche es noch einmal.

Git-Befehle

Wenn dein Ordner ein Git-Repository ist, kann Pia direkt damit arbeiten. Schalte dazu Dem Assistenten erlauben, Git-Befehle in diesem Ordner auszuführen in Einstellungen → Assistent → Allgemein ein.

Nur lesend — keine Zustimmung nötig	Verändert etwas — fragt immer nach
`git_status`, `git_log`, `git_diff`, `git_branch`, `git_show`	`git_init`, `git_add`, `git_commit`, `git_switch`, `git_restore`, `git_stash`

Die Aktionskarte zeigt den genauen Befehl, bevor irgendetwas ausgeführt wird. Ein paar Dinge tut Pia bewusst nicht:

Nichts geht über das Netzwerk. Es gibt kein Push, Pull, Fetch oder Clone. Veröffentlichen bleibt dir überlassen.
Alles bleibt innerhalb deines Ordners. Pia kann kein Repository außerhalb davon erreichen.
Der Branch-Wechsel läuft über git switch, sodass er nicht wie ein versehentliches Checkout heimlich Änderungen verwirft.

Tool-Berechtigungen

Lesen, Durchsuchen und Auflisten von Dateien sind ungefährlich und brauchen daher keine Zustimmung. Dauerhafte Freigaben, die du erteilt hast, verwaltest du so:

Öffne Einstellungen → Assistent → Tool-Zugriff
Sieh dir die Abschnitte Erlaubt, bis Pia geschlossen wird und Immer erlaubte Tools an
Klicke bei allem, wonach du wieder gefragt werden möchtest, auf Vergessen oder Widerrufen

Die vollständige Anleitung steht unter Tool-Berechtigungen.

Gut zu wissen

Die Datei-Tools arbeiten mit Text — reinem Text, Word, Excel und gespeicherter Mail. Ein Bild wird Pia als Bild gezeigt statt als Text gelesen; andere Binärdateien werden übersprungen.
Sehr große Dateien werden eventuell übersprungen oder gekürzt.
Die Inhalte deiner Dateien bleiben auf deinem Computer. Sie werden nirgendwo hochgeladen, es sei denn, du bittest Pia darum. Wie Pia mit deinen Daten umgeht, steht in der Datenschutz-Anleitung.
Ein Agentenlauf bearbeitet diesen Ordner während der Arbeit nicht — er verwendet eine eigene Kopie (oder einen eigenen Git-Branch) und überträgt das Ergebnis zurück, sobald er fertig ist.

Nächste Schritte

Tool-Berechtigungen — was ohne Nachfrage abläuft
Assistent-Chats & Verlauf — mit Pia chatten