Zum Hauptinhalt springen

Konfigurationsanleitung

Diese umfassende Anleitung behandelt alle Konfigurationsoptionen, die im NextGen OpenAI Chatbot Plugin verfügbar sind.

Konfigurationsübersicht​

Zugriff auf die Konfiguration über: Erweiterungen > Meine Erweiterungen > NextGen OpenAI Chatbot > Konfigurieren

Die Konfiguration ist in mehrere Abschnitte unterteilt:

1. OpenAI Authentifizierungskonfiguration​

Plugin aktivieren​

  • Zweck: Hauptschalter zum Aktivieren/Deaktivieren des Plugins
  • Standard: Deaktiviert
  • Empfehlung: Aktivieren Sie erst nach Abschluss aller Einrichtungsschritte

OpenAI API-Schlüssel​

  • Zweck: Ihr geheimer API-Schlüssel von OpenAI
  • Format: Beginnt mit sk-
  • Sicherheit: Teilen Sie diesen Schlüssel niemals öffentlich
  • Test: Verwenden Sie die Schaltfläche "API-Schlüssel testen", um die Verbindung zu überprüfen

Assistenten-ID​

  • Zweck: Die ID Ihres OpenAI-Assistenten
  • Format: Beginnt mit asst_
  • Standort: Zu finden in Ihrer OpenAI Platform > Assistenten-Bereich

2. OpenAI Assistenten-Konfiguration​

Chatbot-Name​

  • Zweck: Anzeigename für Ihren Chatbot
  • Beispiel: "Sarah", "ShopBot", "AI Assistant"
  • Sichtbarkeit: Erscheint neben dem Avatar in der Chat-Oberfläche
  • Tipp: Wählen Sie einen Namen, der zu Ihrer Markenpersönlichkeit passt

3. Kontaktformular AI-Assistent​

Formularintegration aktivieren​

  • Zweck: KI-Unterstützung zu Kontaktformularen hinzufügen
  • Funktion: Bietet Vorschläge vor der Formularübermittlung
  • Vorteil: Reduziert Formularübermittlungen durch sofortige Beantwortung von Fragen

Selektoren einschließen​

  • Zweck: CSS-Selektoren für einzuschließende Textfelder
  • Standard: textarea[name='comment'],textarea[name='message'],textarea[name='nachricht']
  • Format: Durch Kommas getrennte CSS-Selektoren
  • Anpassung: Fügen Sie Ihre spezifischen Formularfeld-Selektoren hinzu

Selektoren ausschließen​

  • Zweck: CSS-Selektoren für auszuschließende Textfelder
  • Standard: .no-ai,.admin-area textarea,.internal-notes,[name='rating']
  • Anwendungsfall: Verhindern Sie KI-Unterstützung bei Admin- oder sensiblen Feldern

4. Kundenauthentifizierung​

Nur für authentifizierte Benutzer​

  • Zweck: Chatbot-Zugriff nur auf angemeldete Kunden beschränken
  • Standard: Deaktiviert (verfügbar für alle Besucher)
  • Anwendungsfall: Premium-Support für registrierte Kunden

Kundengruppen-Einschränkungen​

  • Zweck: Zugriff auf bestimmte Kundengruppen begrenzen
  • Abhängigkeit: Funktioniert nur, wenn "Nur für authentifizierte Benutzer" aktiviert ist
  • Beispiel: VIP-Kunden, Premium-Mitglieder

5. Freitextfelder​

Zusätzliche Anweisungen​

  • Zweck: Zusätzliche Anweisungen für den Assistenten
  • Verwendung: Kontextspezifische Richtlinien bereitstellen
  • Beispiel: "Erwähnen Sie immer unsere 30-tägige Rückgaberichtlinie"
  • Voraussetzung: Aktivieren Sie die Funktion 'fetch_initial_chat_guidelines' WICHTIG: Um diese Funktion zu nutzen, müssen Sie dies im GPT-Assistenten aktivieren, den Sie für diesen Chatbot verwenden. Aktivieren Sie den Toolnamen fetch_initial_chat_guidelines im Assistant Manager für diesen Assistenten.

FAQ-Daten​

  • Zweck: Häufig gestellte Fragen und Antworten speichern
  • Format: Freitextformat (nur für kurze textbasierte Infos verwenden - max. 5000 Zeichen)
  • Zugriff: Der Assistent kann bei der Antwort auf diese Daten verweisen
  • Voraussetzung: Aktivieren Sie die Funktion 'get_faqs'

Meta-Informationen (Dateialternative)​

  • Zweck: Allgemeine Wissensdatenbank für den Assistenten
  • Alternative: Verwenden Sie dies anstelle des Hochladens von Dateien zu OpenAI
  • Inhalt: Unternehmensrichtlinien, Produktinformationen usw.
  • Voraussetzung: Aktivieren Sie die Funktion 'get_meta_information'

6. OpenAI-Konfiguration​

Maximale Länge der Benutzereingabe​

  • Zweck: Länge der Benutzernachrichten begrenzen
  • Standard: 400 Zeichen
  • Bereich: 2-unbegrenzte Zeichen
  • Überlegung: Längere Nachrichten kosten mehr API-Credits

Suchergebnis-Limit​

  • Zweck: Maximale Anzahl der bei Suchen zurückgegebenen Produkte
  • Standard: 8 Produkte
  • Bereich: 1-50 Produkte
  • Balance: Mehr Ergebnisse = bessere Abdeckung, aber höhere API-Kosten

Produktbeschreibungs-Limits​

  • Detailansicht: Maximal 1500 Zeichen (Standard)
  • Suchergebnisse: Maximal 500 Zeichen (Standard)
  • Zweck: API-Token-Nutzung reduzieren bei gleichbleibender Qualität Hinweis: Wenn Ihre Produktbeschreibung mehr als diese Zeichen hat, kann der Bot diese Informationen nicht verwenden

Kategorie- und Eigenschaftsoptionen​

  • Kategorie-IDs zurückgeben: Kategorie-IDs in Antworten einschließen
  • Eigenschafts-IDs als Schlüssel: Eigenschafts-IDs als Schlüssel in Antworten verwenden
  • Zweck: Erweiterte Integration mit benutzerdefinierten Implementierungen

7. Inhaltsoptimierung​

Kategorie-Blacklist​

  • Zweck: Bestimmte Kategorien von KI-Antworten ausschließen
  • Vorteil: Rauschen reduzieren und Antwortqualität verbessern
  • Beispiel: Kategorien "Rechtliches" oder "AGB" ausschließen

Kategorieebenen-Filter​

  • Zweck: Startebene für Kategorie-Breadcrumbs festlegen
  • Standard: 0 (Root-Ebene)
  • Anwendungsfall: Top-Level-Kategorien wie "Katalog" überspringen

Hersteller-Filter​

  • Zweck: Bestimmte Hersteller von KI-Antworten ausschließen
  • Anwendungsfall: Eingestellte oder problematische Marken verbergen

Eigenschaftsgruppen-Verwaltung​

  • Blacklist: Bestimmte Eigenschaftsgruppen ausschließen
  • Whitelist: Nur bestimmte Eigenschaftsgruppen einschließen
  • Max. Optionen: Eigenschaften pro Gruppe begrenzen (Standard: 20)
  • Auswirkung: Beeinflusst KI-Leistung und -Kosten erheblich

8. Erscheinungseinstellungen​

Avatar-Konfiguration​

  • Optionen: Weiblich (Standard), Männlich oder Benutzerdefiniert
  • Benutzerdefinierter Avatar: 240x240px transparentes Bild hochladen
  • Format: PNG empfohlen für Transparenz

Lade-Icons​

  • Chat-Laden: Blau, Dunkel, Golden, Rot, Grün
  • Löschen-Laden: Rot (Standard), Blau, Dunkel, Golden, Grün
  • Zweck: An Ihre Markenfarben anpassen

Layout-Optionen​

  • Scroll-Button-Position: Linke oder rechte Seite
  • Zweck: Verschiedene Layouts berücksichtigen

Best Practices für die Konfiguration​

Sicherheit​

  • ✅ Teilen Sie niemals Ihren API-Schlüssel
  • ✅ Verwenden Sie Umgebungsvariablen für sensible Daten
  • ✅ Überwachen Sie die API-Nutzung regelmäßig

Leistung​

  • ✅ Verwenden Sie Eigenschafts-Whitelists anstelle von Blacklists
  • ✅ Begrenzen Sie Produktbeschreibungslängen
  • ✅ Setzen Sie angemessene Suchergebnis-Limits

Benutzererfahrung​

  • ✅ Wählen Sie intuitive Chatbot-Namen
  • ✅ Stellen Sie klare FAQ-Inhalte bereit
  • ✅ Testen Sie alle Konfigurationen vor dem Live-Gang

Kostenmanagement​

  • ✅ Überwachen Sie die OpenAI-Nutzung regelmäßig
  • ✅ Setzen Sie angemessene Eingabelängen-Limits
  • ✅ Optimieren Sie Eigenschafts- und Kategoriefilter

Testen Ihrer Konfiguration​

  1. Konfiguration speichern: Speichern Sie immer vor dem Testen
  2. Cache leeren: Führen Sie bin/console cache:clear aus
  3. API-Verbindung testen: Verwenden Sie die integrierte Test-Schaltfläche
  4. Frontend-Test: Überprüfen Sie, ob der Chatbot erscheint und antwortet
  5. Funktionstest: Testen Sie alle aktivierten Funktionen

Erweiterte Konfigurationstipps​

Für große Kataloge​

  • Verwenden Sie Eigenschafts-Whitelists aggressiv
  • Erhöhen Sie den Kategorieebenen-Filter
  • Erwägen Sie Hersteller-Blacklists

Für stark frequentierte Shops​

  • Überwachen Sie die API-Nutzung genau
  • Implementieren Sie bei Bedarf Benutzerauthentifizierung

Nächste Schritte: Nach der Konfiguration erkunden Sie die Funktionsübersicht, um alle Möglichkeiten zu verstehen.