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:
- Gehe zu System → Backend Users → Backend User Groups
- Wähle die gewünschte Benutzergruppe
- 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
- Gehe im Backend zu Web → AI News
- Wähle eine Zielseite aus dem Dropdown
- Wähle optional eine Kategorie
- Gib eine Beschreibung für den Newsartikel ein
- Füge optional zusätzliche Schlüsselwörter hinzu
- Klicke auf News mit AI erstellen
Bestehende News bearbeiten
- Klicke auf News Laden um bestehende News anzuzeigen
- Wähle einen News-Artikel zur Bearbeitung
- 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