Push-Benachrichtigungen

Push-Benachrichtigungen sagen dir, wann ein Agent dich braucht oder fertig ist, während OAR nicht vor dir geöffnet ist: Eine Frage wartet, ein Turn ist fertig, ein Plan ist bereit. Sie sind standardmäßig aus, und du schaltest sie auf jedem Gerät einzeln ein.

Dein eigenes Relay schickt sie über den Push-Dienst des Herstellers deines Browsers an deine Geräte, mit der Standard-Web-Push-Bibliothek und eigenen VAPID-Keys. Kein OAR-Server ist beteiligt. Das Relay erzeugt die Keys beim ersten Start und hält sie in seiner Datenbank, sodass sie Neustarts überstehen. Der Text einer Benachrichtigung ist nur das, was du unter Was eine Benachrichtigung zeigt erlaubst: standardmäßig eine allgemeine Zeile ohne jeden Text aus der Konversation.

Was du brauchst #

• Eine sichere Seite. Öffne OAR über HTTPS oder auf localhost. Unter jeder anderen Adresse bietet der Browser kein Push an, und die Benachrichtigungseinstellungen sagen „Push requires a secure context. Open the app over HTTPS (or localhost) to enable notifications on this device.“ Dieselbe Regel steht unter Als App installieren.
• Einen Browser mit Web Push. Er braucht Service Worker, die Push API und die Notification API. Sonst sagen die Einstellungen „This browser does not support Web Push notifications.“ (oder „...service workers, which push notifications require.“).
• Dasselbe auf jedem System. OAR prüft diese Browserfunktionen und sonst nichts; eine eigene iOS-Regel gibt es nicht. Bietet der Browser deines iPhones oder iPads sie nicht an, sagen das die Benachrichtigungseinstellungen.

Einschalten #

Mach das auf jedem Gerät, das Benachrichtigungen bekommen soll. Die Einstellung wird pro Gerät gespeichert; sie im Browser deines Laptops einzuschalten, bewirkt nichts für dein Handy.

1. Öffne Settings → Notifications (Einstellungen → Benachrichtigungen).
2. Schalte Enable push notifications on this device (Push-Benachrichtigungen auf diesem Gerät aktivieren) ein.
3. Erlaube Benachrichtigungen, wenn der Browser fragt. Die Abfrage erscheint nur nach einem Klick auf den Schalter, nie beim Laden der Seite.
4. Die Statuszeile lautet „Push notifications are enabled on this device. They are only sent while no device has the app open.“, und die übrigen Bedienelemente werden freigegeben. (Genau gilt: Kein Gerät zeigt OAR sichtbar im Vordergrund; siehe Wann keine Benachrichtigung gesendet wird.)
5. Wähl die Ereignisse und was die Benachrichtigungen zeigen (unten).

Einen Button für eine Testbenachrichtigung gibt es nicht. Um zu prüfen, ob es funktioniert, lass OAR im Hintergrund (oder schließ seinen Tab) und lass einen kurzen Turn fertig werden.

Schaltest du den Schalter wieder aus, bleibt das Gerät in der Liste, markiert als disabled (deaktiviert), und bekommt nichts mehr. Wieder einschalten wirkt sofort.

Die Geräteliste #

Unten im Tab listet Devices (Geräte) jedes Gerät, das auf diesem Relay abonniert ist, die jüngste Änderung zuerst. Eine Zeile zeigt:

• den Gerätenamen, zum Beispiel Android Chrome; er ergibt sich aus Browser und System, sonst Unnamed device (Unbenanntes Gerät). Dazu kommen (this device) (dieses Gerät) bei deinem eigenen und disabled, wo es ausgeschaltet ist;
• Last delivery (Letzte Zustellung): wann zuletzt eine Benachrichtigung angekommen ist, oder never (nie), dazu den letzten Fehler, falls der letzte Versuch gescheitert ist.

Rename (Umbenennen) fragt nach einem neuen Namen (bis zu 80 Zeichen). Revoke (Widerrufen) fragt nach einer Bestätigung, entfernt das Gerät vom Relay und entfernt auf dem Gerät, das du gerade benutzt, auch sein Abonnement aus dem Browser. Ein anderes Gerät, das du von hier aus widerrufst, bekommt sofort nichts mehr, aber seinem Browser kann von hier aus nichts mitgeteilt werden: Der Browser behält sein eigenes Abonnement, bis du es dort entfernst. Öffne auf diesem Gerät Settings → Notifications; der Schalter steht auf aus. Schalte ihn wieder ein, um Benachrichtigungen zu bekommen, oder entferne die Benachrichtigungsberechtigung der Seite in den Website-Einstellungen dieses Browsers, um das Abonnement endgültig zu verwerfen.

Die Ereignisse #

Jedes Ereignis hat einen eigenen Schalter unter Notify about (Benachrichtigen bei). Die Schalter gehören zum Gerät, sodass sich Handy und Laptop unterscheiden können.

Wann keine Benachrichtigung gesendet wird #

• Solange ein Gerät OAR im Vordergrund hat. Zeigt eines deiner Geräte OAR auf dem Bildschirm, wird an kein Gerät etwas gesendet. Eine sichtbare Seite meldet das dem Relay alle 30 Sekunden, und das Relay zählt ein Gerät noch 90 Sekunden nach seiner letzten Meldung als aktiv. Eine Seite, die verborgen wird, meldet das sofort. Kann das Relay es nicht feststellen, sendet es nicht.
• Für einen Turn, den ein anderer Agent gestartet hat. Schickt ein Agent auf einem anderen Relay (oder eine von einem Agent gestartete Session) einer Session einen Prompt, sendet dieser Turn weder Turn completed noch Turn failed: Der Agent ist der Wartende und berichtet dir selbst. Siehe Nachrichten zwischen Agents. Rückfragen erreichen dich weiterhin.
• Für einen Turn, der auf Relay-Ereignisse antwortet. Ein Turn, den ein Relay-Ereignis gestartet hat, sendet aus demselben Grund keins von beiden; ein beobachtender Agent, der auf Ereignisse antwortet, sendet selbst einen Push, wenn etwas wichtig ist. Rückfragen bleiben unverändert.
• Ereignisse, die du auf diesem Gerät ausgeschaltet hast, oder ein Gerät, das ausgeschaltet ist.

Eine Benachrichtigung, die nicht sofort zugestellt werden kann, hält der Push-Dienst bis zu 12 Stunden vor.

Was eine Benachrichtigung zeigt #

Drei Einstellungen, ebenfalls pro Gerät, bestimmen, wie viel von der Konversation das Relay verlässt.

Steht Message preview auf None (generic text), ist der Text eine feste Zeile:

Mit Vorschau ist der Text der Text der Frage, die Antwort (oder der Fehlertext eines gescheiterten Turns) oder der Titel des Plan-Boards. Full text wird bei 2000 Zeichen gekürzt.

Die Benachrichtigung trägt außerdem ein paar Kennungen, die die App braucht, um die richtige Konversation zu öffnen (Konversation, Frage, Board oder Nachricht). Die kurzen Antwortmöglichkeiten einer Frage reisen ebenfalls mit, unabhängig von der Vorschau-Einstellung, denn aus ihnen werden die Buttons (siehe Aus der Benachrichtigung antworten).

Drei Ereignisse ignorieren die Vorschau-Einstellung. CLI went offline zeigt immer seine feste Zeile. Host suspend fired or was dropped zeigt immer seine eigene Meldung („All agents finished; the host is suspending now.“ oder „Queued host suspend dropped: relay ...“). Queued relay restart waited its maximum time zeigt ebenfalls immer seine eigene Meldung, etwa „The queued relay restart has waited 30 min for 2 sessions. Restart now, keep waiting or cancel it.“.

Für mehr Privatsphäre lass Titel und Vorschau aus: Dann steht nichts aus deinen Konversationen in der Benachrichtigung.

Auf eine Benachrichtigung tippen #

Ein Tippen auf eine Benachrichtigung öffnet OAR in dieser Konversation (eine Benachrichtigung ohne Konversation, etwa CLI offline, öffnet OAR selbst). Ist OAR schon in einem Fenster offen, kommt dieses Fenster nach vorn und zeigt die Konversation; sonst öffnet sich ein neues Fenster. Jedes Ereignis bekommt eine eigene Benachrichtigung: Sie stapeln sich und ersetzen einander nicht.

Aus der Benachrichtigung antworten #

Eine Rückfrage-Benachrichtigung kann Buttons für die Antwortmöglichkeiten der Frage tragen:

• bis zu drei Möglichkeiten und nicht mehr Buttons, als dein Gerät zeigt;
• eine Möglichkeit mit mehr als 120 Zeichen bekommt keinen Button, und die Beschriftung eines Buttons wird auf 40 Zeichen gekürzt (gesendet wird die vollständige Möglichkeit);
• ein Tippen auf einen Button schickt diese Antwort an das Relay, ohne OAR zu öffnen, solange die Frage noch wartet und der Browser beim Relay angemeldet ist.

Kommt die Antwort nicht an (die Frage wurde anderswo beantwortet, ist abgelaufen, oder du bist offline), öffnet das Tippen stattdessen die Konversation, damit du siehst, warum. Siehe Rückfrage-Karten.

Mehrere Geräte, abgelaufene Abonnements, eine neue Adresse #

• Mehrere Geräte. Jedes Gerät, das du eingeschaltet hast, bekommt jede Benachrichtigung, deren Ereignis dort eingeschaltet ist. Die Vordergrund-Regel gilt für alle zusammen.
• Ein abgelaufenes Abonnement. Meldet der Push-Dienst, dass ein Abonnement nicht mehr existiert, entfernt das Relay das Gerät von selbst aus der Liste. Ein Gerät, das aus einem anderen Grund immer wieder scheitert, wird nach 8 gescheiterten Sendungen in Folge entfernt. Schalte die Einstellung auf diesem Gerät wieder ein, um es neu zu abonnieren.
• Nachdem sich die Adresse des Relays geändert hat. Ein Abonnement gehört zu der Seite, auf der du es eingeschaltet hast. Öffne OAR auf jedem Gerät unter der neuen Adresse und sieh unter Settings → Notifications nach: Ein Gerät, das dort nicht abonniert ist, zeigt den Schalter aus. Der alte Eintrag bleibt in der Liste, bis du ihn mit Revoke entfernst oder der Push-Dienst ihn als verschwunden meldet. Das Relay behält seine Push-Keys über Neustarts hinweg, sodass ein Neustart unter derselben Adresse keine neue Einrichtung braucht.

Fehlerbehebung #

Siehe auch Settings für die Liste der Bedienelemente und Pause am Nutzungslimit dafür, wie ein pausierter Turn benachrichtigt.