gooddeploy
Handbuch · Kapitel 21

Assistent

Der Assistent im Dashboard heißt Rollo. Er ist eine KI, die dir erklärt, was du gerade siehst, und dir den nächsten Schritt zeigt. Hier steht, wie du ihn öffnest, wie du ihn für dein Team einstellst und wann Inhalte deiner Seiten an das Sprachmodell gehen.

Rollo öffnen und fragen

Oben rechts im Dashboard steht der Knopf „Assistent“ mit Rollos Gesicht. Du öffnest ihn auch mit der Tastatur: ⌘K auf dem Mac, Strg+K unter Windows und Linux. Auf dem Handy erscheint er als Fenster von unten. Esc oder das Kreuz schließen ihn. Während Rollo an einer Antwort arbeitet, schaut er umher. Hast du in deinem System weniger Bewegung eingestellt, bleibt er still.

Rollo ist auf jeder Seite des Dashboards da, auch beim Anlegen eines neuen Projekts, auf der Einrichtungsseite, auf der Seite eines Deployments, im Laufzeit-Log und in den Einstellungen des Teams. Ist ein Dialog offen (zum Beispiel „Live schalten“), erklärt er diesen Dialog.

  • Beim ersten Öffnen stellt Rollo sich kurz vor: „Hallo, ich bin Rollo.“ Er sagt, was er kann (erklären, den nächsten Schritt zeigen) und was nicht: Er ändert nichts, Live schalten, Löschen und Einstellungen machst du selbst.
  • Darunter stehen zwei bis drei Vorschläge zum Antippen, passend zur Seite. Zeigt die Seite einen Fehler, kommen zuerst Vorschläge wie „Warum ist das fehlgeschlagen?“.
  • Tipp deine Frage unten ein (höchstens 500 Zeichen) und schick sie mit Enter oder dem Knopf ab. Für einen Zeilenumbruch nimm Umschalt+Enter.
  • Antworten können auf Einträge der Seite verweisen (z. B. „↗ Fehlerzeile“). Ein Klick darauf markiert die Stelle auf der Seite. Gibt es den Eintrag nicht mehr, steht dahinter „nicht mehr auf der Seite“.
  • Wechselst du die Seite, bleibt das Gespräch erhalten. Eine Trennzeile „Jetzt auf: …“ zeigt, wo du jetzt bist. Verweise aus früheren Antworten auf andere Seiten sind Links („→ Hinweis“): Ein Klick öffnet die Seite und markiert dort den Eintrag.
  • Unter „Was ich von dieser Seite sehe“ steht in Worten zusammengefasst, was Rollo mitbekäme, zum Beispiel „1 Live-Version, 4 ältere Versionen, 1 Ereignis“. „Genau anzeigen“ klappt die einzelnen Einträge auf.
  • Mit „Logs einbeziehen“ entscheidest du, ob Logzeilen mitgehen. Das hilft bei Fehlern; auch dort macht Rollo persönliche Daten unkenntlich.
  • „Neues Gespräch“ oben im Fenster leert das Gespräch, ohne nachzufragen. Etwa 10 Sekunden lang steht dann „Gespräch geleert · Rückgängig“; ein Klick auf „Rückgängig“ holt es zurück.
  • Das Gespräch bleibt nur in deinem Browser, getrennt je Team, und ist nach dem Schließen des Tabs weg.

Rollo erklärt nur. Er ändert nichts an deinen Projekten und führt keine Aktionen aus. Antworten können falsch sein; prüf wichtige Schritte selbst. Tipp nie Passwörter oder Schlüssel in das Feld.

Kommt später: Rollo kann dir Schritte vorschlagen und sie nach deiner Bestätigung ausführen. Befehle für die CLI kommen ebenfalls später.

Wer den Assistenten bekommt

Den Assistenten schaltet goodDEV je Team frei. Solange dein Team nicht freigeschaltet ist, ist er aus, egal was du einstellst. Ob dein Team freigeschaltet ist, siehst du im Dashboard unter „Einstellungen“ in der Karte „Assistent im Team“.

Assistent im Team

owner und admin des Teams wählen im Dashboard unter „Einstellungen“, Karte „Assistent im Team“, was der Assistent darf:

EinstellungBedeutung
Auskein Assistent im Team
Nur allgemeine Hilfeder Assistent erklärt Begriffe und Abläufe, sieht aber nichts von euren Seiten
Ander Assistent darf auch Inhalte der Seite lesen, aber nur bei Personen, die selbst eingewilligt haben (Standard)

Alle anderen im Team sehen die Einstellung, können sie aber nicht ändern. Jede Änderung steht im Protokoll des Teams.

Deine Einwilligung

Ob Inhalte der Seite, die du gerade siehst (zum Beispiel Deployments, Checks oder Logzeilen), an das Sprachmodell gehen, entscheidest du selbst. Du findest die Wahl im Dashboard unter „Einstellungen“, Karte „Deine Einwilligung“:

  • Immer erlauben: Inhalte der Seite gehen bei jeder Frage mit.
  • Jedes Mal fragen: Vor jeder Frage mit Inhalten der Seite zeigt dir der Assistent, was er senden würde, und du entscheidest.

Solange du nichts gewählt hast, geht nur deine Frage an das Sprachmodell, nie Inhalte der Seite. Deine Wahl gilt für dein Konto in allen deinen Teams, lässt sich jederzeit ändern und gilt ab der nächsten Frage.

Beim ersten Öffnen fragt Rollo dich selbst: „Immer erlauben“, „Jedes Mal fragen“ oder „Nur allgemein“ (dann entscheidest du später). Bei „Jedes Mal fragen“ zeigt er vor jeder Frage in Worten, was er weitergeben würde (zum Beispiel „1 Fehlermeldung, 4 Logzeilen“), und du wählst „Mit Seiteninhalt fragen“ oder „Ohne Seiteninhalt fragen“.

Was an das Sprachmodell geht

Deine Frage geht über einen Dienst von goodDEV (n8n) an das Sprachmodell Claude von Anthropic und wird auch außerhalb der EU verarbeitet. Mit deiner Einwilligung kommen Inhalte der Seite dazu, die du gerade siehst: Einträge wie Deployments, Checks, Hinweise, der Ablauf und die letzten Züge des Gesprächs. Logzeilen gehen nur als Ausschnitt der sichtbaren Zeilen mit. Bevor etwas das Haus verlässt, verdeckt gooddeploy E-Mail-Adressen, IP-Adressen, Tokens, Schlüssel, Secrets und Werte von Variablen, auch in deiner Frage.

Nie mit gehen: Werte von Umgebungsvariablen (von der Seite „Umgebungsvariablen“ und ihren Dialogen geht gar nichts mit), Passwörter, Freigabelinks sowie Name und E-Mail-Adresse aus deinem Konto. Von der Seite „Mitglieder“ gehen nur die Rollen mit, keine Namen.

Je Seite legt gooddeploy fest, welche Arten von Einträgen mitgehen dürfen. Zum Beispiel:

SeiteWas mitgehen darf
Neues Projekt mit GitHubdie Schritte und Hinweise, nicht die Liste deiner Repos
Einstellungen des Teamsvon den Git-Verbindungen nur Anbieter, Zustand, Zahl der verknüpften Projekte und seit wann; nicht das Konto (es kann ein persönlicher Name sein), nicht die Namen der Projekte und nicht deine Auswahl in den Formularen
Dialog „Externe Datenbank verbinden“ oder „trennen“nichts
Seite, die Rollo noch nicht kenntnichts; Rollo hilft dort nur allgemein

Zu den letzten Zügen des Gesprächs erfährt das Sprachmodell nur, auf welcher Seite sie stattfanden (zum Beispiel „Deployment“), nicht den Titel oder die Adresse. Steht ein Name in einem anderen Eintrag (zum Beispiel in einer Commit-Nachricht), geht er mit diesem Eintrag mit; E-Mail-Adressen sind überall verdeckt.

Grenzen

Damit die Kosten im Rahmen bleiben, gibt es Grenzen:

GrenzeWert
Fragen je Person30 pro Stunde
Fragen je Team200 pro Tag
Budget je Teamein fester Betrag pro Kalendermonat

Ist eine Grenze erreicht, sagt Rollo das und beantwortet keine weiteren Fragen, bis sie wieder frei ist. Ab 80 % des Monatsbudgets steht unter der Antwort ein Hinweis. Allgemeine Hilfe findest du jederzeit in diesem Handbuch.

FehlercodeBedeutung
SCOPE_MISSINGder Assistent ist für dein Team aus (nicht freigeschaltet oder „Aus“)
RATE_LIMITEDzu viele Fragen in kurzer Zeit oder Budget des Monats aufgebraucht
CONCURRENT_MODIFICATIONdu hast in einem anderen Tab das Team gewechselt; lade die Seite neu
PLATFORM_UNAVAILABLEdas Sprachmodell antwortet gerade nicht; versuch es später noch einmal

Über die API

Dieselben Einstellungen gibt es über die API (mit einem persönlichen Token aus gooddeploy login):

AufrufZweck
GET /v1/me/assistantFreischaltung, Einstellung des Teams und deine Einwilligung lesen
PUT /v1/me/assistant/consentdeine Einwilligung setzen: {"consent": "always"} oder {"consent": "ask"}
PUT /v1/me/assistant/teamEinstellung des Teams setzen (owner und admin): {"mode": "off"}, "general" oder "full"
POST /v1/me/assistant/messagesRollo eine Frage stellen: {"surface": {"id": "page:home"}, "question": "Was ist hier los?"}; mit Einwilligung zusätzlich visible (Einträge der Seite) und history (Züge mit role, text und optional surface, der Seite des Zugs)

Befehle dafür in der CLI kommen später.