bifroest/app/help/pages/begriffe.md
2026-10-27 08:34:17 +01:00

7.1 KiB

Begriffe

Die wichtigsten Begriffe der Plattform, alphabetisch.

A bis F

Abgleich (mit main): Übernimmt neue Commits des Ziel-Branches per Merge-Commit in den Chat-Branch. Siehe Mit main abgleichen.

Abgleich nötig: Status einer Antwort, wenn unklar ist, ob eine freigegebene Aktion im Zielsystem angekommen ist. Ein Workspace-Admin startet den Abgleich.

Abgeglichener Ordner: Ordner auf dem Rechner einer Person, den Bifröst per Browser abgleicht. Die KI liest den ausgelesenen Text, Stand des letzten Abgleichs. Siehe Ordner abgleichen.

AGENTS.md: Datei im Repository mit Projektregeln (Code-Stil, Struktur, Commit-Nachrichten). Die KI befolgt sie, soweit sie den Regeln der Plattform nicht widersprechen.

AI Gateway: Zentraler Zugang zu den Sprachmodellen mit Budgets und Inhaltsfiltern. Die Plattform spricht die Modelle über einen Endpunkt an.

Antrag: siehe Freigabe.

Arbeitsnotiz: Automatische Zusammenfassung früherer Nachrichten eines langen Chats. Sie geht statt der Nachrichten an die KI und ist oben im Chat einsehbar.

Audit-Log: Protokoll aller wichtigen Ereignisse: wer wann was getan hat. Admins sehen es mit Filtern und CSV-Export.

Beispielfrage: Frage, die ein Workspace-Admin hinterlegt; ein Klick in der Übersicht oder im leeren Chat stellt sie.

Bifröst: Name der Plattform, nach der Brücke zwischen den Welten in der nordischen Mythologie. Dazu gehören Hugin (Design der Oberfläche) und Munin (Gedächtnis).

Branch (Chat-Branch): Git-Branch ai/c<Chat>-<Titel>, den jeder Chat beim ersten Commit bekommt. Er bleibt in der Plattform, bis ein Mensch ihn pusht.

Commit: Eine Änderung an Dateien im Repository. Die KI legt Commits auf den Chat-Branch, ohne Freigabe; sie wirken erst nach außen, wenn ein Mensch sie überträgt.

Diff: Die Darstellung, was sich geändert hat: hinzugefügte Zeilen grün mit +, entfernte rot mit -.

Dokumenten-Auslese: Zentraler MCP-Server, der Office-Dateien, PDF und Bilder aus abgeglichenen Ordnern in Text umwandelt. Richtet ein Plattform-Admin ein.

Entwurf (Draft): Pull Request, der noch nicht zum Review bereit ist. Aus dem Chat erstellte Pull Requests sind standardmäßig Entwürfe; Als bereit markieren ändert das.

Freigabe: Entscheidung eines Menschen, bevor ein Tool-Aufruf ausgeführt wird. Der Antrag zeigt die geprüften Argumente; nach der Freigabe wird genau das ausgeführt.

Freigeber: Rolle im Workspace: darf zusätzlich zum Chatten Freigabeanträge entscheiden.

Freigabestufe: Wer einen Antrag entscheidet: der Workspace (Admins und Freigeber) oder globale Approver.

G bis M

Gedächtnis (Munin): Angebundener Dienst, in dem sich die KI Dinge über Chats hinweg merkt. Die Einträge sind für alle Mitglieder sichtbar.

Globaler Approver: Person, die Anträge der Freigabestufe globaler Approver in allen Workspaces entscheidet.

Guardrail: Inhaltsfilter des AI Gateways. Blockiert er eine Anfrage, endet die Antwort mit Vom AI Gateway blockiert.

Hugin: Register für geprüfte KI-Erweiterungen: Regeln, Skills und Befehle. Ein Workspace schreibt gewählte Versionen fest; Pflichtpakete des Tenants gelten immer.

Kontext, Kontextfenster: Was das Modell bei einer Antwort auf einmal „sieht“: Anweisungen, Verlauf, Tool-Ergebnisse. Das Kontextfenster ist seine Höchstgröße in Tokens. Die Anzeige Kontext x % zeigt die Auslastung.

Konflikt: Chat-Branch und Ziel-Branch haben dieselben Stellen unterschiedlich geändert und lassen sich nicht automatisch zusammenführen. Die KI kann Konflikte lösen.

MCP (Model Context Protocol): Standard, über den externe Dienste der KI Werkzeuge anbieten. MCP-Server registriert der Plattform-Admin; Workspaces schalten sie frei.

Merge-Commit: Commit mit zwei Vorgängern, der zwei Stände zusammenführt. Entsteht beim Abgleich mit main.

Modus B: Freigabemodus eines Workspace, in dem jede Schreibaktion in ein Fremdsystem eine Freigabe braucht.

P bis S

Papierkorb: Gelöschte Workspaces bleiben einige Tage wiederherstellbar, bevor sie endgültig entfernt werden.

Plan: Liste von Schritten, die die KI bei größeren Aufgaben anlegt und abhakt.

Planungsmodus: Modus eines Chats, in dem die KI nur liest und plant, aber nichts ändert. Plan umsetzen beendet ihn.

Pull Request (PR): Anfrage im Git-Server, einen Branch in den Ziel-Branch zu übernehmen. Dort findet das Review statt.

Push, pushen: Commits aus der Plattform in den Git-Server übertragen. Geschieht nur per Klick eines Menschen und nie mit Überschreiben.

Repository (Bereich): Seite eines Workspace mit Git-Repository: neue Commits seit dem letzten Besuch, Branches, Commit-Details und Chats mit Bezug darauf. Sie liest nur.

Quelle (Datenquelle): Git-Repository, das ein Workspace-Admin verbunden hat. Datenbanken sind MCP-Verbindungen (Einstellungen → MCP-Server).

Rückmeldung: 👍 oder 👎 einer Person zu einer Antwort, optional mit Kommentar. Admins werten sie unter Nutzung und Kosten aus.

Risikoklasse: Einordnung eines Tools: read (liest), write_internal (wirkt nur in der Plattform), write_external (wirkt in einem Fremdsystem), destructive (löscht oder schwer umkehrbar).

Run: Eine Antwort der KI als Vorgang im Hintergrund, mit Status (wartet, läuft, wartet auf Freigabe, fertig, fehlgeschlagen …), Tool-Aufrufen und Verbrauch.

Selbstfreigabe: Jemand gibt eine Aktion frei, die er selbst ausgelöst hat. Erlaubt ohne Vier-Augen-Prinzip und im Audit-Log vermerkt.

Snapshot: Prüfsumme eines Freigabeantrags. Sie stellt sicher, dass genau das Geprüfte ausgeführt wird.

Speicherkontingent: Platz für Dateien zur Analyse je Workspace, Standard 500 MB.

Syntaxprüfung: Prüfung von Python, JSON, TOML, XML und YAML bei jedem Commit, ohne Code auszuführen. Fehler sind Warnungen.

T bis Z

Team: Gruppe von Nutzern. Workspaces gehören einem Team; nur seine Mitglieder können hinzugefügt werden.

Token: Recheneinheit der Sprachmodelle, grob ein Wortteil. Verbrauch und Kosten werden in Tokens gemessen.

Tool: Werkzeug, mit dem die KI liest oder handelt, z. B. Datei lesen, Datenbank abfragen, Commit anlegen. Jedes Tool ist eingestuft: erlaubt, Freigabe nötig oder gesperrt.

Tool-Schritt: Eine Runde, in der die KI Tools aufruft und die Ergebnisse auswertet. Eine Antwort hat ein Limit an Tool-Schritten; danach geht es mit Weiterarbeiten weiter.

Übertragen: Neue Commits in den Git-Server bringen, per Branch pushen oder Änderungen übertragen.

Vier-Augen-Prinzip: Die Person, die eine Aktion ausgelöst hat, darf sie nicht selbst freigeben.

Webhook: Adresse eines Teams- oder Slack-Kanals, an die ein Workspace Benachrichtigungen schickt.

Worker: Hintergrundprozess, in dem die Antworten der KI entstehen. Läuft er nicht, bleiben Antworten in wartet.

Workspace: Arbeitsbereich eines Teams mit Mitgliedern, Datenquellen, Dateien, Diensten und Chats. Die KI arbeitet nur im Rahmen des Workspace.

Ziel-Branch: Branch des Repositorys, von dem Chat-Branches ausgehen und in den Pull Requests zielen, meist main.