bifroest/app/help/pages/faq.md

94 lines
4.9 KiB
Markdown

# Häufige Fragen
Probleme, die häufiger vorkommen, und was dagegen hilft.
## Chat und Antworten
### Im Workspace gibt es keinen Chat
Der Chat erscheint erst, wenn eine Datenquelle erfolgreich getestet oder eine Datei hochgeladen wurde. Ein Workspace-Admin prüft unter *Daten*, ob die Quelle den Status „ok“ hat, und testet sie ggf. erneut. Soll der Workspace ganz ohne Daten auskommen, kann der Admin *Ohne Datenquellen chatten* einschalten.
### Die Antwort bleibt bei „wartet“
Antworten entstehen im Worker. Bleibt eine Antwort lange in *wartet*, läuft vermutlich kein Worker. Bitte den Betrieb bzw. einen Plattform-Admin informieren.
### Die Antwort zeigt „Wartet auf Freigabe“
Ein Tool braucht eine Freigabe. Admins und Freigeber des Workspace (oder globale Approver) sind benachrichtigt. Du kannst die Seite schließen; die Antwort läuft nach der Entscheidung weiter. Den Stand siehst du unter *Freigaben*.
### „Das Limit an Tool-Schritten ist erreicht“
Die Aufgabe brauchte mehr Schritte, als eine Antwort darf. Die KI hat den Stand zusammengefasst; *Weiterarbeiten* setzt fort. Workspace-Admins können das Limit unter *Einstellungen → Allgemein → Antworten* erhöhen.
### Die Kontext-Anzeige ist rot
Der Chat ist sehr lang. Ältere Teile gehen nur noch als Arbeitsnotiz mit. Für ein neues Thema besser einen neuen Chat beginnen.
### Die KI sagt, ein Tool sei „nicht verfügbar“ oder „gesperrt“
- Neue Tools sind gesperrt, bis ein Plattform-Admin sie unter *Tools* einstuft.
- Ein Workspace-Admin hat das Tool für den Workspace gesperrt.
- Im Planungsmodus stehen schreibende Tools nicht zur Verfügung. Erst *Plan umsetzen*.
### „Vom AI Gateway blockiert“
Der Inhaltsfilter des AI Gateways hat die Anfrage abgelehnt. Formuliere die Frage anders. Bei Fragen zur Regel hilft das Team, das das Gateway betreibt.
### Die KI behauptet, etwas geändert zu haben, aber nichts ist zu sehen
Maßgeblich ist die Ansicht *Änderungen*: Nur was dort als Commit steht, ist geändert. Unter der Antwort zeigen die Tool-Aufrufe, was wirklich passiert ist. Bitte die KI, die Änderung mit einem Commit umzusetzen.
### Auf einer Fehlerseite steht eine Fehler-ID
Gib die Fehler-ID an den Betrieb weiter. Damit findet er den Fehler im Log.
## Code und Pull Requests
### „Branch hat auf dem Server einen anderen Stand … Es wurde nichts überschrieben“
Auf dem Branch im Git-Server liegt ein anderer Stand, z. B. weil jemand von außen gepusht hat. Die Plattform überschreibt nie. Kläre, wessen Änderungen gelten; die Commits von außen lassen sich lokal in den Branch holen.
### „Konflikt mit main“
Der Ziel-Branch hat dieselben Stellen anders geändert. *Konflikte von der KI lösen lassen* führt die Branches zusammen und löst die Konflikte; prüfe danach den Diff. Sehr große Konfliktdateien löst ihr besser lokal.
### „Für diese Quelle ist kein Pull-Request-Anbieter eingestellt“
Der Branch wurde gepusht, aber die Quelle ist nicht mit Bitbucket verbunden. Lege den Pull Request im Git-Server an, oder bitte einen Workspace-Admin, an der Quelle *Bitbucket Data Center* einzustellen.
### Neue Commits erscheinen nicht im Pull Request
Nach dem Erstellen des Pull Requests gehen neue Commits erst mit *Änderungen übertragen* hinein. So entscheidet ein Mensch, wann der Pull Request sich ändert.
### Ich möchte einen Commit rückgängig machen
Noch nicht übertragene Commits: *Letzten Commit zurücknehmen* unter *Commits und Diff*. Übertragene Commits: die KI um einen korrigierenden Commit bitten oder im Review ablehnen.
### Nach dem Merge entsteht ein neuer Branch mit „-2“
Gewollt: Ein abgeschlossener Branch wird nicht wiederverwendet. Weitere Änderungen im selben Chat beginnen auf dem aktuellen Stand von main.
### Syntaxwarnung beim Commit
Die Plattform hat einen Syntaxfehler gefunden. Der Commit ist trotzdem angelegt; die KI behebt ihn normalerweise im nächsten Commit. Bleibt die Warnung, die KI darauf hinweisen.
## Dateien und Daten
### Der Upload wird abgelehnt
- Das Speicherkontingent des Workspace ist voll: alte Dateien unter *Daten* löschen oder einen Plattform-Admin um mehr Platz bitten.
- Die Datei ist größer als erlaubt, oder das Format wird nicht unterstützt (CSV, TSV, JSON, JSON Lines, Parquet).
### Das Abfrageergebnis ist gekürzt
Angezeigt wird nur eine begrenzte Zahl an Zeilen. Lass die KI aggregieren (Summen, Gruppierungen) oder lade das Ergebnis als CSV herunter.
## Konto und Benachrichtigungen
### Ich kann mich nicht anmelden
Nach 5 Fehlversuchen ist das Konto 15 Minuten gesperrt. Ein Plattform-Admin kann mit *Passwort zurücksetzen* sofort entsperren und ein neues Einmal-Passwort ausgeben.
### Ich bekomme keine E-Mails
Prüfe im *Profil*, ob deine E-Mail-Adresse eingetragen ist und Benachrichtigungen nicht abbestellt sind. Kommen trotzdem keine an, sieht ein Plattform-Admin unter *Administration → Benachrichtigungen* den Stand der Zustellung.