Einführung · KI-Arbeitsplatz

Gemeinsam sicher mit KI arbeiten

Alles Wichtige auf einer Seite: wie ihr Zugang bekommt, wie OpenCode funktioniert, wie ihr gute Ergebnisse erzielt – und welche Regeln für alle gelten.

1

Zugang einrichten mit Tailscale

Unser KI-Arbeitsplatz ist nicht offen im Internet erreichbar. Tailscale baut eine private, verschlüsselte Verbindung zwischen eurem Gerät und unserem Server auf – wie ein sicherer Tunnel, den nur freigegebene Geräte benutzen dürfen.

  1. Einladung abwarten Philipp lädt euch zu Tailscale ein. Ihr müsst dafür nichts vorbereiten.
  2. Tailscale installieren Ladet die App für euer Gerät herunter: tailscale.com/download (Windows, Mac, iPhone und Android).
  3. Einloggen und Link an Philipp schicken Beim ersten Einloggen zeigt Tailscale einen Link an. Kopiert diesen Link und schickt ihn an Philipp.
  4. Philipp gibt euer Gerät frei Er fügt euer Gerät zu seinen Geräten hinzu. Danach seid ihr verbunden und könnt loslegen.
🔒

Ihr behaltet die Kontrolle, Philipp auch: Freigegebene Geräte kann Philipp jederzeit wieder entfernen, zum Beispiel bei einem verlorenen Laptop oder wenn jemand das Team verlässt.

2

OpenCode – euer KI-Assistent

OpenCode ist die Software, mit der ihr arbeitet. Ihr schreibt in normaler Sprache, was ihr braucht – der KI-Agent liest Dateien, erstellt Dokumente und erledigt Arbeitsschritte für euch.

🧰

Was ist OpenCode?

Fachleute sprechen von einem Harness oder Agenten: eine Arbeitsumgebung rund um das KI-Modell. Das Modell „denkt“, OpenCode gibt ihm Werkzeuge in die Hand – Dateien lesen und schreiben, Tabellen bearbeiten, Befehle ausführen.

☁️

Anbieter

Das eigentliche KI-Modell kommt von einem geprüften und freigegebenen Anbieter. OpenCode ist bereits fertig damit verbunden – ihr braucht kein eigenes Konto und keinen eigenen Schlüssel.

👤

Jeder hat seine eigene Umgebung

Jede Person bekommt ihre eigene OpenCode-Instanz. Eure Sitzungen, Verläufe und Einstellungen bleiben getrennt – niemand arbeitet versehentlich in der Sitzung eines anderen.

📁

Das erste Projekt

Euer erstes Projekt ist der gemeinsame Ordner /home/philipp. Dort liegen die Unterlagen, Vorlagen und Anleitungen, mit denen der Agent arbeitet.

🎓

Skills

Skills sind fertige Anleitungen für wiederkehrende Aufgaben, zum Beispiel für die Kalkulation oder ein Konzept. Der Agent schlägt sie selbst nach, sobald eine Aufgabe passt – so arbeitet er jedes Mal nach demselben bewährten Ablauf.

⚡

Commands

Commands sind Abkürzungen für häufige Aufträge. Tippt im Eingabefeld / und wählt einen Befehl aus der Liste – statt jedes Mal eine lange Anweisung zu schreiben.

📤

Ergebnisse in SharePoint: Was der Agent erstellt, wird nach SharePoint übertragen. Dort könnt ihr alle Ergebnisse wie gewohnt öffnen, prüfen und weitergeben.

3

Prompting – gute Aufträge formulieren

Ein „Prompt“ ist einfach eure Nachricht an die KI. Stellt euch vor, ihr gebt einer neuen, sehr fleißigen Kollegin einen Auftrag: Je klarer der Auftrag, desto besser das Ergebnis.

🎯

Ziel nennen

Was genau soll am Ende herauskommen? Eine Mail, eine Tabelle, eine Zusammenfassung?

📎

Unterlagen angeben

Nennt die Dateien oder Ordner, mit denen gearbeitet werden soll. Ohne Hinweis muss der Agent raten.

📐

Form beschreiben

Länge, Tonfall, Gliederung, Dateiformat – oder einfach eine Vorlage, an der er sich orientieren soll.

🪜

Schritt für Schritt

Große Aufgaben lieber in Etappen aufteilen. Prüft das Zwischenergebnis und gebt dann den nächsten Auftrag.

✗ Zu ungenau

„Schreib was zur Ausschreibung.“

✓ Klar und vollständig

„Lies die Leistungsbeschreibung im Ordner ‚Ausschreibung Schule‘ und schreib eine kurze Mail an die Vergabestelle mit der Bitte um einen Besichtigungstermin. Freundlich, maximal 8 Sätze.“

💬

Nachfragen ist erlaubt: Wenn das Ergebnis nicht passt, sagt einfach, was anders sein soll („kürzer“, „förmlicher“, „nur die Tabelle“). Ihr müsst nicht von vorn anfangen.

4

Kontext – das Gedächtnis der KI

Alles, was in einer Sitzung passiert – eure Nachrichten, gelesene Dateien, Antworten – merkt sich die KI als „Kontext“. Dieses Gedächtnis ist begrenzt: Wird es zu voll, arbeitet die KI langsamer, teurer und ungenauer.

Ab ca. 150.000 Tokens: neue Sitzung starten

Tokens sind Textbausteine – grob ein Token pro Wortteil. OpenCode zeigt euch an, wie voll der Kontext ist. Ab etwa 150K ist es am besten, eine neue Sitzung zu beginnen und kurz zusammenzufassen, wo ihr steht.

Unteragenten nutzen

Für Nebenaufgaben – etwa „durchsuche alle Unterlagen nach Fristen“ – kann der Agent Unteragenten losschicken. Diese arbeiten mit eigenem Gedächtnis und liefern nur das Ergebnis zurück. So bleibt eure Hauptsitzung schlank und übersichtlich.

Empfohlene Einstellungen

HauptmodellAstra-6.1 oder Astra-6.2
UnteragentenSol-6.1 · Stufe high
Zwischenspeicher (Cache)30 Minuten · Ziel: 12 Stunden

Der Cache sorgt dafür, dass bereits gelesene Inhalte nicht jedes Mal neu verarbeitet werden müssen – das spart Zeit und Kosten. Aktuell hält er 30 Minuten; wir versuchen, ihn auf 12 Stunden zu verlängern. Bis dahin gilt: Wer länger als eine halbe Stunde Pause macht, startet beim Weiterarbeiten etwas langsamer.

§

Datenschutz (DSGVO)

Auch beim Arbeiten mit KI gelten die üblichen Datenschutzpflichten. Das Wichtigste in Kürze:

  • Verzeichnis der Verarbeitungstätigkeiten ergänzen: Der Einsatz von KI wird dort als eigene Verarbeitung eingetragen.
  • Personenbezogene Daten prüfen: Sollen personenbezogene Daten verarbeitet werden, wird vorab geprüft, ob eine Datenschutz-Folgenabschätzung nötig ist.
  • KI-Kompetenz nach EU AI Act: Mit dieser Schulung erhaltet ihr die vorgeschriebene KI-Kompetenz nach Art. 4 der EU-KI-Verordnung.
!

Regeln für alle Mitarbeitenden

Diese sieben Regeln schützen euch, das Unternehmen und unsere Kunden. Bitte haltet euch immer daran.

  1. Nur die freigegebene OpenCode-Instanz nutzen.Keine privaten KI-Konten wie ChatGPT oder ähnliche Dienste für Firmenarbeit.
  2. Keine Zugangsdaten eingeben.Keine Passwörter, Schlüssel, Tokens oder Inhalte von .env-Dateien.
  3. Kunden- und Personendaten nur mit Freigabe.Gebt solche Daten nur ein, wenn sie ausdrücklich freigegeben sind.
  4. Ergebnisse immer durch Menschen prüfen.Die KI kann sich irren. Lest, testet und kontrolliert alles, bevor es weitergeht.
  5. Fremde Inhalte nicht ungeprüft verarbeiten lassen.Fremde Dateien, Webseiten oder Repos können versteckte Anweisungen an die KI enthalten (sogenannte „Prompt Injection“).
  6. Nichts selbst nachinstallieren.Keine eigenen Plugins, MCP-Server oder Erweiterungen.
  7. Auffälligkeiten sofort melden.Wenn ihr versehentlich sensible Daten eingegeben habt oder der Agent sich seltsam verhält: sofort Bescheid geben. Das ist kein Fehler, für den man sich schämen muss – schnell melden hilft am meisten.