bifroest/app/help/pages/start.md

Überblick

Bifröst ist der AI Workspace: eine KI-Arbeitsplattform für Teams. Der Name kommt von der Brücke zwischen den Welten in der nordischen Mythologie. Bifröst verbindet eure Daten, die KI und die Menschen, die über jeden Schritt nach außen entscheiden. Dazu gehören Hugin (Design der Oberfläche) und Munin (Gedächtnis). Jeder Workspace bündelt Daten (Git-Repositories, Datenbanken, Dateien, angebundene Dienste) und Chats. Die KI arbeitet nur mit dem, was im Workspace freigeschaltet ist, und alles, was sie tut, ist nachvollziehbar.

Grundprinzipien

• Workspace als Rahmen: Die KI sieht nur die Quellen, Dateien und Dienste dieses Workspace. Mitglieder anderer Workspaces sehen nichts davon.
• Werkzeuge statt freier Zugriff: Die KI liest und handelt über Tools (z. B. Datei lesen, Datenbank abfragen, Commit anlegen). Jedes Tool ist zentral eingestuft: erlaubt, Freigabe nötig oder gesperrt.
• Nach außen nur durch Menschen: Code-Änderungen legt die KI als Commits in der Plattform ab. Pushen, Pull Requests erstellen und Änderungen übertragen kann nur ein Mensch per Klick.
• Freigaben, wo nötig: Braucht ein Tool eine Freigabe, pausiert die Antwort, bis ein berechtigter Mensch entschieden hat.
• Nachvollziehbar: Antworten, Tool-Aufrufe, Freigaben und Einstellungen landen im Audit-Log; Verbrauch und Kosten werden je Modellaufruf erfasst.

Rollen

Rolle	Was sie darf	Anleitung
Mitglied	Chatten, Dateien hochladen, Code-Änderungen pushen und Pull Requests erstellen	Für Nutzer
Freigeber	Zusätzlich Freigabeanträge des Workspace entscheiden	Für Freigeber und Prüfer
Workspace-Admin	Alles im Workspace: Mitglieder, Datenquellen, Tools und Regeln, Einstellungen, Freigaben	Für Workspace-Admins
Globaler Approver	Anträge der Stufe globaler Approver entscheiden, auch ohne Mitglied zu sein	Für Freigeber und Prüfer
Plattform-Admin	Teams, Nutzer, Modelle, Tool-Einstufung, MCP-Server, Übersicht über alle Workspaces	Für Plattform-Admins

Eine Person kann mehrere Rollen haben, z. B. Mitglied in einem und Admin in einem anderen Workspace.

Erste Schritte

Als Nutzer:

1. Mit dem Einmal-Passwort anmelden und ein eigenes Passwort setzen.
2. Unter Workspaces einen Workspace öffnen und einen neuen Chat beginnen.
3. Eine Frage stellen, z. B. „Wo wird die Anmeldung geprüft?“ oder „Fasse die Umsätze je Monat aus umsatz.csv zusammen“.

Mehr dazu: Für Nutzer.

Als Workspace-Admin:

1. Unter Workspaces → Workspace anlegen einen Workspace für dein Team anlegen; du wirst automatisch Admin.
2. Unter Daten ein Git-Repository verbinden und testen oder Dateien hochladen; Datenbanken unter Einstellungen → MCP-Server.
3. Unter Einstellungen → Mitglieder Kolleginnen und Kollegen hinzufügen.

Mehr dazu: Für Workspace-Admins.

Als Plattform-Admin (einmalig):

1. Unter Modelle und Zugänge einen Endpunkt, einen API-Key und ein Modell anlegen.
2. Unter Tools die Tools einstufen (Vorschläge übernehmen); bis dahin sind sie gesperrt.
3. Unter Teams und Nutzer Teams und Konten anlegen.

Mehr dazu: Für Plattform-Admins.

Wo finde ich was?

• Seitenleiste links: Workspaces, Freigaben (mit Zähler offener Anträge), für Plattform-Admins die Administration. In einem Workspace zusätzlich Übersicht, Daten, ggf. Gedächtnis, für Admins Einstellungen, Nutzung und Kosten, Runs, Audit-Log sowie die letzten Chats.
• Leiste oben: links der Knopf zum Ein- und Ausblenden der Seitenleiste (auch Strg+B bzw. Cmd+B; der Zustand bleibt gemerkt), der aktuelle Workspace, Hilfe (führt zur passenden Stelle für die aktuelle Seite), dein Name (Profil, Passwort, Benachrichtigungen), Hell/Dunkel und Abmelden.
• Hilfe durchsuchen: Das Suchfeld links in der Hilfe findet Abschnitte über alle Seiten.