2026-10-27 08:34:17 +01:00

17 KiB

Raw Blame History

Für Nutzer

Diese Anleitung erklärt alles, was du als Mitglied eines Workspace brauchst: chatten, Daten auswerten, Code ändern lassen und größere Aufgaben steuern.

Anmelden und Profil

Erste Anmeldung: Du bekommst von einem Plattform-Admin ein Einmal-Passwort. Beim ersten Login setzt du ein eigenes Passwort.
Gesperrt? 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.
Profil: Ein Klick auf deinen Namen oben rechts öffnet das Profil. Dort änderst du dein Passwort, trägst deine E-Mail-Adresse ein und bestellst Benachrichtigungen ab.
Hell oder dunkel: Der Knopf neben deinem Namen schaltet die Darstellung um.

Workspaces

Unter Workspaces siehst du alle Workspaces, in denen du Mitglied bist. Die Übersicht eines Workspace zeigt:

die Chats, mit einer Suche über Titel und Nachrichten,
eine Zeile, welche Daten bereitstehen (Quellen, Dateien, MCP-Dienste).

Ist ein Git-Repository verbunden, gibt es außerdem Repository (siehe unten).

Unter Daten siehst du die Datenquellen und die hochgeladenen Dateien. Hochladen dürfen alle Mitglieder; Datenquellen verbinden nur Workspace-Admins.

Der Chat steht erst zur Verfügung, wenn mindestens eine Datenquelle erfolgreich getestet oder eine Datei hochgeladen wurde.

Chatten

In der Übersicht einen neuen Chat beginnen. Hat der Workspace Beispielfragen (Ausprobieren), startet ein Klick darauf einen Chat mit dieser Frage.
Die Frage ins Eingabefeld unten schreiben. Strg+Enter (Mac: Cmd+Enter) oder Senden schickt sie ab.
Die Antwort erscheint live. Sie entsteht im Hintergrund; du kannst die Seite neu laden oder schließen, ohne sie zu unterbrechen.

Das Eingabefeld bleibt immer unten sichtbar, der Verlauf scrollt darüber.

Während und nach der Antwort:

Tool-Aufrufe: Unter einer Antwort lässt sich aufklappen, welche Tools die KI genutzt hat (z. B. welche Dateien sie gelesen hat).
Abbrechen: Eine laufende Antwort lässt sich abbrechen.
Antwort neu erzeugen bzw. Erneut versuchen nach einem Fehler: unter der letzten Antwort.
Kopieren: kopiert den Text einer Antwort.
Hilfreich? 👍 oder 👎 unter jeder Antwort, danach optional ein kurzer Kommentar („Was hat gefehlt?“). Nochmal klicken nimmt die Bewertung zurück. Die Rückmeldungen helfen den Admins zu sehen, wo die KI gut ist und wo nicht; sie sehen dabei deinen Namen.
Exportieren: lädt den ganzen Chat als Markdown-Datei herunter.
Bearbeiten: Wer den Chat angelegt hat, und Workspace-Admins können ihn umbenennen oder löschen; löschen geht auch direkt in der Chat-Liste des Workspace.

Die Zeile über jeder Antwort zeigt Uhrzeit und Modell, dazu:

Kontext x %: wie voll das Kontextfenster des Modells bei dieser Antwort war. Ab 80 % wird der Wert rot; dann hilft es, für ein neues Thema einen neuen Chat zu beginnen.
Regeln: …/AGENTS.md: welche Projektregeln aus dem Repository galten (siehe Code ändern lassen).

Über dem Verlauf siehst du die aktiven Quellen und wie viele Tokens und Kosten der Chat bisher verursacht hat.

Tipps für gute Ergebnisse:

Konkret fragen und Ziel nennen: „Finde heraus, warum der Export bei leeren Listen abbricht, und schlag eine Korrektur vor.“
Bei Code nach Pfaden und Zeilen fragen; die KI nennt die Stellen, auf die sie sich stützt.
Für ein neues Thema einen neuen Chat beginnen. Das hält den Kontext klein und die Antworten genauer.
Behauptet die KI etwas Wichtiges, die genannten Stellen kurz prüfen. Sie kann sich irren.

Repository

Repository in der Seitenleiste erscheint, sobald der Workspace ein Git-Repository verbunden hat. Bei mehreren Repositories wählst du oben das gewünschte. Die Seite liest nur und ändert nichts.

Neu: Commits auf dem Ziel-Branch (z. B. main), nach Tagen gruppiert, mit Autor, Uhrzeit und geänderten Dateien. Oben steht, was seit deinem letzten Besuch dazugekommen ist; diese Commits sind mit neu markiert. Filtern kannst du nach Zeitraum, Autor und Pfad (z. B. src/api).
Commit: Ein Klick auf einen Commit zeigt Nachricht, Dateien und Diff.
Branches: alle Branches auf dem Git-Server, zuletzt geänderte zuerst. ↑ zählt die Commits, die der Ziel-Branch nicht hat, ↓ die Commits des Ziel-Branches, die im Branch fehlen. Chat-Branches ai/… verweisen auf ihren Chat und den Stand des Pull Requests. Diff zeigt die Änderungen des Branches wie in einem Pull Request.
Pull Requests: offene Pull Requests mit Autor, Branches, Reviewern und Kommentaren, sofern an der Quelle Bitbucket Data Center eingerichtet ist. Diff zeigt die Änderungen.
Dateien: Verzeichnisse und Dateien eines Branches (Auswahl oben rechts), mit Zeilennummern und dem Verlauf der Datei.

Aus der Seite heraus startest du Chats mit Bezug:

Zusammenfassen lassen bzw. Zeitraum zusammenfassen lassen: Die KI fasst die neuen Commits nach Themen zusammen.
Im Chat erklären an einem Commit und Datei erklären an einer Datei: Die KI erklärt den Commit bzw. die Datei. Liegt die Datei auf einem anderen Branch, liest der Chat diesen Branch.
Im Chat reviewen an einem Pull Request oder Diff: Die KI liest den Branch und schreibt ein Review nach Schwere, mit Pfad und Zeile. Sie ändert nichts, solange du nicht darum bittest.
Chat auf diesem Branch (Reiter Branches): Der Chat liest diesen Branch statt des Ziel-Branches. Änderungen der KI landen auf einem eigenen Branch ai/…, der davon abzweigt; Mit … abgleichen und der Pull Request beziehen sich auf den gewählten Branch.

Die Seite holt den Stand vom Git-Server höchstens einmal pro Minute; Aktualisieren holt ihn sofort.

Was die KI sehen kann

Git-Repositories: lesen, suchen, Dateien finden (z. B. src/**/test_*.py), Historie und Commits ansehen.
Datenbanken: Tabellen auflisten und beschreiben, lesende SQL-Abfragen. Schreiben ist technisch ausgeschlossen.
Dateien zur Analyse: hochgeladene Tabellen abfragen.
Abgeglichene Ordner: Dokumente von deinem Rechner durchsuchen und lesen, Stand des letzten Abgleichs.
MCP-Dienste: Werkzeuge angebundener Dienste, sofern der Workspace sie freigeschaltet hat.
Gedächtnis: Ist ein Gedächtnis (Munin) angebunden, kann sich die KI Dinge über Chats hinweg merken. Unter Gedächtnis sehen alle Mitglieder die Einträge; löschen können nur Workspace-Admins.

Die KI sieht nichts außerhalb des Workspace, kein Internet und keine anderen Workspaces. Code ausführen (Tests, Builds) kann sie nicht.

Dateien analysieren

Unter Daten → Dateien zur Analyse eine Datei hochladen: CSV, TSV, JSON, JSON Lines oder Parquet.
Jede Datei wird zu einer Tabelle, die die KI abfragen kann.
Im Chat fragen, z. B. „Welche fünf Kunden hatten 2025 den höchsten Umsatz?“

Ergebnisse erscheinen unter der Antwort als Tabelle mit Als CSV herunterladen. Passen sie dazu (eine Beschriftung, bis zu drei Zahlenspalten, höchstens 40 Zeilen), zeigt die Plattform zusätzlich ein Balken- oder Liniendiagramm. Lange Ergebnisse werden gekürzt angezeigt; für vollständige Auswertungen die KI aggregieren lassen.

Speicherkontingent: Dateien zählen gegen das Kontingent des Workspace (Standard 500 MB). Die Seite Daten zeigt die Belegung und warnt ab 80 %. Ist es voll, wird ein Upload abgelehnt; dann alte Dateien löschen oder einen Plattform-Admin um mehr Platz bitten.

Ordner abgleichen

Für Dokumente auf deinem Rechner, die sich regelmäßig ändern (Projektunterlagen, Protokolle, Spezifikationen).

Unter Daten → Abgeglichene Ordner → Ordner verbinden einen Namen und die Sichtbarkeit wählen.
Auf der Seite des Ordners Ordner wählen … und den Ordner auf deinem Rechner auswählen. Bifröst lädt alle passenden Dateien hoch, auch aus Unterordnern.
Später Jetzt abgleichen: Hochgeladen wird nur, was neu ist oder sich geändert hat; was im Ordner fehlt, wird in Bifröst entfernt.

Formate: Textdateien (Markdown, TXT, CSV, JSON, YAML, HTML …) liest Bifröst selbst. Office-Dateien, PDF und Bilder liest der zentrale Dokumentendienst aus; das dauert einen Moment („wird ausgelesen“). Versteckte Dateien und Office-Sperrdateien (~$…) bleiben außen vor. Gespeichert wird nur der ausgelesene Text; er zählt aufs Speicherkontingent.

Sichtbarkeit:

Nur ich: Die KI nutzt den Ordner nur in Chats, die du angelegt hast, und nur bei deinen Nachrichten. Ihre Antworten stehen aber im Chat, und den sehen alle Mitglieder des Workspace.
Ganzer Workspace: alle Mitglieder in allen Chats. Das bestätigst du beim Anlegen.

Abgleichen kann nur, wer den Ordner verbunden hat. Löschen kann diese Person, bei Workspace-Ordnern auch ein Workspace-Admin; auf deinem Rechner bleibt alles erhalten.

Browser: Chrome und Edge merken sich den Ordner. Dann reicht Jetzt abgleichen, und bei offener Seite gleicht Bifröst beim Laden selbst ab, solange der Browser den Zugriff noch erlaubt. In Firefox und Safari wählst du den Ordner bei jedem Abgleich neu. Automatisch im Hintergrund, ohne offene Seite, gleicht Bifröst nicht ab.

Im Chat z. B.: „Was steht in den Projektunterlagen zur Kündigungsfrist?“ Die KI sucht mit docs_search und liest die passenden Dateien mit docs_read.

Datenbanken abfragen

Ist eine Datenbank verbunden, kann die KI ihre Tabellen ansehen und lesende Abfragen stellen. Jede Abfrage läuft schreibgeschützt, mit Zeit- und Zeilenlimit. Ergebnisse erscheinen wie bei Dateien als Tabelle mit CSV-Download und ggf. Diagramm. Das gilt für jedes Tool, das Spalten und Zeilen liefert.

Je nach Einstellung des Workspace braucht eine Abfrage auf bestimmten Datenbanken eine Freigabe (siehe Wenn eine Freigabe nötig ist).

Code ändern lassen

Jeder Chat hat einen eigenen Git-Branch. Die KI legt Änderungen als Commits darauf ab. Nach außen, also in den Git-Server, gelangen sie erst, wenn du oder ein anderes Mitglied es per Klick auslöst.

Der Ablauf

Auftrag geben: z. B. „Ergänze in der README einen Abschnitt zur Installation.“ Die KI liest die betroffenen Dateien und legt einen Commit an.
Prüfen: Oben im Chat erscheint die Ansicht Änderungen mit Branch, Commits und Diff.
Weiterarbeiten: Weitere Wünsche ergeben weitere Commits auf demselben Branch.
Übertragen: Wenn alles passt, Branch pushen oder Pull Request erstellen.
Review: Kolleginnen und Kollegen prüfen den Pull Request im Git-Server. Kommentare kann die KI einarbeiten.
Abschluss: Nach Merge oder Ablehnung ist der Branch geschlossen. Der nächste Commit im selben Chat beginnt einen neuen Branch (Name mit -2).

Der Branch heißt ai/c<Chat-Nummer>-<Titel> und beginnt beim ersten Commit auf dem aktuellen Stand des Ziel-Branches (meist main).

Die Ansicht „Änderungen“

Badges neben dem Branch-Namen:

Badge	Bedeutung
nur in der Plattform	Noch nichts gepusht
gepusht	Der Branch liegt im Git-Server
PR #12 Entwurf / offen	Es gibt einen Pull Request
neue Commits nicht übertragen	Seit dem letzten Push sind Commits hinzugekommen
main ist weiter	Der Ziel-Branch hat neue Commits, die im Branch fehlen
Konflikt mit main	Der Branch lässt sich nicht konfliktfrei mit dem Ziel-Branch zusammenführen
Syntaxwarnung im letzten Commit	Die Syntaxprüfung hat etwas gefunden (Details bei den Commits)
gemergt / abgelehnt	Der Pull Request ist abgeschlossen
im Git-Server gelöscht	Der abgeschlossene Branch wurde im Git-Server aufgeräumt; hier bleibt er sichtbar
Branch im Git-Server behalten	Auf dem Branch liegen Commits von außen; er wurde deshalb nicht gelöscht

Knöpfe:

Branch pushen: überträgt den Branch in den Git-Server, z. B. um lokal oder in der CI zu testen.
Pull Request erstellen: pusht und legt den Pull Request an. Titel und Beschreibung lassen sich anpassen; Commits, Plan, Autor und ein Link zum Chat werden angehängt. Standardmäßig entsteht ein Entwurf.
Als bereit markieren: macht aus dem Entwurf einen regulären Pull Request.
Änderungen übertragen: Gibt es schon einen Pull Request, gehen neue Commits erst mit diesem Klick hinein.
Mit main abgleichen: übernimmt neue Commits des Ziel-Branches (siehe unten).
Status aktualisieren: fragt den Stand des Pull Requests sofort ab (sonst automatisch alle 5 Minuten).
Kommentare einarbeiten: startet eine Antwort, in der die KI die Review-Kommentare liest und neue Commits anlegt.
Letzten Commit zurücknehmen: unter Commits und Diff, nur für noch nicht übertragene Commits.

Gepusht wird nie mit Überschreiben. Hat jemand von außen auf den Branch gepusht, bricht der Push mit einer Meldung ab.

Mit main abgleichen

Läuft der Ziel-Branch weiter, holt Mit main abgleichen die neuen Commits per Merge-Commit in den Chat-Branch. Bereits übertragene Commits bleiben gültig, und der Diff zeigt weiter nur eure eigenen Änderungen.

Gibt es Konflikte, passiert beim Klick nichts. Dann Konflikte von der KI lösen lassen: Die KI führt die Branches zusammen, löst die Konflikte Datei für Datei und legt einen Merge-Commit an. Prüfe das Ergebnis im Diff, bevor du es überträgst.

Projektregeln (AGENTS.md)

Liegt im Repository eine Datei AGENTS.md, befolgt die KI die darin beschriebenen Konventionen: Code-Stil, Struktur, Benennung, Commit-Nachrichten. Ändert die KI die Datei selbst im Chat, gilt ab der nächsten Antwort der neue Stand. Die Regeln können keine Rechte erweitern.

Regeln, Skills und Befehle aus Hugin

Hat dein Workspace Pakete aus Hugin, befolgt die KI deren Regeln und nutzt passende Skills. Befehle schlägt das Eingabefeld vor, sobald du / tippst (Pfeiltasten wählen, Tab oder Enter übernimmt); eine Liste steht auch unter dem Eingabefeld (Befehle aus Hugin). Danach zeigt ein Hinweis, welche Argumente noch fehlen. Argumente mit Leerzeichen in Anführungszeichen, z. B. /release-notiz "Version 2" locker. Fehlt ein Argument, sagt Bifröst beim Senden, welches. Im Chat steht deine Eingabe; unter An die KI gesendet siehst du den ausgeschriebenen Text. Unter jeder Antwort steht, welche Paketversionen galten.

Syntaxprüfung

Bei jedem Commit prüft die Plattform Python, JSON, TOML, XML und YAML auf Syntaxfehler, ohne Code auszuführen. Ein Fehler ist nur eine Warnung: Der Commit entsteht trotzdem, die KI bekommt die Warnung und soll sie mit einem weiteren Commit beheben.

Größere Aufgaben

Plan

Bei größeren Aufgaben legt die KI einen Plan aus Schritten an und hält ihn aktuell (offen, in Arbeit, erledigt). Er steht oben im Chat und geht auch in die Beschreibung des Pull Requests ein.

Planungsmodus

Der Knopf Erst planen am Eingabefeld (bei vorhandenem Plan: Plan überarbeiten) schaltet den Planungsmodus ein:

Die KI untersucht die Aufgabe und legt einen Plan an, ändert aber nichts.
Du kannst Rückfragen stellen und den Plan anpassen lassen.
Plan umsetzen an der Plan-Karte beendet den Modus und startet die Umsetzung.
Ein Klick auf Planungsmodus an schaltet ohne Umsetzung zurück.

Du kannst beliebig oft zwischen Planen und Umsetzen wechseln. Der Plan bleibt dabei erhalten.

Weiterarbeiten

Eine Antwort darf eine begrenzte Zahl an Tool-Schritten nutzen (Standard 12, im Workspace einstellbar). Ist das Limit erreicht, fasst die KI den Stand zusammen, und unter der Antwort erscheint Weiterarbeiten. Die KI setzt dann beim nächsten offenen Punkt an.

Lange Chats und Arbeitsnotiz

Lange Chats passen irgendwann nicht mehr vollständig ins Kontextfenster des Modells. Die Plattform kürzt dann ältere Tool-Ausgaben und fasst frühere Nachrichten in einer Arbeitsnotiz zusammen (Ziel, Entscheidungen, Commits, offene Punkte). Die Notiz lässt sich oben im Chat aufklappen. Details kann die KI jederzeit neu nachlesen.

Wenn eine Freigabe nötig ist

Manche Tools brauchen eine Freigabe, z. B. Abfragen auf einer Produktionsdatenbank oder schreibende Aktionen in angebundenen Diensten. Dann:

Die Antwort zeigt Wartet auf Freigabe. Du kannst die Seite schließen.
Berechtigte Personen (Workspace-Admins, Freigeber oder globale Approver) werden benachrichtigt und entscheiden.
Nach der Freigabe läuft die Antwort automatisch weiter. Bei Ablehnung bekommt die KI den Kommentar und antwortet entsprechend.

Anträge laufen nach 24 Stunden ab und lassen sich dann erneut beantragen. Den Stand siehst du unter Freigaben.

Für Code-Änderungen gibt es keine Freigabe in der Plattform. Geprüft wird im Review des Pull Requests.

Benachrichtigungen

Du bekommst eine E-Mail, wenn:

ein Antrag, den du ausgelöst hast, entschieden wurde,
ein Pull Request aus deinem Chat neue Kommentare hat, gemergt oder abgelehnt wurde,
als Freigeber oder Admin: ein Antrag auf deine Entscheidung wartet.

Voraussetzung ist eine E-Mail-Adresse im Profil. Dort lassen sich Benachrichtigungen auch abbestellen.

17 KiB Raw Blame History