Die App nutzen

Agenten

Ein Agent ist ein gespeicherter Assistent mit eigenen Anweisungen, Zugriffen und Integrationen. Du wählst ihn im Chat über die Auswahl Agent: Ab dann arbeitet der Chat so, wie du es festgelegt hast, mit den Ordnern, der E-Mail und den Berechtigungen dieses Agenten.

GalerieErstellen und bearbeitenMit einem Agenten arbeitenWerkzeugeBestätigungenProtokollFreigegebene OrdnerIntegrationen

Die Seite Agenten: oben deine Agenten, darunter die Galerie.
Die Seite Agenten: oben deine Agenten, darunter die Galerie.

Vier fertige Agenten. Erstellen fragt nach dem Ordner, in dem sie arbeiten sollen, und der Agent ist sofort bereit.

AgentWas er tut
Datei-AssistentFindet, liest und fasst die Dokumente eines Ordners zusammen und beantwortet Fragen zu ihrem Inhalt.
Dokumente ordnenSchlägt eine Ordnung für einen unaufgeräumten Ordner vor und legt, wenn du zustimmst, die Ordner an und verschiebt die Dateien. Er löscht nichts.
Programmier-AssistentLiest und ändert den Code eines Projekts und kann Builds und Tests ausführen, fragt dich aber immer vorher.
E-Mail-AssistentFindet, liest und fasst deine E-Mails zusammen und schreibt Antworten als Entwürfe. Er sendet nur, wenn du es verlangst, und zeigt dir die Nachricht jedes Mal vorher. Beim Erstellen öffnet sich der Editor, damit du das Konto verknüpfen kannst.

Agent von Grund auf erstellen → öffnet einen leeren Editor.

Einen Agenten erstellen und bearbeiten

Der Editor eines Agenten: Name, Beschreibung, Anweisungen, freigegebene Ordner und Berechtigungen.
Der Editor eines Agenten: Name, Beschreibung, Anweisungen, freigegebene Ordner und Berechtigungen.
FeldWofür es da ist
Name, BeschreibungDaran erkennst du ihn in der Liste.
AnweisungenWas er tun soll und wie. Wenige klare Regeln funktionieren besser als ein langer Text, besonders bei kleinen Modellen.
Freigegebene OrdnerDie einzigen Ordner, die der Agent sieht. Optional. Im ersten beginnt er.
Darf Befehle ausführenSchalte es nur für Agenten ein, die es brauchen, wie den Programmier-Assistenten. Jeder Befehl wird dir vorher gezeigt.
BerechtigungenDie Aktionen, die du diesem Agenten dauerhaft erlaubt hast, jeweils mit Widerrufen.
IntegrationenDie Integrationen, die der Agent nutzen darf, zum Anhaken: siehe Integrationen.
E-MailDie E-Mail-Konten, die der Agent nutzen darf: siehe E-Mail.
  • Speichern übernimmt die Änderungen; Abbrechen verwirft sie.
  • Agent löschen verlangt einen zweiten Klick und löscht auch seine Unterhaltungen (das Aktionsprotokoll bleibt).
  • Jeder Agent ist eine lesbare JSON-Datei: Agenten-Ordner öffnen zeigt sie dir, damit du sie sichern oder weitergeben kannst.

Mit einem Agenten arbeiten

Der Aufräum-Agent hat die Ordner angelegt und bittet um Erlaubnis, das erste Foto zu verschieben.
Der Aufräum-Agent hat die Ordner angelegt und bittet um Erlaubnis, das erste Foto zu verschieben.
  • Im Chat verwenden neben jedem Agenten öffnet einen neuen Chat mit diesem Agenten. Im Chat wählst du ihn auch über die Auswahl Agent oben: Allgemein ist der Chat mit seinen eigenen Zugriffen, die anderen sind deine Agenten.
  • Mit einem gewählten Agenten zeigt und ändert das Feld Zugriff seine Zugriffe, und das Protokoll rechts ist seins. Die automatischen Rollen funktionieren wie immer: Der Chat schaltet Dateien oder E-Mail ein, wenn nötig, mit den Zugriffen des Agenten.
  • Ein Agentenwechsel in einem schon begonnenen Chat öffnet einen neuen Chat: Ein Streifen fragt vorher nach (Neuer Chat mit … oder Abbrechen). So gelangt nicht zu einem anderen Agenten, was einer mit seinen Zugriffen gelesen hat.
  • Unterhaltungen mit einem Agenten stehen im Chatverlauf, mit seinem Namen unter dem Titel. Öffnest du eine wieder, kommt auch der Agent zurück.
  • Beschreibe die Aufgabe in eigenen Worten: Der Chat zeigt die Schritte, die er macht (Sieht sich den Ordner an, Liest, Verschiebt…), und hält bei heiklen Aktionen bei der Bestätigungskarte an: Erlauben, Immer erlauben für diese Art von Aktion oder Nicht erlauben. Nach einem Nein hält er an und wartet, bis du sagst, was er ändern soll.

Was ein Agent kann

WerkzeugWas es tut
Sieht sich den Ordner anListet Dateien und Ordner auf (bis zu 500 Einträge auf einmal).
LiestÖffnet Textdateien, PDFs (Seite für Seite) und Word-Dokumente (.docx). Lange Dateien werden in Teilen gelesen, jeweils etwa ein Viertel des Modellkontexts, und dort fortgesetzt, wo das Lesen aufgehört hat: Ein langes PDF füllt nicht mehr den ganzen Kontext. Ein PDF, das nur aus Bildern besteht, wird als Datei ohne Text gemeldet. Liest auch Excel (.xlsx und alte .xls, ein Blatt nach dem anderen mit nummerierten Zeilen), alte Word-Dokumente (.doc) und PowerPoint (.pptx und alte .ppt, eine Folie nach der anderen mit Titel, Tabellen und Notizen).
Sucht DateienFindet Dateien und Ordner nach Namen (zum Beispiel *.pdf oder rechnung*), Unterordner eingeschlossen, und auf Wunsch nur solche, die einen bestimmten Text enthalten, auch in PDF und Word.
SchreibtLegt eine neue Textdatei an oder ersetzt ihren gesamten Inhalt.
ÄndertÄndert nur ein Stück einer Textdatei und lässt den Rest, wie er war (Zeilenenden und Kodierung eingeschlossen).
Erstellt ein DokumentErstellt ein Word-Dokument (.docx) mit Überschriften, Listen, Tabellen, Farben, Fettdruck, Kopf- und Fußzeile mit Seitenzahl, eine Excel-Datei (.xlsx) mit Blättern, Formeln und Formatierung (Farben, Zahlenformate, Breiten, verbundene Zellen, fixierte Zeilen) oder eine PowerPoint-Präsentation (.pptx) mit Titelfolie, Aufzählungen, Tabellen, Farben und Sprechernotizen. Erstellt auch PDFs, mit derselben Syntax und demselben Layout wie Word.
Bearbeitet ein DokumentErstellt eine Kopie eines Word-Dokuments, einer Excel-Datei oder einer PowerPoint-Präsentation und ändert nur die Inhalte (zu ersetzende Texte, Excel- oder Tabellenzellen, Folientitel und Notizen, Absätze oder Folien am Ende, entfernte Folien): Formatierung, Farben, Formeln, Bilder und Layout bleiben wie im Original. Alte .doc-, .xls- und .ppt-Dateien werden zu .docx, .xlsx und .pptx. Die Kopie eines Word-Dokuments kann auch als PDF gespeichert werden; ein PDF lässt sich dagegen nicht unter Beibehaltung des Layouts ändern: Es wird gelesen und ein neues erstellt.
Legt einen Ordner anEinschließlich fehlender Ordner dazwischen.
VerschiebtVerschiebt oder benennt eine Datei oder einen Ordner um.
LöschtLöscht eine Datei oder einen leeren Ordner. Die Datei verschwindet nicht: Sie wird beiseitegelegt und lässt sich wiederherstellen.
Führt einen Befehl ausNur wenn der Agent Befehle ausführen darf. Die Befehlszeile des Systems, höchstens 2 Minuten, nicht interaktiv: Befehle, die auf eine Eingabe warten, brechen von selbst ab.
E-Mail-WerkzeugeWenn der Agent verknüpfte Konten hat: suchen, lesen, Anhänge speichern, Entwürfe schreiben, senden. Siehe E-Mail.
Werkzeuge der IntegrationenDie der für den Agenten angehakten Integrationen, wenn die Anfrage sie betrifft. Siehe Integrationen.

Was nach Bestätigung fragt

AktionBestätigungRückgängig möglich
Ansehen, lesen, suchenNein—
Einen Anhang außerhalb der freigegebenen Ordner lesenJa: nur diese Datei oder den ganzen Ordner—
Eine Datei oder einen Ordner anlegenNeinJa
Eine Datei ersetzen oder ändernJaJa (die vorherige Version wird wiederhergestellt)
Verschieben oder umbenennenJaJa
LöschenJaJa
Einen Befehl ausführenJa, mit Anzeige des BefehlsNein
Ein Werkzeug einer Integration verwendenJa, mit Anzeige der Daten, die es erhältNein
Einen E-Mail-Entwurf speichernNeinNein (du löschst ihn in deinem E-Mail-Programm)
Eine E-Mail sendenImmer, mit der ganzen Nachricht zum Prüfen und KorrigierenNein

Immer erlauben gilt für eine Art von Aktion und für diesen Agenten (bei Werkzeugen von Integrationen für das einzelne Werkzeug); du widerrufst es im Editor. Beim Senden von E-Mails gibt es das nicht: Es wird jedes Mal gefragt.

Protokoll und Rückgängigmachen

Das Protokoll des Agenten: angelegte Ordner und verschobene Fotos, jeweils mit Rückgängig.
Das Protokoll des Agenten: angelegte Ordner und verschobene Fotos, jeweils mit Rückgängig.

Die Leiste rechts listet alles auf, was der Agent gelesen, geschrieben oder ausgeführt hat, auch abgelehnte oder fehlgeschlagene Versuche. Rückgängig stellt den vorherigen Zustand wieder her: Es löscht eine angelegte Datei, stellt den vorherigen Inhalt wieder her, bringt eine verschobene oder gelöschte Datei an ihren Platz zurück.

Vorsichtiges Rückgängigmachen

Wurde die Datei nach der Aktion noch einmal geändert (von dir oder von einem anderen Programm), bricht das Rückgängigmachen ab und sagt dir Bescheid: Lieber nichts rückgängig machen als spätere Arbeit löschen.

Freigegebene Ordner

Jeder Pfad, den das Modell anfragt, wird geprüft: Er muss innerhalb eines freigegebenen Ordners bleiben. Für den Agenten existiert der Rest der Festplatte nicht. Die Prüfung hält auch Tricks stand: Pfade mit .., Verknüpfungen und Junctions, die nach außen führen, versteckte Datenströme und spezielle Windows-Pfade werden abgelehnt, und der Versuch landet im Protokoll. Einen freigegebenen Ordner selbst kann der Agent weder verschieben noch löschen.

Integrationen

MCP-Server heißen jetzt Integrationen und werden nicht mehr im Agenten hinzugefügt. Du richtest sie einmal auf der Seite Integrationen ein und hakst dann im Editor des Agenten, Abschnitt Integrationen, die an, die der Agent nutzen darf. Server, die du einem Agenten hinzugefügt hattest, sind automatisch zu Integrationen geworden, schon angehakt in diesem Agenten.

Modelle und Agenten

Kleinere Modelle nutzen Werkzeuge weniger zuverlässig. Für Agenten ist ein Modell mit der Markierung Für Agenten geeignet auf der Seite Modelle die bessere Wahl.

HotMoE ist ein Projekt von Virsion. Dieses Handbuch beschreibt die App so, wie sie heute ist: Was noch kommt, ist als solches gekennzeichnet.