# Automatisierungen einrichten und steuern (/docs/anwenden/automatisierungen)

> Peaki nach Zeitplan, auf Anfrage oder bei neuen Mails arbeiten lassen, festlegen, was ohne Rückfrage geschieht, und jeden Lauf nachverfolgen.

Eine Automatisierung ist ein gespeicherter Auftrag, den Peaki ohne Sie ausführt. Sie hat vier Teile: den Auftragstext, einen Auslöser, die Notizen, Wissensdatenbanken und Programme, die sie erreichen darf, und einen Freigabe-Modus für Aktionen ausserhalb von PeakPrivacy. Jeder Lauf hat einen eigenen Chat. Rückfragen beantwortet dabei niemand, deshalb trifft Peaki vorsichtige Annahmen und hält sie dort fest.

> **Beta:** Automatisierungen und das Cockpit sind Beta-Funktionen. Während der laufenden Beta sind sie in jedem Abonnement enthalten. Danach setzen sie ein separates Abonnement voraus.

## So geht's
1. **Neu anlegen.** Öffnen Sie im Peaki-Bereich **Automatisierungen** und klicken Sie auf **Neu**.

2. **Auftrag beschreiben.** Schreiben Sie unter **Was soll es bei jedem Lauf tun?**, welche Daten Peaki nimmt und was am Ende vorliegen soll. Klicken Sie auf **Weiter**.

3. **Rückfragen beantworten.** Peaki stellt höchstens drei Fragen, oft nur die nach der Uhrzeit.

4. **Auslöser wählen.** Wählen Sie **Nach Zeitplan** oder **Nur auf Anfrage**. **Wenn etwas passiert** öffnet die erweiterten Einstellungen ohne Ihren Text. Kopieren Sie ihn deshalb vorher.

5. **Freigabe-Modus prüfen.** Die Zeile **Externe Aktionen** zeigt den [Freigabe-Modus](/docs/anwenden/automatisierungen#modi). Ändern Sie ihn nach dem Erstellen mit **Bearbeiten**, denn **Ändern** öffnet die erweiterten Einstellungen ebenfalls ohne Ihren Text.

6. **Erstellen.** Mit Zeitplan ist die Automatisierung sofort aktiv. Zum Testen setzen Sie das Häkchen bei **Pausiert erstellen — ich starte sie selbst**. Klicken Sie auf **Automatisierung erstellen**.

7. **Testlauf starten.** Klicken Sie auf **Jetzt ausführen** und lesen Sie das Ergebnis unter **Letzte Läufe**.

8. **Einschalten.** Haben Sie die Automatisierung pausiert erstellt und stimmt das Ergebnis, schalten Sie sie mit dem Schalter in der Zeile ein. Sonst schärfen Sie zuerst den Auftragstext nach.

Alle Felder stehen in den erweiterten Einstellungen, die Sie mit **Weitere Optionen** oder später mit **Bearbeiten** öffnen. Eine Karte unter **Vorschläge** öffnet sie vorausgefüllt. Im Chat legt Peaki auf Ihre Bitte eine Automatisierung mit Zeitplan an. Schreiben Sie «Aktiviere sie» dazu, sonst entsteht sie pausiert.

Der Auftragstext nennt Daten, Format und Ergebnis. Sollen nur Entwürfe entstehen, schreiben Sie «Sende nichts». Zeitangaben gehören in den Auslöser, und die Einrichtung über **Neu** verschiebt sie selbst dorthin. In den erweiterten Einstellungen lassen Sie sie weg. Mehr unter [Peaki gute Aufträge geben](/docs/anwenden/peaki-auftraege).

> **Braucht Ihre Administration:** die Berechtigungen **Peaki** und **Zugriff auf Automatisierungen**. Fehlt eine, sehen Sie **Automatisierungen** nicht. Mehr unter [Mir fehlt eine Funktion](/docs/anwenden/fehlende-funktion#peaki).

## Auslöser
| Auslöser | Startet, wenn | Wofür |
|---|---|---|
| **Nach Zeitplan** | der Termin erreicht ist: täglich, wöchentlich, monatlich, quartalsweise, stündlich oder einmalig | Berichte, Kontrollen |
| **Nur auf Anfrage** | Sie auf **Jetzt ausführen** klicken | seltene, immer gleiche Arbeiten |
| **Webhook** | ein anderes System die Adresse der Automatisierung mit ihrem Schlüssel aufruft | Webformular, Shop, Ticket-System |
| **Folgeautomation** | eine andere Ihrer Automatisierungen fertig ist | Übersicht, danach Mahnentwürfe |
| **Beobachten** | in Gmail eine Mail eintrifft, die zu Ihrer Suche passt | Posteingang |
| **Bei einem Ereignis** | in PeakPrivacy etwas geschieht, etwa ein Entscheid im Cockpit | Protokoll Ihrer Entscheide |

Die unteren vier stellen Sie in den erweiterten Einstellungen unter **Wie es ausgelöst wird** ein. Jeder hängt an einem Schalter, den PeakPrivacy für Ihren Arbeitsbereich setzt und der normalerweise eingeschaltet ist. Ist er aus, startet die Automatisierung nie. Ihre Administration klärt das mit PeakPrivacy.

**Beobachten** braucht Ihr verbundenes Google-Konto und verarbeitet nur Mails, die nach dem Anlegen eintreffen. Nach dem Speichern zeigt die Automatisierung **Webhook-URL** und **Webhook-Schlüssel**. Den Schlüssel sehen Sie nur einmal. Haben Sie ihn verloren, erzeugen Sie mit **Schlüssel rotieren** einen neuen, der alte gilt dann nicht mehr. Testen Sie mit einem echten Aufruf, denn **Jetzt ausführen** startet ohne die Daten des anderen Systems.

Eine geänderte Notiz, eine neue Datei in einer Wissensdatenbank oder das Ende einer Besprechung starten keinen Lauf. Nehmen Sie dafür einen nächtlichen Zeitplan mit [stillen Läufen](/docs/anwenden/automatisierungen#benachrichtigungen).

## Was ein Lauf darf
Jeder Lauf arbeitet in Ihrem Namen.

| Erlaubnis | Aktionen |
|---|---|
| Ohne Rückfrage | Notizen, Wissensdatenbanken und verbundene Programme lesen; Notizen anlegen und ergänzen; Dateien erstellen; Gmail-Entwürfe schreiben; im Web recherchieren, wo die Websuche erlaubt ist |
| Je nach [Freigabe-Modus](/docs/anwenden/automatisierungen#modi) | senden, Labels setzen, Termine eintragen, in andere Systeme schreiben |
| Nie | löschen, archivieren, in den Papierkorb verschieben, als Spam markieren; Automatisierungen oder Skills anlegen oder ändern |

Verknüpfen Sie unter **Notizen & Wissen** Notizen, liest und ergänzt der Lauf nur diese und die Notizen, die er selbst anlegt. Ohne Verknüpfung erreicht er alle Ihre Notizen. Eine Wissensdatenbank verknüpfen Sie über **Mehr** › **In Studio öffnen**.

> **Bekannte Einschränkung:** Hat eine Automatisierung verknüpfte Notizen, kommt eine Notiz, die ein Lauf anlegt, nicht von selbst dazu. Der nächste Lauf sieht sie nicht und legt sie unter demselben Titel noch einmal an. **Ausweg:** Verknüpfen Sie neue Notizen nach dem ersten Lauf über **Bearbeiten**, oder lassen Sie Peaki an feste, verknüpfte Notizen anhängen.

## Freigabe-Modi
Was mit Aktionen ausserhalb von PeakPrivacy geschieht, legt **Externe Aktionen** fest.

| Modus | Was Peaki tut |
|---|---|
| **Nur vorbereiten** (Standard) | Peaki schreibt einen Entwurf oder beschreibt die Aktion im Chat des Laufs. Ausgeführt wird nichts. |
| **Vor dem Handeln fragen** | Die genaue Aktion wartet als Karte im Cockpit auf Ihre Freigabe. |
| **Automatisch** | Was PeakPrivacy dafür zulässt, läuft allein, etwa Gmail-Labels oder Termine in Google Calendar. Alles andere wird eine Karte. |

Mit **Erweitert: pro Kategorie** stellen Sie Bereiche einzeln ein, etwa nur **Kommunikation (E-Mails, Nachrichten)** auf **Vor dem Handeln fragen**.

**Automatisch** wählen Sie in den erweiterten Einstellungen und bestätigen mit **Ja, automatisch handeln**. Startet ein Webhook, eine Folgeautomation, eine beobachtete Mail oder ein Ereignis den Lauf, fragt auch dieser Modus vor jeder Aktion.

E-Mails sendet oder leitet eine Automatisierung in keinem Modus ohne Ihre Freigabe weiter.

Schreibaktionen in bexio und Odoo und das Anlegen von ClickUp-Aufgaben werden zwar zu Karten, lassen sich im Cockpit aber nicht freigeben. Lassen Sie die Automatisierung dafür eine Übersicht oder einen Vorschlag erstellen und führen Sie die Aktion in einem Peaki-Chat aus, wo Sie sie direkt freigeben.

## Das Cockpit
Im Cockpit wartet jede zurückgehaltene Aktion als Karte, bis Sie sie freigeben, bearbeiten, ablehnen oder zurückstellen. Sie öffnen es im Peaki-Bereich über **Cockpit**. Mehr unter [Cockpit](/docs/anwenden/cockpit).

## Benachrichtigungen und Ablage
Ein beendeter Lauf meldet sich kurz am Bildschirmrand, und die Meldung bleibt hinter der Glocke **Aktivität**. Ausgenommen sind stille und gestoppte Läufe. In den erweiterten Einstellungen schreibt **Ergebnis in Kanal senden** zusätzlich Titel, Status und Link in einen Kanal, aber nicht die Antwort. **Ergebnis in Ordner ablegen** legt den Chat des Laufs in einen Ihrer Ordner.

Für Kontrollen, die meist nichts finden, stellen Sie bei einem wiederkehrenden Zeitplan **Wann benachrichtigen** auf **Nur melden, wenn sich etwas ändert**. Ein Lauf bleibt nur still, wenn seine Antwort mit dem Wort `NO_CHANGE` beginnt. Diese Regel schreiben Sie selbst in den Auftragstext:

```text
Hat sich nichts geändert, antworte mit genau einer Zeile, die mit NO_CHANGE beginnt.
```

Fehlgeschlagene und übersprungene Läufe, Läufe über **Jetzt ausführen** und Läufe mit neuen Karten im Cockpit melden sich immer.

## Läufe und Status
**Letzte Läufe** in der geöffneten Automatisierung zeigt die Läufe mit Zeit, Auslöser und Status. Ein Klick öffnet den Chat des Laufs mit dem Ergebnis und Peakis Annahmen.

| Status | Bedeutung |
|---|---|
| **Abgeschlossen** | Fertig, auch bei einem stillen Lauf. |
| **Fehlgeschlagen** | Der Grund steht dabei, die Rohmeldung unter **Technische Details**. |
| **Übersprungen** | Nie gestartet: Der vorige Lauf lief noch, oder der Dienst war zu lange nicht erreichbar. |
| **Ihre Eingabe wird benötigt** | Der Lauf hörte mit einer offenen Frage auf. Beantworten Sie sie im Chat des Laufs und ergänzen Sie die Angabe im Auftragstext, damit der nächste Lauf nicht wieder fragt. |

Nach einer vorübergehenden Störung wie einem Netzwerkfehler startet PeakPrivacy den Lauf von selbst erneut. Der neue Versuch steht als eigene Zeile mit **Erneut versuchen** unter **Letzte Läufe**.

Nach mehreren Fehlschlägen in Folge pausiert PeakPrivacy die Automatisierung und zeigt **Automatisch pausiert nach wiederholten Fehlern**. Beheben Sie die Ursache und klicken Sie auf **Fortsetzen**. **Jetzt ausführen** startet einen einzelnen Lauf, aber der Zeitplan bleibt angehalten.

## Automatisierung verwalten
- **Pausieren.** Der Schalter in der Zeile hält alle Läufe an. Karten im Cockpit bleiben offen.
- **Fortsetzen.** Verpasste Termine holt PeakPrivacy nicht nach.
- **Sofort starten.** **Jetzt ausführen** startet einen Lauf, ausser es läuft schon einer.
- **Ändern.** **Bearbeiten** öffnet die erweiterten Einstellungen. Frühere Fassungen stehen unter **Mehr** › **Versionsverlauf**.
- **Im Studio bearbeiten.** **Mehr** › **In Studio öffnen** zeigt dieselbe Automatisierung mit anderen Bezeichnungen: **Aufgabe** ist der Auftragstext, **Planen** der Zeitplan, **Nur benachrichtigen, wenn sich etwas ändert** der stille Lauf und **Autonomie** der Freigabe-Modus. Nur hier verknüpfen Sie unter **Notizen & Wissen** auch eine Wissensdatenbank. **Erinnerungen** hält fest, was sich diese Automatisierung über ihre Läufe hinweg merkt, und hat mit Ihren persönlichen Erinnerungen nichts zu tun. Füllen Sie **Anweisungen** aus, läuft sie als wiederverwendbarer Agent.
- **Löschen.** **Automatisierung löschen** entfernt Automatisierung, Zeitplan und Verlauf endgültig. Die Chats der Läufe bleiben.

Im Chat pausiert Peaki eine Automatisierung auf Ihre Bitte, setzt sie fort, startet einen Lauf oder löscht sie nach einer Rückfrage. Auch Auftragstext und Zeitplan ändert es dort. Andere Auslöser, **Automatisch**, verknüpfte Notizen, Kanal und Ordner sowie den **Versionsverlauf** bearbeiten Sie in der Automatisierung selbst. Auf die Frage «Was ist gestern in meiner Automatisierung ‹Offene Rechnungen› passiert?» nennt Peaki Status und Fehlergrund.

## Zwei Beispiele
### Wochenbericht offene Rechnungen
Nadia aus der Buchhaltung legt die Automatisierung über **Neu** an. Der Zeitplan steht auf **Wöchentlich**, Montag, 07:30, der Modus auf **Nur vorbereiten**.

```text
Erstelle eine Übersicht der offenen Kundenrechnungen aus bexio,
gruppiert nach Fälligkeit (nicht fällig, 1–30, 31–60, über 60 Tage überfällig).
Speichere sie als Notiz «Offene Rechnungen» mit der Summe je Gruppe in CHF.
Verwende nur vorhandene Zahlen und sende nichts.
```

### Posteingang sortieren
Mira aus dem Office-Management lässt neue Mails mit dem Auslöser **Beobachten** einordnen. Unter **Externe Aktionen** steht nur **Kommunikation (E-Mails, Nachrichten)** auf **Vor dem Handeln fragen**, deshalb erscheinen ihre Antwortvorschläge als Karten im Cockpit. Gmail-Suche, Auftragstext und Test zeigt [Den Posteingang mit Peaki vorsortieren](/docs/anwenden/beispiele/posteingang-vorsortieren).

## Wenn es nicht klappt
- **Die Automatisierung lief nie.** Prüfen Sie den Schalter in der Zeile. Mit **Nur auf Anfrage** startet sie erst über **Jetzt ausführen**.
- **Sie lief, aber Sie hörten nichts.** Ein stiller Lauf steht unter **Letzte Läufe**. Sonst liegt die Meldung ungelesen hinter der Glocke.
- ****Beobachten** startet nie.** Testen Sie die Suche in Gmail und prüfen Sie die Verbindung zu Google.
- **Eine **Folgeautomation** startet nie.** Die vorangehende Automatisierung schlug fehl oder wurde gelöscht. Wählen Sie **Bei jedem Abschluss** oder eine andere Automatisierung.
- **Der Lauf legt eine Notiz mit Ihrer Anweisung an, statt zu arbeiten.** Im Auftragstext stehen Zeitangaben wie «jeden Montag um 08:00». Entfernen Sie sie.
- **Keine Karte im Cockpit.** **Externe Aktionen** steht auf **Nur vorbereiten**, die Priorität liegt ausserhalb von **Nur diese Prioritäten** (standardmässig P0 bis P2), das **Maximum** je Lauf ist erreicht, oder die Aktion war eine Löschung. Der Chat des Laufs beschreibt, was Peaki getan hätte. Beide Felder stehen unter **Cockpit-Übergabe**. Diese erscheint nur, wenn **Externe Aktionen** für alle Bereiche auf **Vor dem Handeln fragen** steht. Bei einer Einstellung pro Kategorie gelten die Standardwerte.

## Siehe auch
- [Peaki: der Agent von PeakPrivacy](/docs/anwenden/peaki-ueberblick)
- [Im Cockpit über vorbereitete Aktionen entscheiden](/docs/anwenden/cockpit)
- [Gmail, bexio und andere Programme mit Peaki nutzen](/docs/anwenden/peaki-programme)
