KI-Agenten, die Ihren Workspace verstehen

Die meisten KI-Integrationen sind angeflanscht. Eine Chat-Sidebar. Ein Textverbesserer. Ein Copilot ohne Kontext.

Das Agentensystem von Aipokit ist anders aufgebaut. Agenten sind Workspace-Bürger mit Rang — sie verstehen Ordner-Typen, lesen und schreiben Dateien und erstellen Inhalte, die Smart Folders direkt ausliefern.

Agenten als Code

Jeder Agent ist eine Markdown-Datei mit YAML-Frontmatter:

---
role: content-writer
model: claude-sonnet-4.5
tools: [workspace_read_file, workspace_write_file, workspace_list_files, workspace_search]
temperature: 0.7
folder_types: [static-site, course]
autonomy: supervised
---

# Content Writer

Sie erstellen und bearbeiten Inhalte für Websites und Schulungsprogramme.
Lesen Sie bestehende Dateien, um Ton und Struktur zu verstehen, bevor Sie schreiben...

Agenten liegen in einem agent-collection-Ordner im Workspace. Sie sind versioniert, teilbar und portabel.

Sechs Workspace-Tools

Agenten interagieren über ein sicheres Tool-System mit dem Workspace:

• workspace_read_file — beliebige Datei im Workspace lesen
• workspace_write_file — Dateien erstellen oder aktualisieren (mit Pfadvalidierung)
• workspace_list_files — Verzeichnisinhalte auflisten
• workspace_search — Textsuche über Dateien (case-insensitive, max. 50 Ergebnisse)
• folder_structure — Ordner-Typ, Schlüsseldateien und Strukturbeschreibung
• workspace_context — Workspace-Überblick mit Dateiliste und Projektbeschreibung

Jeder Tool-Aufruf wird gegen die Workspace-Wurzel validiert. Kein Zugriff außerhalb der Grenze. Schreiboperationen erfordern expliziten Scope.

Ordner-bewusstes Matching

Der Kern liegt im Zwei-Wege-Matching:

1. Ordner-Typen deklarieren Rollen — ein static-site-Ordner erwartet content-writer und seo-optimizer
2. Agenten deklarieren Ordner-Typen — ein content-writer-Agent versteht static-site und course

Beim Öffnen eines Ordners erscheinen nur kompatible Agenten. Kontext ist automatisch: Ordner-Typ-Beschreibung, ai-instructions.md und Schlüsseldateien des Ordners.

Drei Autonomie-Stufen

• Supervised (Standard) — Der Agent schlägt Dateischreibvorgänge vor. Sie genehmigen oder lehnen jeden in der UI ab.
• Autonomous — Der Agent führt Tool-Aufrufe sofort aus. Für längere Content-Generierung mit Vertrauen in den Agenten.
• Manual — Der Agent schlägt nur Aktionen vor. Sie führen sie selbst aus.

BYOK — Ihre Keys, Ihre Modelle, Ihre Infrastruktur

Eigenen API-Key mitbringen: Anthropic (Claude), OpenAI oder jeden OpenAI-kompatiblen Endpoint inklusive Ollama für lokale Modelle. Keys werden AES-256-GCM auf Ihrem Server verschlüsselt. Keine Daten über die Plattform. Keine plattformseitige KI-Gebühr.

Für air-gapped Deployments läuft Ollama lokal. Das Agentensystem funktioniert identisch — dieselben Tools, dasselbe Streaming, dieselben Autonomie-Kontrollen.

Was das für die Lieferung bedeutet

Das Muster:

1. Agenten definieren für Ihre Content-Typen (Site Writer, Course Planner, SEO Optimizer)
2. Agenten Inhalte erstellen lassen in Workspace-Ordnern
3. Smart Folders rendern als Medienbibliotheken, Schulungsprogramme, Prozessmodelle, Websites
4. Per Zugangscode teilen — Ihr Publikum sieht das fertige Produkt, nicht die KI

KI erstellt den Inhalt. Die Plattform liefert ihn aus. Ihr Publikum besitzt die Umgebung.