103 lines
5.7 KiB
Markdown
103 lines
5.7 KiB
Markdown
Als Workspace-Admin kümmerst du dich um die Projekte einer ganzen Abteilung:
|
|
Projekte anlegen, Zugänge vergeben und im Blick behalten, ob Munin genutzt
|
|
wird. Einträge schreiben die Teams selbst, über ihre eigenen Keys.
|
|
|
|
## Anmelden
|
|
|
|
Du meldest dich mit deinem Token an (beginnt mit `wa_`), an derselben Stelle
|
|
wie mit einem Key. Danach landest du unter *Projekte → Verwalten…* deines
|
|
Workspace. Das Token bekommst du vom Plattform-Admin; es wird nur einmal
|
|
angezeigt. Geht es verloren oder in falsche Hände, lass es zurückziehen und dir
|
|
ein neues geben.
|
|
|
|
Über MCP kannst du dich mit dem Token nicht verbinden. Willst du selbst mit
|
|
einem Agenten mitarbeiten, leg dir in dem Projekt einen eigenen Key an.
|
|
|
|
## Was du darfst
|
|
|
|
| Darfst du | Darfst du nicht |
|
|
|---|---|
|
|
| Projekte deines Workspace anlegen, umbenennen und löschen | Einträge schreiben, löschen oder importieren |
|
|
| Zugänge aller Projekte dort anlegen und zurückziehen | das Schreibbudget eines Projekts ändern |
|
|
| alle Projekte dort lesen, samt Protokoll und Nutzung | andere Workspaces sehen |
|
|
| in allen Projekten auf einmal suchen | auf die Platte des Servers exportieren |
|
|
| einzelne Projekte oder den ganzen Workspace als ZIP herunterladen | Workspace-Admins anlegen |
|
|
|
|
Warum keine Einträge: Im Protokoll soll eindeutig stehen, welcher Zugang etwas
|
|
geschrieben hat. Mehr dazu unter
|
|
[Zugänge und Sicherheit](/hilfe/zugaenge#workspace-admin).
|
|
|
|
## Ein neues Projekt einrichten
|
|
|
|
1. *Projekte → Verwalten…* → **Neues Projekt**: Bezeichner (dauerhaft, z. B.
|
|
`plattform`), Name und eine kurze Beschreibung. Die Beschreibung steht über
|
|
der Eintragsliste und hilft dem Team, das Projekt richtig zu nutzen.
|
|
2. Ins Projekt wechseln → **Zugänge** → je Mensch und je Agent einen Key
|
|
anlegen (Rollen siehe [Zugänge und Sicherheit](/hilfe/zugaenge#welche-rolle-fuer-wen)).
|
|
Mindestens ein Key mit der Rolle `admin`, damit das Team seine Zugänge
|
|
künftig selbst verwalten kann.
|
|
3. Die Keys sicher weitergeben. Jeder wird genau einmal angezeigt, zusammen mit
|
|
fertigen Konfigurationsblöcken für Claude Code, Cline und OpenCode.
|
|
4. Dem Team den Einstieg zeigen: [Agent anbinden](/hilfe/mcp-einrichten) und
|
|
[Mit Agenten arbeiten](/hilfe/mit-agenten-arbeiten).
|
|
|
|
**Zugänge auf Zeit:** Für Praktika, befristete Projekte oder Tests beim
|
|
Anlegen *Gültig bis* setzen. Danach gilt der Key wie zurückgezogen, ohne dass
|
|
jemand daran denken muss.
|
|
|
|
## Überblick
|
|
|
|
*Überblick* in der Seitenleiste ist deine Startseite für die Pflege: eine
|
|
Seite für den ganzen Workspace.
|
|
|
|
- **Was zu tun ist:** je Projekt, mit einem Link genau dorthin, wo es zu
|
|
erledigen ist. *Rot* ist dringend: Ein Key läuft in den nächsten 14 Tagen
|
|
ab, oder ein Projekt hat gar keinen gültigen Key. *Grün* ist eine Bitte, bei
|
|
Gelegenheit hinzusehen:
|
|
- Kein Key mit der Rolle `admin`: Das Team muss für jeden Zugang dich fragen.
|
|
- Keys seit 90 Tagen nicht benutzt.
|
|
- Ein Projekt, in dem 30 Tage lang niemand geschrieben oder gesucht hat.
|
|
- Viele Suchen ohne Treffer (ab 30 %, wenn es mindestens 10 Suchen gab).
|
|
- Kuratierte Einträge, die ein Agent geändert hat und die auf Prüfung warten.
|
|
- Einträge, die seit über einem Jahr unverändert sind.
|
|
|
|
Ein Hinweis verschwindet von selbst, sobald es erledigt ist.
|
|
- **Projekte:** alle in einer Tabelle — Einträge, Schreibvorgänge von Agenten
|
|
und Menschen, Suchen, Anteil ohne Treffer, letzte Änderung. Der Name führt
|
|
zur *Nutzung* des Projekts mit allen Einzelheiten.
|
|
- **Aktivität der letzten 30 Tage:** Schreibvorgänge und Suchen je Tag für den
|
|
ganzen Workspace. Mit der Maus über einem Tag erscheinen die genauen Zahlen.
|
|
|
|
Technische Werte (Datenbank, Verbindungen, Platz) stehen hier nicht. Die
|
|
betreut der Plattform-Admin.
|
|
|
|
## Weitere Seiten zum Nachsehen
|
|
|
|
| Wo | Was du siehst |
|
|
|---|---|
|
|
| *Projekte → Verwalten…* | alle Projekte mit Eintragszahl und Schreibvorgängen der letzten 30 Tage — „keine“ heißt: Das Team nutzt Munin nicht |
|
|
| **Nutzung** (im Projekt) | ob Agenten vorhandenes Wissen fortschreiben statt Neues daneben zu legen, Suchen ohne Treffer, kuratierte Einträge zur Prüfung, veraltete Einträge |
|
|
| **Protokoll (alle)** | Vorgänge aller Projekte, filterbar nach Vorgang, Zugang, Projekt und Zeitraum |
|
|
| **Suche (alle Projekte)** | Einträge aus allen Projekten auf einmal, nach Projekt gruppiert — „In welchem Projekt stand das nochmal?“ |
|
|
|
|
**Suche in allen Projekten:** Die Treffer stehen je Projekt, die besten fünf,
|
|
das passendste Projekt oben. *Weitere Treffer* führt zur Suche im jeweiligen
|
|
Projekt. Nur du und der Plattform-Admin können so suchen; ein Key und ein Agent
|
|
sehen weiter genau ein Projekt.
|
|
|
|
## Regelmäßig
|
|
|
|
| Wann | Was |
|
|
|---|---|
|
|
| wöchentlich | **Überblick** öffnen. Rote Zeilen gleich erledigen; steht dort „Alles in Ordnung“, ist nichts zu tun. |
|
|
| monatlich | Die grünen Zeilen im **Überblick** durchgehen: ungenutzte Keys zurückziehen, wenn niemand mehr weiß, wofür sie da sind; Einträge *zur Prüfung* und viele Suchen ohne Treffer mit dem Team besprechen; ruhige Projekte klären. |
|
|
| vierteljährlich | Einträge mit *veraltet* (über ein Jahr unverändert): Das Team prüfen lassen, ob sie noch stimmen. Der Link im **Überblick** führt zur gefilterten Liste. |
|
|
| bei Bedarf | Ein Key ist in falsche Hände geraten: sofort **Zurückziehen**, dann im **Protokoll** unter *Wer* den Namen wählen und nachsehen, was damit geschah. |
|
|
|
|
## Ein Projekt löschen
|
|
|
|
*Projekte → Verwalten…* → *Bearbeiten* → **Löschen**. Zur Bestätigung muss der
|
|
Bezeichner eingetippt werden. Alle Einträge, Fassungen und Zugänge des Projekts
|
|
verschwinden; rückgängig machen lässt sich das nur aus einer Sicherung, die
|
|
der Plattform-Admin einspielt. Vorher lohnt sich *Als ZIP herunterladen*: Das
|
|
Archiv passt direkt in den Import eines neuen Projekts.
|