Levi AI Agent - Technische Dokumentation

Ein KI-gestützter WordPress-Mitarbeiter, der direkt im Admin-Panel arbeitet. Für Agenturen, Freelancer und Website-Betreiber, die WordPress-Aufgaben beschleunigen wollen.

🚀 Produktübersicht

Was ist Levi?

Levi ist ein KI-gestützter Mitarbeiter für WordPress – inspiriert vom Mohami KI-Agent System, aber nativ in WordPress integriert. Statt eines externen Dashboards erscheint Levi als schwebendes Chat-Widget direkt im WordPress Admin-Panel.

Das Besondere: Levi versteht natürliche Sprache und kann komplexe WordPress-Aufgaben eigenständig ausführen – von Content-Erstellung über Plugin-Installation bis hin zur Code-Entwicklung.

Für wen ist Levi gedacht?

Zielgruppe	Anwendungsfälle
WordPress-Agenturen	Schnelle Umsetzung von Kundenwünschen, Bulk-Operationen
Freelancer	Effizientere WordPress-Wartung, mehr Kunden pro Tag
Website-Betreiber	Content-Management ohne technisches Know-how
WooCommerce-Shops	Produktdaten pflegen, Gutscheine erstellen
Entwickler	Plugin/Theme-Entwicklung direkt im Chat

✨ Hauptfunktionen

1. Natürlichsprachliche Steuerung

Statt durch Menüs zu navigieren, beschreibst du Levi einfach, was du willst:

"Erstelle einen neuen Blogpost über WordPress-Sicherheit mit 5 Tipps"

"Installiere das Yoast SEO Plugin und aktiviere es"

"Ändere den Titel der Startseite auf 'Willkommen bei uns'"

2. 40+ Integrierte Tools

Levi hat direkten Zugriff auf deine WordPress-Installation über spezialisierte Tools:

Content Management

Posts & Pages erstellen, bearbeiten, löschen
Custom Post Types verwalten
Media Library verwalten
Kategorien & Tags verwalten

Plugin & Theme Verwaltung

Plugins aus dem Repository installieren
Themes wechseln
Plugin-/Theme-Dateien direkt bearbeiten
Plugin-Scaffolds erstellen

WooCommerce Integration

Produkte suchen und aktualisieren
Gutscheine erstellen und verwalten
Bestellungen und Versandzonen anzeigen

System-Administration

Benutzer verwalten (Rollen zuweisen)
WordPress-Einstellungen ändern
Menüs bearbeiten
Cron-Jobs verwalten
Error-Logs lesen

Power-Tools (für Entwickler)

PHP-Code direkt ausführen (Sandboxed)
HTTP-Requests auf eigene Site senden
REST-API-Endpunkte entdecken

3. Multi-Layer Memory-System

Levi "erinnert" sich über vier Ebenen:

Ebene	Was wird gespeichert?	Beispiel
Identity	Persönlichkeit, Regeln	Levi ist freundlich, kommuniziert per "Du"
Reference	Technische Dokumentation	WordPress Codex, WooCommerce Docs
Episodic	Gelernte Präferenzen	"Rin bevorzugt kurze Sätze"
Live	Aktueller WordPress-Zustand	Aktive Plugins, Theme, Einstellungen

4. Mehrere KI-Provider

Wähle deinen bevorzugten KI-Anbieter:

Provider	Modelle	Besonderheit
OpenRouter (Standard)	Kimi K2.5, Claude, GPT-4	Retry-Logik, viele Modelle
OpenAI	GPT-4, GPT-3.5	Native Tool-Unterstützung
Anthropic	Claude 3 Opus/Sonnet	Lange Kontexte

5. Drei Sicherheitsstufen (Tool-Profile)

Profil	Für wen?	Was ist möglich?
Minimal	Anfänger	Nur Lesen und Diagnose
Standard	Empfohlen	Lesen + Schreiben (Content, Einstellungen)
Full	Entwickler	Alle Tools inkl. Code-Ausführung

🏗️ Technische Architektur

Systemanforderungen

Komponente	Minimum	Empfohlen
PHP	8.1	8.2+
WordPress	6.0	6.4+
MySQL/MariaDB	5.7	8.0+
Speicher	64MB	128MB+

Projektstruktur

wp-content/plugins/levi-agent/
│
├── wp-levi-agent.php           # Haupt-Plugin-Datei
├── composer.json               # PHP-Dependencies (PSR-4)
│
├── identity/                   # Agent-Identität
│   ├── soul.md                 # Persönlichkeit
│   ├── rules.md                # Verhaltensregeln
│   └── knowledge.md            # Domänenwissen
│
├── memories/                   # Referenz-Wissen
│   ├── wordpress-lllm-developer.txt
│   ├── woocommerce-lllm-developer.txt
│   └── elementor-llm-developer.txt
│
├── src/
│   ├── Core/Plugin.php         # Haupt-Plugin-Klasse
│   ├── Admin/                  # Admin-Interface
│   │   ├── ChatWidget.php
│   │   ├── SettingsPage.php
│   │   └── SetupWizardPage.php
│   ├── API/ChatController.php  # REST API Endpoints
│   ├── AI/                     # KI-Integration
│   │   ├── AIClientFactory.php
│   │   ├── AnthropicClient.php
│   │   ├── OpenAIClient.php
│   │   ├── OpenRouterClient.php
│   │   └── Tools/              # 40+ Tool-Implementierungen
│   │       └── Registry.php
│   ├── Database/               # Datenbank-Layer
│   ├── Memory/                 # Gedächtnis-System
│   └── Agent/Identity.php      # Agent-Identität
│
├── assets/
│   ├── css/                    # Stylesheets (Dark Mode)
│   └── js/                     # Chat-Widget JavaScript
│
└── templates/                  # PHP-Templates

Datenbank-Tabellen

Tabelle	Zweck
`wp_levi_conversations`	Chat-Verläufe
`wp_levi_vectors`	Vektor-Embeddings (semantische Suche)
`wp_levi_vector_files`	Geladene Memory-Dateien (Hash-Tracking)
`wp_levi_episodic_memories`	Gelernte Benutzerpräferenzen
`wp_levi_state_snapshots`	Tägliche WordPress-Zustandssicherungen

REST API Endpoints

Methode	Endpoint	Beschreibung
POST	`/wp-json/levi-agent/v1/chat`	Nachricht senden (Classic)
POST	`/wp-json/levi-agent/v1/chat/stream`	Nachricht senden (Streaming)
GET	`/wp-json/levi-agent/v1/chat/{session}/history`	Verlauf laden
POST	`/wp-json/levi-agent/v1/chat/upload`	Dateien hochladen
DELETE	`/wp-json/levi-agent/v1/chat/{session}`	Session löschen

Kommunikations-Architektur

┌─────────────────────────────────────────────────────────────┐
│  User Input (natürliche Sprache)                            │
└─────────────────────┬───────────────────────────────────────┘
                      │
                      ▼
┌─────────────────────────────────────────────────────────────┐
│  SYSTEM PROMPT                                              │
│  ├── Identity (soul.md, rules.md, knowledge.md)             │
│  ├── Reference Memories (WordPress-Doku, WooCommerce-Doku)  │
│  ├── State Snapshot (aktive Plugins, Theme, WP-Version)     │
│  └── User Context (Name, Rolle, aktuelle Seite)             │
└─────────────────────┬───────────────────────────────────────┘
                      │
                      ▼
┌─────────────────────────────────────────────────────────────┐
│  AI Provider (OpenRouter / OpenAI / Anthropic)              │
│  └── LLM entscheidet: Welches Tool wird benötigt?           │
└─────────────────────┬───────────────────────────────────────┘
                      │
                      ▼
┌─────────────────────────────────────────────────────────────┐
│  Tool Execution                                             │
│  └── Direkte WordPress-API-Nutzung                          │
└─────────────────────┬───────────────────────────────────────┘
                      │
                      ▼
┌─────────────────────────────────────────────────────────────┐
│  Response → User                                            │
└─────────────────────────────────────────────────────────────┘

✅ Was Levi kann - Detaillierte Übersicht

Content Management

Aufgabe	Beispiel-Befehl
Blogpost erstellen	"Erstelle einen Post über WordPress-Sicherheit"
Post aktualisieren	"Ändere den Titel von Post #123 auf 'Neuer Titel'"
Seite erstellen	"Erstelle eine neue Seite 'Über uns'"
Featured Image setzen	"Setze das Featured Image für die Startseite"
Kategorien verwalten	"Erstelle eine neue Kategorie 'Tutorials'"

Plugin-Verwaltung

Aufgabe	Beispiel-Befehl
Plugin installieren	"Installiere WooCommerce"
Plugins auflisten	"Welche Plugins sind aktiviert?"
Plugin-Datei lesen	"Zeige mir die main.php von WooCommerce"
Plugin entwickeln	"Erstelle ein Plugin 'Mein Plugin' mit einer Admin-Seite"

Theme-Entwicklung

Aufgabe	Beispiel-Befehl
Theme wechseln	"Aktiviere das Twenty Twenty-Four Theme"
Theme-Datei bearbeiten	"Füge zur functions.php eine Custom-Post-Type Registrierung hinzu"
Template erstellen	"Erstelle ein Template für eine Landingpage"

WooCommerce

Aufgabe	Beispiel-Befehl
Produktdaten anzeigen	"Zeige mir Produkt #456"
Preis ändern	"Setze den Preis von 'T-Shirt' auf 29,99€"
Gutschein erstellen	"Erstelle einen Gutschein SUMMER2024 mit 20% Rabatt"
Bestellungen anzeigen	"Zeige mir die letzten 10 Bestellungen"

System-Administration

Aufgabe	Beispiel-Befehl
Benutzer erstellen	"Erstelle einen neuen Benutzer 'max' mit Rolle Editor"
Einstellungen ändern	"Ändere den Seitentitel auf 'Meine Firma'"
Menü bearbeiten	"Füge zum Hauptmenü einen Link 'Kontakt' hinzu"
Error-Log lesen	"Zeige mir die letzten PHP-Fehler"

Entwickler-Funktionen (Full Profile)

Aufgabe	Beispiel-Befehl
PHP-Code ausführen	"Führe aus: echo get_bloginfo('version');"
REST-API testen	"Rufe die REST-API für Posts ab"
Plugin-Code debuggen	"Prüfe plugin.php auf Syntax-Fehler"

❌ Was Levi NICHT kann - Limitationen

Sicherheitsbedingte Limitationen

Limitation	Begründung
Keine externen HTTP-Requests	`HttpFetchTool` erlaubt nur Same-Site Requests
Keine Shell-Ausführung	`exec()`, `shell_exec()`, `system()` sind blockiert
Keine Plugin-Deinstallation	Plugins können installiert werden, aber nicht vollständig gelöscht
Keine User-Löschung	Benutzer können erstellt, aber nicht gelöscht werden
Keine WordPress-Core-Updates	Keine automatischen WP-Version-Updates

Funktionale Limitationen

Limitation	Details
Keine neuen WooCommerce-Produkte	Nur bestehende Produkte können aktualisiert werden
Keine Bestellstatus-Änderungen	Bestellungen sind nur lesbar
Keine direkten SQL-Queries	Datenbank nur über WordPress-API
Keine Multisite-Operationen	Keine site-übergreifenden Aktionen
Keine API-Key-Änderungen	AI-Provider-Keys nicht über Chat änderbar

Technische Grenzen

Limitation	Grenzwert
Max. Dateigröße (Upload)	5MB pro Datei
Max. Tool-Iterationen	12 Runden pro Anfrage
Rate Limit	50 Anfragen/Stunde (konfigurierbar)
PHP-Code Timeout	30 Sekunden
Max. Output (Code-Ausführung)	50KB

🎨 Benutzeroberfläche

Chat-Widget

Das Chat-Widget erscheint als schwebendes Element im WordPress Admin:

Position: Fixed, unten rechts (bottom: 30px; right: 30px) Design: Dark Mode mit blauen Akzenten (#2563eb) Z-Index: 999999 (immer oben)

┌─────────────────────────────────────────────┐
│ 🤖 Levi Assistant [ALPHA]    [↗] [🗑] [×]  │  ← Header
├─────────────────────────────────────────────┤
│                                             │
│  Hallo Rin! 👋                              │
│  Ich bin dein WordPress KI-Assistent...     │  ← Nachrichten
│                                             │
│          [User-Nachricht]                   │
│                                             │
│  [Assistant-Antwort mit Markdown]           │
│                                             │
│  [⏳ Levi schreibt...]                      │  ← Tipp-Indikator
│  ████████░░░░░░░░░░                         │
│                                             │
├─────────────────────────────────────────────┤
│ [📎]  ┌──────────────────┐ [➤]            │  ← Eingabe
│       │  Nachricht...    │                 │
│       └──────────────────┘                 │
└─────────────────────────────────────────────┘

Features:

Markdown-Rendering mit Syntax-Highlighting
Datei-Upload (Text, Bilder, Code)
Vollbild-Modus
Session-Management
Editieren gesendeter Nachrichten

Einstellungsseite

Fünf Tabs mit umfassenden Konfigurationsmöglichkeiten:

General - Übersicht, Quick Start, Memory-Status
AI Provider - API-Keys, Modell-Auswahl
Memory - Vector-Memory-Einstellungen
Safety - Limits, Tool-Profile, Datenschutz
Advanced - Datenbank-Wartung, System-Info

Setup-Assistent

Vier-Schritt-Einrichtung für neue Nutzer:

Willkommen - Produktvorstellung
API-Key - OpenRouter-Key eingeben
Tuning - Tool-Profil, Gründlichkeit, Sicherheitsmodus wählen
Abschluss - Initial-Snapshot erstellen

🧠 Memory-System im Detail

Vier Ebenen des Gedächtnisses

┌─────────────────────────────────────────────────────────────┐
│  TIER 1: IDENTITY                                           │
│  Dateien: soul.md, rules.md, knowledge.md                   │
│  ─────────────────────────────────────────────             │
│  • Wer ist Levi (Persönlichkeit)                            │
│  • Wie kommuniziert er (Du/Sie, Stil)                       │
│  • Welche Regeln befolgt er (Safety-First)                  │
└─────────────────────────────────────────────────────────────┘
                              │
                              ▼
┌─────────────────────────────────────────────────────────────┐
│  TIER 2: REFERENCE                                          │
│  Dateien: memories/*.txt                                    │
│  ─────────────────────────────────────────────             │
│  • WordPress-Entwickler-Doku                                │
│  • WooCommerce-Doku                                         │
│  • Elementor-Doku                                           │
│  (Wird in Vektoren gespeichert für semantische Suche)       │
└─────────────────────────────────────────────────────────────┘
                              │
                              ▼
┌─────────────────────────────────────────────────────────────┐
│  TIER 3: EPISODIC                                           │
│  Datenbank: wp_levi_episodic_memories                       │
│  ─────────────────────────────────────────────             │
│  • Gelernte Präferenzen ("Rin mag kurze Sätze")             │
│  • Wichtige Entscheidungen                                  │
│  • Projektspezifische Details                               │
└─────────────────────────────────────────────────────────────┘
                              │
                              ▼
┌─────────────────────────────────────────────────────────────┐
│  TIER 4: LIVE (State Snapshots)                             │
│  Datenbank: wp_levi_state_snapshots                         │
│  ─────────────────────────────────────────────             │
│  • Aktive Plugins & Versionen                               │
│  • Aktives Theme                                            │
│  • WordPress-Version                                        │
│  • Wichtige Einstellungen                                   │
│  (Wird täglich um 00:07 Uhr aktualisiert)                   │
└─────────────────────────────────────────────────────────────┘

Technische Spezifikation

Aspekt	Details
Datenbank	SQLite3 (`vector-memory.sqlite`)
Embedding-Modell	text-embedding-3-small
Embedding-Dimensionen	1536
Chunk-Größe	500 Wörter
Chunk-Überlappung	50 Wörter
Ähnlichkeitsmetrik	Cosine Similarity
Min. Ähnlichkeit (Identity/Reference)	0.7
Min. Ähnlichkeit (Episodic)	0.75

🔐 Sicherheitsfeatures

WordPress-Standard-Sicherheit

Capability-Checks - Jedes Tool prüft WordPress-Berechtigungen
Nonce-Verifizierung - Alle AJAX/REST-Calls mit WordPress Nonces
Rate Limiting - Konfigurierbare Limits pro Benutzer/Stunde

Datenschutz

PII-Redaktion - Automatische Maskierung von E-Mails, Telefonnummern, IBANs
Kein Langzeit-Chat-Gedächtnis - Sessions sind temporär
Lokale Datenverarbeitung - SQLite-Datenbank bleibt auf dem Server

Code-Sicherheit

PHP-Lint-Check - Automatische Syntax-Prüfung bei Datei-Operationen
Rollback bei Fehlern - Automatisches Zurücksetzen bei Syntax-Fehlern
Path-Traversal-Schutz - Kein Zugriff außerhalb vorgesehener Verzeichnisse
Sandboxed Execution - Code läuft im WordPress-Kontext ohne Shell-Zugriff

Bestätigungspflichtige Aktionen

Folgende Aktionen erfordern explizite Bestätigung:

Löschen von Posts/Seiten
Löschen von Benutzern
Theme-Wechsel
Kritische Einstellungen (Permalinks)
Passwort-Änderungen

💪 Stärken & Unique Selling Points

1. Native WordPress-Integration

Im Gegensatz zu externen KI-Tools arbeitet Levi direkt im WordPress Admin:

Kein Kontextwechsel nötig
Live-Abfrage von WordPress-Daten
Kein Synchronisieren von Inhalten

2. SQLite-basiertes Memory

Keine externe Datenbank nötig (ChromaDB, Redis)
Funktioniert auf Shared Hosting
Ein Plugin, alles inklusive

3. Markdown-basierte Identität

Persönlichkeit in .md-Dateien definiert
Versionierbar mit Git
Einfach anpassbar ohne Code-Änderungen

4. Umfangreiches Tool-System

Mit 40+ Tools deckt Levi nahezu alle WordPress-Aufgaben ab:

Content-Management
Plugin/Theme-Verwaltung
WooCommerce
System-Administration
Entwickler-Tools

5. Flexible KI-Integration

Unterstützung für 3 Provider (OpenRouter, OpenAI, Anthropic)
Bring Your Own Key (BYOK)
Freemium-Option über OpenRouter Free Tier

6. WordPress-konformes Freemium

Free-Version bleibt dauerhaft nutzbar
Pro-Features erst nach Zahlung freigeschaltet
Konform mit WordPress.org Richtlinien

📅 Roadmap & Zukunft

Aktueller Status

✅ Plugin-Grundstruktur
✅ Chat-Interface
✅ KI-Integration (3 Provider)
✅ Vector Memory System
✅ 40+ Tools (Lesen & Schreiben)
✅ Setup-Assistent

Geplant (Phase 5-8)

Phase	Feature	Status
Phase 5	Schreibende Tools mit Safety-Layer	🔄 Aktiv
Phase 6	Episodic Memory (Lernen von Präferenzen)	⏳ Geplant
Phase 7	UI/UX Polish (Fullscreen, Markdown, Mobile)	⏳ Geplant
Phase 8	Testing & WordPress.org Release	⏳ Geplant

Langfristige Vision

Voice Mode - Spracheingabe/-ausgabe
Image Generation - DALL-E 3 / Stable Diffusion Integration
Collaborative Chat - Mehrere WP-User im selben Chat
Scheduled Tasks - Automatisierung via WP-Cron
Code Execution Sandbox - Containerisierte PHP-Ausführung

🛠️ Installation & Einrichtung

Schnellinstallation

# 1. In WordPress plugins-Verzeichnis
cd wp-content/plugins/

# 2. Repository klonen
git clone <repository-url> levi-agent

# 3. Dependencies installieren
cd levi-agent
composer install

# 4. In WordPress aktivieren
# Plugins → Levi AI Agent → Aktivieren

Alternativ: ZIP-Upload

Repository als ZIP herunterladen
WordPress Admin → Plugins → Installieren → ZIP hochladen
Plugin aktivieren
Setup-Assistent folgen

Ersteinrichtung

Setup-Assistent starten (wird automatisch angezeigt)
API-Key eingeben - OpenRouter API-Key von openrouter.ai/keys
Tool-Profil wählen - Minimal / Standard / Full
Gründlichkeit einstellen - Schnell / Ausgewogen / Sehr gründlich
Levi starten - Initial-Snapshot wird erstellt

💰 Preise & Pläne

Levi Free (€0)

Read-first Modus
Standard-Modell (Llama 3.1 70B Free)
Begrenzte Rate-Limits
Alle Lesen-Tools

Pro Starter (€9-19/Monat)

Alle Standard-Tools
Erweiterte Modelle
Höhere Rate-Limits
Prioritäts-Support

Pro Plus (€29-49/Monat)

Premium-Modelle (Kimi 2.5, Claude Opus)
Alle Tools inkl. Full-Profile
Höchste Rate-Limits
White-Label-Option

📞 Support & Ressourcen

Dokumentation: Diese Datei
Issues: GitHub Issues
Feature Requests: GitHub Discussions

Levi AI Agent - Dein KI-Mitarbeiter für WordPress Version 0.1.0 | Made with ❤️ and 🤖

Name		Name	Last commit message	Last commit date
Latest commit History 114 Commits
.build/levi-agent		.build/levi-agent
assets		assets
docs		docs
identity		identity
languages		languages
memories		memories
scripts		scripts
src		src
templates/admin		templates/admin
tests		tests
.gitignore		.gitignore
CHANGELOG.md		CHANGELOG.md
README.md		README.md
ROADMAP.md		ROADMAP.md
composer.json		composer.json
wp-levi-agent.php		wp-levi-agent.php

Folders and files

Latest commit

History

Repository files navigation

Levi AI Agent - Technische Dokumentation

🚀 Produktübersicht

Was ist Levi?

Für wen ist Levi gedacht?

✨ Hauptfunktionen

1. Natürlichsprachliche Steuerung

2. 40+ Integrierte Tools

3. Multi-Layer Memory-System

4. Mehrere KI-Provider

5. Drei Sicherheitsstufen (Tool-Profile)

🏗️ Technische Architektur

Systemanforderungen

Projektstruktur

Datenbank-Tabellen

REST API Endpoints

Kommunikations-Architektur

✅ Was Levi kann - Detaillierte Übersicht

Content Management

Plugin-Verwaltung

Theme-Entwicklung

WooCommerce

System-Administration

Entwickler-Funktionen (Full Profile)

❌ Was Levi NICHT kann - Limitationen

Sicherheitsbedingte Limitationen

Funktionale Limitationen

Technische Grenzen

🎨 Benutzeroberfläche

Chat-Widget

Einstellungsseite

Setup-Assistent

🧠 Memory-System im Detail

Vier Ebenen des Gedächtnisses

Technische Spezifikation

🔐 Sicherheitsfeatures

WordPress-Standard-Sicherheit

Datenschutz

Code-Sicherheit

Bestätigungspflichtige Aktionen

💪 Stärken & Unique Selling Points

1. Native WordPress-Integration

2. SQLite-basiertes Memory

3. Markdown-basierte Identität

4. Umfangreiches Tool-System

5. Flexible KI-Integration

6. WordPress-konformes Freemium

📅 Roadmap & Zukunft

Aktueller Status

Geplant (Phase 5-8)

Langfristige Vision

🛠️ Installation & Einrichtung

Schnellinstallation

Alternativ: ZIP-Upload

Ersteinrichtung

💰 Preise & Pläne

Levi Free (€0)

Pro Starter (€9-19/Monat)

Pro Plus (€29-49/Monat)

📞 Support & Ressourcen

About

Resources

Uh oh!

Stars

Watchers

Forks

Releases

Packages 0

Uh oh!

Contributors

Uh oh!

Languages

Packages