Extension · moselwal/business-agent

business-agent — ein Chat, der Ihr TYPO3 kennt.

Context-aware Conversational Agent mit RAG-Pipeline auf Ihren TYPO3-Inhalten. Access-Class-Routing (Public, Partner, Internal, Admin) sorgt dafür, dass Antworten passend zur Berechtigung kommen. MCP-Tool-Integration, Conversation-Persistierung, einbettbares Chat-Widget. Komplett Open Source.

Composer-Repo einbinden →

Das Problem

Generische Chatbots wissen nichts über Sie.

Mit business-agent

RAG auf Ihren TYPO3-Inhalten — indexiert, gechunkt, hybrid retrievet
Self-hosted, DSGVO-konform, Vector-DB Ihrer Wahl
Access-Class-Routing nach Public/Partner/Internal/Admin
MCP-Tools (mit webmcp) als natürliche Erweiterung
Persistente Conversations, Audit-Log
Einbettbares Chat-Widget mit eigenem Branding

Bisher

SaaS-Chatbot, der den eigenen Content nicht kennt
Daten landen beim Anbieter — DSGVO-Spagat
Antworten ignorieren Berechtigungen
Tool-Use läuft über zusätzliche APIs
Conversation-History fragmentiert

Vier Bausteine

Embedded Chat-Widget

Schlankes JavaScript-Widget, einbettbar auf jeder Seite. Conversation-Persistence, eigenes Branding, dark/light Mode.

MCP-Tool-Integration

Funktioniert nahtlos mit webmcp und HN/typo3-mcp-server — Tools wie Suche, Form-Submit oder Custom-Actions stehen dem Agent zur Verfügung.

Access-Class-Routing

Pro Conversation eine Access-Klasse: Public (anonyme Besucher), Partner (eingeloggte Kunden), Internal (Mitarbeitende), Admin. Der Index wird gefiltert.

RAG-Pipeline

Indexierung Ihrer TYPO3-Inhalte mit Chunking, Embedding, Hybrid-Retrieval und Re-Ranking — produktionsreif, nicht aus dem Demo-Tutorial.

Architektur

Classes/
├── Domain/          # Modelle, Value-Objects, Enums, Contracts
├── Application/     # Services, Orchestrierung
├── Infrastructure/  # Adapter, Persistenz, MCP-Tools, HTTP-Clients
└── Presentation/    # Controller, Listener, Middleware, Events

Datenbank-Tabellen

Tabelle	Zweck
`tx_businessagent_config`	Agent-Konfiguration
`tx_businessagent_conversation`	Conversation-Sessions
`tx_businessagent_message`	Einzelne Nachrichten
`tx_businessagent_access_log`	Audit-Trail für Zugriffe

Konfiguration & Voraussetzungen

Den Agent konfigurieren Sie über das TYPO3-Backend-Modul. Access Classes steuern, welche Inhalte unterschiedlichen Benutzergruppen zur Verfügung stehen — sensible Informationen werden nur an autorisierte Nutzer:innen weitergegeben.

Voraussetzungen

PHP 8.3+
TYPO3 13.4 oder 14.0
hn/typo3-mcp-server (zwingend)

Abhängigkeiten

Paket	Typ	Zweck
`hn/typo3-mcp-server`	Required	MCP-Server-Integration
`moselwal/structured-content`	Optional	Content-Annotationen und Beziehungen
`moselwal/content-provenance`	Optional	Integritätsprüfung für Inhalte
`moselwal/dev`	Dev	Geteiltes QA-Tooling

Für WhatsApp, Telefon, E-Mail, Brand-Voice und Handoff steht die kommerzielle Erweiterung business-agent-pro zur Verfügung.

Quellcode & Doku

Pro-Variante

Multichannel- und Brand-Voice-Erweiterung — siehe business-agent-pro.

Mehr erfahren

Composer-Package

moselwal/business-agent via Moselwal-Composer-Repo.

Composer-Repo öffnen

GitLab (Source of Truth)

Primäres Repository inkl. CI/CD und Composer-Package-Registry.

gitlab.moselwal.io

GitHub

Mirror auf GitHub (Platzhalter — vor Publish verifizieren).

github.com/moselwal/business-agent

Nächster Schritt

Eigenen Agent aufsetzen?

business-agent ist Open Source und kostenfrei nutzbar. Für Setup, RAG-Pipeline-Tuning, Brand-Voice-Profil und Eval-Setup begleiten wir gerne als Service.

Agent-Begleitung anfragen →

Oder direkt schreiben: kontakt@moselwal.de