Strukturierte Multi-Persona-Content-Generierung mit Azure OpenAI und SSE-Streaming
In diesem Tutorial erstellen wir ein Content-Generation-Studio, das ein einzelnes Marketing-Briefing mithilfe verschiedener KI-Personas in drei strukturierte Content-Variationen umwandelt. Das Frontend wird mit Next.js und TypeScript entwickelt, das Backend verwendet Python mit FastAPI und Azure OpenAI übernimmt die strukturierte Generierung sowie das native Server-Sent-Events-Streaming (SSE), während Azure Content Safety für automatisierte Moderations-Guardrails sorgt.
Anstatt unvorhersehbaren Rohtext zu erzeugen, erzwingt unsere Anwendung garantierte Datenschemata (title, body und seoKeywords), Echtzeit-Fortschritts-Feedback via SSE-Streaming und drei unterschiedliche Perspektiven, die auf bestimmte Zielgruppen zugeschnitten sind: Friendly SaaS Marketer, Technical Blogger und Skeptical CFO.

Voraussetzungen
- Python und Node.js müssen auf Ihrem Computer installiert sein.
- Eine Azure-OpenAI-Ressource mit einem bereitgestellten Modell (z. B. GPT-4.1-mini oder GPT-4o).
- Eine Azure-Content-Safety-Ressource.
- Grundkenntnisse in FastAPI, Next.js und TypeScript.
- Grundlegendes Verständnis von Server-Sent Events (SSE) und Pydantic-Schemas.
Schritt 1: Pydantic-Schema definieren
Zunächst definieren wir die Struktur, die unsere Anwendung vom Modell erwartet. Dazu erstellen wir Pydantic-Modelle für die einzelnen Variationen und den übergeordneten Antwort-Container:

Dieses Schema fungiert als doppelter Vertrag: Es garantiert die Struktur unserer Backend-API-Antworten für das Next.js-Frontend und wird direkt an die Structured-Outputs-Engine von Azure OpenAI übergeben um das JSON-Schema des Modells strikt einzuschränken.
Schritt 2: Persona-System-Prompts implementieren
Marketingtexte erfordern je nach Kanal und Zielgruppe unterschiedliche Tonalitäten. In unserer Anwendung definieren wir drei System-Prompts:

Sobald eine Anfrage eingeht, kombiniert das Backend den ausgewählten Persona-System-Prompt dynamisch mit den Benutzeranweisungen, die das Briefing, die Zielgruppe, das Format (LinkedIn-Post, Marketing-E-Mail oder Landingpage-Text) und die Ausgabesprache enthalten.
Schritt 3: Content-Moderation mit Azure Content Safety
Bevor das Sprachmodell aufgerufen wird, validiert das Backend das Briefing mit Azure Content Safety. Dadurch werden schädliche Eingaben in Kategorien wie Gewalt, Hassrede, Selbstverletzung und sexuelle Inhalte erkannt:

Werden schädliche Inhalte erkannt, gibt die API ein strukturiertes 400 Bad Request mit detaillierten Kategorieangaben zurück. Dies verhindert Prompt-Injections und Missbrauch und spart gleichzeitig Token-Kosten bei blockierten Prompts. Als Fallback steht zudem eine lokale Heuristik bereit.
Schritt 4: Echtzeit-SSE-Streaming und inkrementelles Parsing
Die Generierung von drei vollständigen Marketing-Variationen dauert einige Sekunden. Anstatt den Benutzer auf die gesamte Antwort warten zu lassen, nutzen wir Server-Sent Events (SSE) über die StreamingResponse von FastAPI:

Der Streaming-Generator parst die JSON-Chunks in Echtzeit. Sobald die schließende Klammer einer Variation erreicht ist, wird ein variation-SSE-Event gesendet. Dadurch kann das Next.js-Frontend jede Content-Karte sofort rendern, sobald sie fertiggestellt ist, was eine schnelle und reaktionsfreudige Benutzeroberfläche ermöglicht.
Schritt 5: FastAPI und Next.js mit Observability verbinden
Das Next.js-Frontend verbindet sich direkt über Standard-fetch mit dem FastAPI-Stream und liest die Datenblöcke mit einem ReadableStreamDefaultReader. Es rendert den Live-Fortschritt, zeigt Persona-Badges an und unterstützt sofortiges Kopieren, eine JSON-Ansicht und den Datei-Export.
Zusätzlich erfasst jede Anfrage umfassende Observability-Daten:
- Latenz in Millisekunden.
- Prompt-, Completion- und Gesamt-Token-Verbrauch.
- Geschätzte Ausführungskosten basierend auf den Azure-OpenAI-Token-Preisen.
- Pro-Client-Generierungsprotokolle, die in SQLite und im Arbeitsspeicher gespeichert werden.
Warum Personas und Structured Outputs wichtig sind
Ohne Persona-Steuerung und Structured Outputs neigen KI-Antworten dazu, generisch, unvorhersehbar und in Produktionsanwendungen schwer zu parsen zu sein. Die Kombination aus expliziten Persona-Anweisungen und Pydantic-Schemas liefert vorhersehbare, hochwertige Ergebnisse, die direkt auf reale Marketing-Workflows zugeschnitten sind.
- Das Frontend erhält ein garantiertes, typsicheres Datenschema.
- Im Anwendungscode ist kein Entfernen von Markdown-Codeblöcken oder Regex-Parsing nötig.
- Personas sorgen für eine konsistente Markenstimme und klare Positionierung.
- Streaming eliminiert die wahrgenommene Wartezeit und verbessert die Benutzererfahrung.
Fazit
Mit Next.js, FastAPI, Azure OpenAI und Azure Content Safety haben wir eine End-to-End-Content-Generierungsanwendung mit unternehmensweiten Guardrails und Echtzeit-Streaming entwickelt.

Diese Kombination verwandelt generative KI von einem unvorhersehbaren Chat-Experiment in eine verlässliche, produktionsreife Content-Engineering-Pipeline.
Ich hoffe, dieses kurze Tutorial war hilfreich.
Now let’s code!