Setup

Extension-Konfiguration

Nach der Installation musst du die Extension konfigurieren. Gehe dazu in das TYPO3 Backend:

Admin Tools → Extensions → Extension Configuration → itm_ai_news

OpenAI API Konfiguration

Trage in die folgenden Felder deine OpenAI API-Daten ein:

  • API Key OpenAI: Dein OpenAI API-Schlüssel (erforderlich)
  • API Model OpenAI: Standard ist gpt-4o (empfohlen)

OpenAI Parameter-Einstellungen

Die folgenden Parameter steuern das Verhalten der KI:

  • Temperature: 0.5 (Standard) – Kreativität der Antworten (0-2)
  • Max Tokens: 5000 (Standard) – Maximale Anzahl generierter Tokens
  • Top P: 1 (Standard) – Nucleus Sampling Parameter
  • Frequency Penalty: 0.8 (Standard) – Vermeidung von Wiederholungen
  • Presence Penalty: 0 (Standard) – Vermeidung bereits verwendeter Begriffe

Prompt-Konfiguration

Für bessere Ergebnisse konfiguriere diese Felder:

  • Company Name: Name deines Unternehmens/deiner Organisation
  • Company Description: Kurze Beschreibung deines Unternehmens
  • Meta All: Zusätzliche Metainformationen für alle Prompts

Text-Längen-Konfiguration

  • Teaser Länge: 40 Zeichen (Standard)
  • Text Länge: 1000 Zeichen (Standard)

Ideogram API (optional)

Für die Bildgenerierung:

  • Use Ideogram: Aktiviere die Bildgenerierung
  • Ideogram API Key: Dein Ideogram API-Schlüssel
  • Ideogram API Model: Standard ist V_2
  • Aspect Ratio: Seitenverhältnis der generierten Bilder
  • Upscale: Große Bilder generieren (ja/nein)

Logging

  • Log Datei erstellen: Aktiviere für Debugging (/typo3temp/var/log/ailog.json)

2. TypoScript-Setup

Füge das folgende TypoScript in dein Template ein:

# News-Navigator Nora TypoScript
<INCLUDE_TYPOSCRIPT: source="FILE:EXT:itm_ai_news/Configuration/TypoScript/constants.typoscript">
<INCLUDE_TYPOSCRIPT: source="FILE:EXT:itm_ai_news/Configuration/TypoScript/setup.typoscript">

Optional kannst du die Storage-PID anpassen:

module.tx_itmainews_.persistence.storagePid = 123

3. Berechtigungen einrichten

Das Backend-Modul ist standardmäßig nur für Administratoren verfügbar. Für andere Benutzergruppen:

  1. Gehe zu System → Backend Users → Backend User Groups
  2. Wähle die gewünschte Benutzergruppe
  3. Füge unter Modules das Modul „AI News“ hinzu

4. News-Extension vorbereiten

Stelle sicher, dass die TYPO3 News-Extension (EXT:news) installiert und konfiguriert ist, da News-Navigator Nora mit den News-Records arbeitet.

Verwendung

News erstellen

  1. Gehe im Backend zu Web → AI News
  2. Wähle eine Zielseite aus dem Dropdown
  3. Wähle optional eine Kategorie
  4. Gib eine Beschreibung für den Newsartikel ein
  5. Füge optional zusätzliche Schlüsselwörter hinzu
  6. Klicke auf News mit AI erstellen

Bestehende News bearbeiten

  1. Klicke auf News Laden um bestehende News anzuzeigen
  2. Wähle einen News-Artikel zur Bearbeitung
  3. Du kannst einzelne Felder mit „@“ erweitern um zusätzliche Informationen an die KI zu übermitteln

Tipps zur optimalen Nutzung

  • Präzise Beschreibungen: Je detaillierter deine Beschreibung, desto besser das Ergebnis
  • Schlüsselwörter nutzen: Verwende relevante Keywords für SEO-Optimierung
  • Company-Daten konfigurieren: Hinterlege Unternehmensdaten für konsistente News
  • Nachbearbeitung: Alle generierten Inhalte können manuell angepasst werden

Fehlerbehebung

API-Fehler

  • Überprüfe deinen OpenAI API-Schlüssel
  • Stelle sicher, dass dein API-Guthaben ausreicht
  • Aktiviere das Logging für detaillierte Fehlermeldungen

Extension-Probleme

  • Cache leeren: Admin Tools → Flush TYPO3 and PHP Caches
  • Extension neu installieren falls nötig