# Assistent

{/* AUTO-SYNCED SOURCE: this page lives in apps/app/src/modules/agent/docs/ and is mirrored into the docs app by `bun sync:module-docs`. Edit it in the module, not in apps/docs. */}

<Lead>
Der **Assistent** ist die KI deines Workspace: Er beantwortet Fragen, schreibt Texte und erledigt Aufgaben mit deinen Daten. Du findest ihn im Vollbild unter `/agent` und als schwebenden Orb auf jeder Seite der Plattform. Er ist als Standard-Tool in jedem Plan enthalten und muss nicht installiert werden.
</Lead>

## Wo du den Assistenten findest

Der Assistent ist bewusst kein einzelner Bildschirm, sondern überall dabei:

<DefinitionList>
  <DefItem term="Vollbild unter /agent">Die große Arbeitsfläche mit Seitenleiste, Chats, Projekten, Archiv und Wissensspeicher. Details: [Chat und Projekte](/tools/agent/chat-und-projekte).</DefItem>
  <DefItem term="Schwebender Orb">Das Windrose-Symbol auf jeder Seite. Ein Klick öffnet ein Chat-Panel direkt dort, wo du gerade arbeitest, ohne die Seite zu verlassen. Details: [Mini-Assistent](/tools/agent/mini-assistent).</DefItem>
  <DefItem term="Tastenkürzel">Mit <Kbd>Cmd</Kbd>+<Kbd>K</Kbd> (Mac) bzw. <Kbd>Ctrl</Kbd>+<Kbd>K</Kbd> (Windows) öffnest du den Mini-Assistenten von überall. <Kbd>Esc</Kbd> schließt ihn wieder.</DefItem>
  <DefItem term="Dazu fragen">Markierst du Text auf einer Seite, erscheint der Chip **Dazu fragen**: Das Zitat wandert in den Chat und du kannst direkt dazu fragen.</DefItem>
  <DefItem term="Dashboard">Die Ask-Bar auf dem Dashboard startet einen neuen Chat, auch mit Anhängen und Erwähnungen. Dazu kommen das Morgen-Briefing **Heute steht an** und proaktive Vorschlags-Karten, sofern eingeschaltet.</DefItem>
</DefinitionList>

## Was der Assistent kann

<FeatureGrid>
  <Feature icon="sparkle" title="Antworten und Texte">
    Fragen beantworten, E-Mails und Exposé-Texte entwerfen, Tabellen und Checklisten bauen. Bei größeren Aufgaben zeigt er einen sichtbaren Schritt-Plan und liefert fertige Werkstück-Karten.
  </Feature>
  <Feature icon="book" title="Kennt deinen Workspace">
    Er sucht in deinen Objekten, Dateien, Aufgaben, Läufen und in onOffice, durchsucht die Hilfe-Doku und das Web und holt Markt- und Fachdaten wie Mietspiegel oder GEG-Pflichtangaben.
  </Feature>
  <Feature icon="check" title="Aktionen mit Bestätigung">
    Alles, was Daten verändert, zeigt er zuerst als Karte im Chat: **Erlauben**, **Ablehnen** oder **Für diesen Chat erlauben**. Ohne deine Zustimmung passiert nichts.
  </Feature>
  <Feature icon="link" title="Versteht die aktuelle Seite">
    Der Mini-Assistent kennt die Seite, auf der du bist: Er bietet passende Schnellaktionen an und kann Formularfelder befüllen, aber nur nach deinem Klick auf **Übernehmen**.
  </Feature>
  <Feature icon="clock" title="Gedächtnis und Wissensspeicher">
    Er merkt sich auf Wunsch persönliche Vorlieben und legt Workspace-Wissen im semantischen Wissensspeicher ab, aus dem das ganze Team schöpft.
  </Feature>
  <Feature icon="coin" title="Faire Abrechnung">
    Abgerechnet wird pro Nachricht nach tatsächlichen Kosten. Kleinbeträge werden gebündelt, und du wählst nur den Modus (Lite, Standard, Premium), nie ein Modell.
  </Feature>
</FeatureGrid>

## Erste Schritte

<Steps>
  <Step title="Assistenten öffnen">
    Klicke auf den schwebenden Orb, drücke <Kbd>Cmd</Kbd>/<Kbd>Ctrl</Kbd>+<Kbd>K</Kbd> oder öffne `/agent` im Vollbild. Installieren musst du nichts: Der Assistent ist in jedem Plan enthalten.
  </Step>
  <Step title="Frage stellen">
    Schreib einfach los in den Composer (**Frag mich etwas …**). Beispiele: "Fasse dieses Objekt in drei Sätzen zusammen" oder "Schreibe eine Einladung zur Besichtigung".
  </Step>
  <Step title="Modus verstehen">
    Standardmäßig läuft alles im Modus **Standard**, der für rund 90 Prozent aller Anfragen passt. Für wichtige Antworten gibt es **Premium**, für schnelle Kleinigkeiten **Lite** (muss vom Owner freigeschaltet sein). Details: [Modi und Kosten](/tools/agent/modi-und-kosten).
  </Step>
  <Step title="Anhänge und Erwähnungen nutzen">
    Häng bis zu 6 Dateien an (Text, Bild, PDF, per Drag and Drop oder aus der Zwischenablage) und erwähne Objekte oder Leads mit `@`, damit der Assistent gezielt damit arbeitet.
  </Step>
  <Step title="Aktionen bestätigen">
    Will der Assistent etwas ändern (zum Beispiel eine Aufgabe anlegen), erscheint eine Bestätigungs-Karte im Chat. Erst dein Klick auf **Erlauben** führt die Aktion aus.
  </Step>
</Steps>

## Kosten

Der Assistent rechnet pro Nachricht ab, nach den tatsächlichen Kosten mal Modus-Faktor (Lite 0.15x, Standard 1x, Premium 3.5x). Kleine Beträge werden gesammelt und erst ab 5 Credits als ein einziger Eintrag gebucht: **KI-Assistent · gebündelte Nutzung (N Nachrichten)**. Beträge unter der Kleinbetrags-Schwelle werden standardmäßig gar nicht erst angezeigt (abgebucht wird immer korrekt); den Anzeige-Schalter findest du unter **Konto > Erscheinungsbild**. Alles Weitere, inklusive Schätz-Pill, Kosten-Zeile und leerem Guthaben, steht unter [Modi und Kosten](/tools/agent/modi-und-kosten). Credits nachladen: [Anleitung](/help/howto/topup-credits).

## Alle Themen im Detail

<CardGrid>
  <Card title="Chat und Projekte" href="/tools/agent/chat-und-projekte">
    Die Vollbild-Ansicht unter /agent: Seitenleiste, Chat-Menü, Projekte, geteilte Ordner mit Live-Zusammenarbeit und das Archiv.
  </Card>
  <Card title="Mini-Assistent" href="/tools/agent/mini-assistent">
    Der Orb auf jeder Seite: Panel, Seiten-Kontext, Schnellaktionen, Tastenkürzel, "Dazu fragen" und das Ausfüllen von Feldern.
  </Card>
  <Card title="Fähigkeiten" href="/tools/agent/faehigkeiten">
    Alle Werkzeuge in der Referenz: Objekte, Dateien, Websuche, Marktdaten, onOffice, DB-Leads, Homestaging-Bilder und mehr.
  </Card>
  <Card title="Modi und Kosten" href="/tools/agent/modi-und-kosten">
    Lite, Standard und Premium, automatische Modellwahl, Abrechnung pro Nachricht, Bündelung und alle Kosten-Anzeigen.
  </Card>
  <Card title="Wissen und Gedächtnis" href="/tools/agent/wissen-und-gedaechtnis">
    Der semantische Wissensspeicher des Workspace und dein persönliches Gedächtnis, inklusive Verwalten und Vergessen.
  </Card>
  <Card title="Plugins" href="/tools/agent/plugins">
    Was der Assistent kann und wer es bedient: Workspace-Plugins mit Skills, persönliche Plugins wie der onOffice AI Connector, Rechte und Freigaben.
  </Card>
  <Card title="Einstellungen" href="/tools/agent/einstellungen">
    Workspace-Einstellungen für Owner und Admins (Plugins, Modi, Marke, KI-Modelle) und persönliche Einstellungen pro Person.
  </Card>
  <Card title="Sicherheit und Datenschutz" href="/tools/agent/sicherheit-und-datenschutz">
    EU AI Act, Schutz vor eingeschleusten Anweisungen, Rechte-Grenzen und was protokolliert wird.
  </Card>
  <Card title="Fehlerbehebung" href="/tools/agent/troubleshooting">
    Alle Fehlermeldungen und was du jeweils tun kannst, von leerem Guthaben bis zum verschwundenen Orb.
  </Card>
</CardGrid>

## Häufige Fragen

<Faq>
  <FaqItem q="Ist der Assistent in meinem Plan enthalten?">
    Ja. Der Assistent ist ein Standard-Tool und in jedem Plan enthalten. Er ist automatisch aktiv und lässt sich nicht deinstallieren.
  </FaqItem>
  <FaqItem q="Ändert der Assistent Daten, ohne zu fragen?">
    Nein. Jede Aktion, die Daten verändert, erscheint zuerst als Bestätigungs-Karte im Chat. Erst **Erlauben** führt sie aus, **Ablehnen** verwirft sie. Auch Formularfelder befüllt er nur nach deinem Klick auf **Übernehmen**.
  </FaqItem>
  <FaqItem q="Welches KI-Modell nutzt der Assistent?">
    Das wählt REOS AI automatisch nach Komplexität der Anfrage. Du entscheidest nur den Modus (Lite, Standard, Premium); Admins können unter **Einstellungen > Assistent > KI-Modelle** feste Modelle hinterlegen.
  </FaqItem>
  <FaqItem q="Kann ich den schwebenden Orb ausblenden?">
    Ja, für dich persönlich unter **Konto > Assistent** im Bereich **Verhalten**. Der Vollbild-Assistent unter /agent bleibt weiterhin erreichbar.
  </FaqItem>
  <FaqItem q="Was kostet eine Nachricht?">
    Das hängt von der Aufgabe und dem Modus ab. Kleine Beträge werden gebündelt und standardmäßig nicht einzeln angezeigt. Vor teuren Massen-Aktionen zeigt der Composer eine Schätz-Pill. Details: [Modi und Kosten](/tools/agent/modi-und-kosten).
  </FaqItem>
</Faq>