Zum Hauptinhalt springen

Ersten Agenten erstellen - Detaillierte Anleitung

Diese Anleitung führt Sie Schritt für Schritt durch die Erstellung Ihres ersten KI-Agenten.

Was Sie lernen werden
  • Wie Sie einen neuen Agenten anlegen
  • Welche Einstellungen wichtig sind
  • Wie Sie Tools sinnvoll auswählen
  • Wie Sie Instructions schreiben
  • Wie Sie Ihren Agenten testen

Vorbereitung​

Stellen Sie sicher, dass Sie folgende Schritte bereits abgeschlossen haben:

  • ✅ Plugin ist installiert und aktiviert
  • ✅ OpenAI API-Schlüssel ist hinterlegt
  • ✅ OpenAI-Konto hat Guthaben

Falls nicht, folgen Sie bitte der Erste Schritte Anleitung.

Schritt 1: Agent-Erstellung starten​

1.1 Navigation zum Agent Manager​

  1. Melden Sie sich im Shopware-Backend an
  2. Klicken Sie in der linken Navigation auf "5E OAI Agent Manager"
  3. Sie sehen die Agenten-Übersicht (Liste aller Agenten)

1.2 Neuen Agenten anlegen​

  1. Klicken Sie oben rechts auf "+ Create Agent" (Agenten erstellen)
  2. Ein leeres Formular öffnet sich
  3. Sie befinden sich nun im Agent-Erstellungsmodus

Schritt 2: Basis-Informationen​

2.1 Technischer Name (Technical Name)​

Der technische Name ist ein eindeutiger Identifier für Ihren Agenten.

Regeln:

  • Nur Kleinbuchstaben (a-z)
  • Nur Zahlen (0-9)
  • Nur Unterstriche (_)
  • Keine Leerzeichen
  • Keine Umlaute (ä, ö, ü)
  • Keine Sonderzeichen

Gute Beispiele:

product_advisor
customer_service
content_checker
faq_bot
order_assistant

Schlechte Beispiele:

❌ Produktberater (Leerzeichen, Umlaut, Großbuchstaben)
❌ FAQ-Bot (Bindestrich nicht erlaubt)
❌ Agent#1 (Sonderzeichen nicht erlaubt)

Empfehlung: Wählen Sie einen Namen, der die Funktion beschreibt. Dieser Name wird später in Code/APIs verwendet.

2.2 Anzeigename (Display Name)​

Der Anzeigename ist der Name, den Benutzer sehen.

Hier sind alle Zeichen erlaubt:

Produktberater Max
FAQ-Assistent
Kundenservice-Bot 🤖
Bestellstatus-Checker

Empfehlung: Wählen Sie einen freundlichen, verständlichen Namen.

2.3 Beschreibung (Description)​

Eine interne Beschreibung zur Dokumentation (max. 500 Zeichen).

Beispiel:

Dieser Agent hilft Kunden bei der Produktauswahl.
Er kann:
- Produkte suchen und filtern
- Produktdetails erklären
- Empfehlungen geben
- Kategorien durchsuchen

Schritt 3: KI-Modell auswählen​

3.1 Verfügbare Modelle​

ModellKosten*GeschwindigkeitIntelligenzEmpfehlung
gpt-4o-mini$⚡⚡⚡ Sehr schnell⭐⭐⭐ Gut✅ Start hier!
gpt-4o$$$⚡⚡ Schnell⭐⭐⭐⭐⭐ Sehr gutFür komplexe Aufgaben
gpt-5$$$$$⚡ Langsam⭐⭐⭐⭐⭐⭐ ExzellentNur wenn nötig
o4-mini$$⚡⚡ Schnell⭐⭐⭐⭐ Sehr gutAlternative zu 4o

*Kosten: $ = günstig, $$$$$ = sehr teuer

3.2 Welches Modell für welchen Zweck?​

Produktberater / Kundenservice: → gpt-4o-mini (perfekt!)

  • Günstig, schnell, ausreichend intelligent
  • Versteht Kundenfragen sehr gut
  • Kann Tools zuverlässig aufrufen

Content-Erstellung / -Prüfung: → gpt-4o oder gpt-5

  • Bessere Textqualität
  • Tieferes Verständnis
  • Kreativere Formulierungen

FAQ / Bestellstatus: → gpt-4o-mini (mehr als ausreichend!)

  • Einfache Aufgaben
  • Schnelle Antworten
  • Sehr günstig

3.3 Modell im Formular auswählen​

  1. Finden Sie das Feld "Model"
  2. Klicken Sie auf die Dropdown-Liste
  3. Wählen Sie Ihr Modell (z.B. gpt-4o-mini)
Kosten-Tipp

Starten Sie immer mit gpt-4o-mini! Nur wenn Sie merken, dass die Antworten nicht gut genug sind, wechseln Sie zu einem teureren Modell.

Schritt 4: Tools aktivieren​

Tools sind die Funktionen, die Ihr Agent nutzen kann. Aktivieren Sie nur, was Sie wirklich brauchen!

4.1 Tool-Auswahl-Oberfläche​

Im Formular finden Sie den Bereich "Customize Capabilities: Enable Tools as needed".

Hier sehen Sie alle verfügbaren Tools als Checkboxen.

4.2 Empfohlene Tool-Sets nach Agent-Typ​

🛍️ Produktberater-Agent​

Must-have:

  • ✅ get_product_properties - Produktfilter laden
  • ✅ product_search - Produkte suchen
  • ✅ get_product_details - Produktdetails anzeigen
  • ✅ get_chatbot_name - Name für Begrüßung
  • ✅ go_to_url - Links zu Produkten

Optional:

  • ⚪ get_delivery_times - Lieferzeit-Infos
  • ⚪ get_payment_methods - Zahlungsarten

Nicht nötig:

  • ❌ get_categories (redundant mit product_properties)
  • ❌ get_manufacturer (redundant mit product_properties)
  • ❌ get_order_status (Produktberater braucht das nicht)

🎧 Kundenservice-Agent​

Must-have:

  • ✅ get_meta_information - Shop-Infos (Kontakt, Öffnungszeiten, etc.)
  • ✅ get_chatbot_name - Name
  • ✅ get_order_status - Bestellstatus prüfen
  • ✅ get_date_time - Aktuelle Zeit
  • ✅ search_logs - Wissensbasis durchsuchen
  • ✅ log - Neue Einträge speichern

Optional:

  • ⚪ get_faqs - FAQ-Inhalte
  • ⚪ get_delivery_times - Lieferzeiten
  • ⚪ get_payment_methods - Zahlungsmethoden
  • ⚪ get_countries - Lieferländer

Nicht nötig:

  • ❌ Produkt-Tools (außer für Produktfragen)

📝 Content-Prüfer (Backend)​

Must-have:

  • ✅ fetch_url - Webseiten abrufen
  • ✅ get_chatbot_name - Name

Optional:

  • ⚪ log - Verbesserungen dokumentieren

Nicht nötig:

  • ❌ Alle Shop/Produkt-Tools

4.3 Tools aktivieren​

  1. Scrollen Sie durch die Tool-Liste
  2. Setzen Sie Häkchen bei den Tools, die Sie brauchen
  3. Lassen Sie unnötige Tools deaktiviert
Weniger ist mehr!

Jedes aktivierte Tool:

  • Erhöht die Komplexität
  • Verlängert Antwortzeiten
  • Erhöht Token-Kosten

Aktivieren Sie nur, was wirklich nötig ist!

Schritt 5: Instructions schreiben​

Instructions sind das "Gehirn" Ihres Agenten. Hier definieren Sie sein Verhalten.

5.1 Drei Arten von Instructions​

Das System bietet drei separate Felder:

  1. System Instructions - Grundverhalten (WICHTIG!)
  2. Init Instructions - Begrüßung zu Beginn (Optional)
  3. Fallback Instructions - Bei Problemen (Optional)

5.2 System Instructions schreiben​

Das wichtigste Feld! Hier definieren Sie die Persönlichkeit und Aufgabe des Agenten.

Template für Produktberater:​

Du bist ein freundlicher und kompetenter Produktberater für unseren Online-Shop.

DEINE AUFGABE:
- Hilf Kunden bei der Produktauswahl
- Stelle gezielte Fragen, um Bedürfnisse zu verstehen (Budget, Größe, Farbe, Verwendungszweck)
- Nutze die verfügbaren Tools, um passende Produkte zu finden
- Gib niemals falsche Informationen - sei ehrlich, wenn du etwas nicht weißt

DEIN VERHALTEN:
- Duze den Kunden (oder "Sie" für formelle Shops)
- Sei höflich, hilfsbereit und geduldig
- Stelle maximal 2-3 Fragen pro Antwort (nicht überwältigen!)
- Antworte präzise, nicht zu lang (max. 4-5 Sätze)
- Nutze keine Emojis

WICHTIGE REGELN:
- Nutze IMMER get_product_properties() am Anfang der Konversation
- Nutze product_search() um Produkte zu suchen
- Nutze get_product_details() für Details zu einem Produkt
- Biete nie Rabatte oder Sonderkonditionen an
- Verweise bei technischen Problemen an den Support

BEISPIEL-ABLAUF:
1. Begrüße freundlich
2. Frage nach dem Bedarf ("Was suchst du?")
3. Stelle gezielte Nachfragen (Budget, Farbe, Größe)
4. Suche passende Produkte
5. Präsentiere 2-4 Optionen mit Begründung
6. Biete weitere Hilfe an

Template für Kundenservice:​

Du bist der Kundenservice-Assistent für unseren Online-Shop.

DEINE AUFGABE:
- Beantworte Fragen zu Bestellungen, Versand, Rückgabe, Zahlung
- Prüfe Bestellstatus auf Anfrage
- Nutze die Wissensdatenbank (search_logs) VOR jeder Antwort
- Speichere neue Erkenntnisse in der Wissensdatenbank (log)

DEIN VERHALTEN:
- Sieze den Kunden (formell)
- Sei professionell, freundlich und empathisch
- Bei Problemen: Entschuldige dich und biete Lösungen
- Antworte klar und strukturiert

WICHTIGE REGELN:
- Nutze IMMER search_logs() bevor du antwortest (vermeide Halluzinationen!)
- Bei unbekannten Fragen: Nutze log() um die Antwort zu speichern
- Für Bestellstatus: Frage nach Bestellnummer UND PLZ
- Nutze get_meta_information() für Shop-Infos
- Bei komplexen Problemen: Verweise an menschlichen Support

VERBOTE:
- Keine Rabatte versprechen
- Keine Rückerstattungen zusagen
- Keine persönlichen Daten herausgeben

5.3 Init Instructions (Optional)​

Die erste Nachricht, die der Agent sendet.

Beispiele:

Produktberater:

Hallo! Ich bin Max, dein Produktberater.
Wie kann ich dir heute bei der Produktsuche helfen?

Kundenservice:

Guten Tag! Ich bin Ihr Kundenservice-Assistent.
Wie kann ich Ihnen weiterhelfen?

Kurz & knapp:

Hallo! Wie kann ich dir helfen?

5.4 Fallback Instructions (Optional)​

Was tun, wenn der Agent nicht weiterkommt?

Beispiel:

Wenn du die Frage nicht beantworten kannst:
1. Entschuldige dich höflich
2. Biete an, einen menschlichen Mitarbeiter zu kontaktieren
3. Gib unsere Support-E-Mail an: support@meinshop.de

Beispiel-Antwort:
"Entschuldigung, diese Frage kann ich leider nicht beantworten.
Gerne können Sie unseren Support unter support@meinshop.de kontaktieren.
Unser Team hilft Ihnen schnell weiter!"

5.5 Tipps für gute Instructions​

DO's:

  • ✅ Sei spezifisch ("Stelle 2-3 Fragen" statt "Stelle Fragen")
  • ✅ Nenne Tools explizit ("Nutze product_search()")
  • ✅ Gib Beispiele
  • ✅ Definiere klare Regeln
  • ✅ Beschreibe die Tonalität

DON'Ts:

  • ❌ Zu vage ("Sei hilfreich")
  • ❌ Zu lang (> 3000 Zeichen wird teuer und verwirrend)
  • ❌ Widersprüche ("Sei kreativ" vs. "Antworte immer gleich")
  • ❌ Unnötige Details

Schritt 6: Erweiterte Einstellungen​

6.1 Temperature (Kreativität)​

Kontrolliert die Zufälligkeit/Kreativität der Antworten.

WertVerhaltenEmpfohlen für
0.1-0.3Sehr konsistent, wenig VariationFAQ-Bots, exakte Antworten
0.4-0.7AusgewogenProduktberater, Kundenservice ✅
0.8-1.2Kreativ, variabelContent-Erstellung
1.3-2.0Sehr kreativ, unvorhersehbarBrainstorming, Storytelling

Standardwert: 0.7 (empfohlen für die meisten Fälle)

6.2 Top P (Alternative zur Temperature)​

Nucleus Sampling - alternative Methode zur Kontrolle der Vorhersagbarkeit.

Empfehlung: Lassen Sie dieses Feld leer! Wenn Sie Temperature nutzen, brauchen Sie Top P nicht.

6.3 Max Output Tokens​

Begrenzt die maximale Länge der Antworten.

Empfohlene Werte:

  • Kurze Antworten: 500 Tokens (ca. 375 Wörter)
  • Mittlere Antworten: 1000 Tokens (ca. 750 Wörter)
  • Lange Antworten: 2000 Tokens (ca. 1500 Wörter)

Standardwert: Leer lassen (= kein Limit)

Kosten sparen

Ein Limit spart Kosten und verhindert zu lange, ausschweifende Antworten!

6.4 Reasoning Effort​

Wie viel Zeit soll das Modell "nachdenken"?

WertGeschwindigkeitQualitätKostenEmpfehlung
low⚡⚡⚡ Sehr schnell⭐⭐ Ok$ GünstigEinfache Fragen
medium⚡⚡ Schnell⭐⭐⭐⭐ Gut$$ MittelStandard ✅
high⚡ Langsam (10-30s)⭐⭐⭐⭐⭐ Exzellent$$$ TeuerKomplexe Aufgaben

Standardwert: medium (empfohlen)

6.5 Verbosity (Ausführlichkeit)​

Wie detailliert sollen Antworten sein?

  • Low: Kurz und knapp
  • Medium: Ausgewogen (Standard)
  • High: Sehr detailliert

Empfehlung: Medium

6.6 Response Format​

Wie soll die Antwort formatiert sein?

FormatBeschreibungEmpfehlung
AutoHTML (Standard)✅ Für Chats
JSON ObjectVersucht JSON zu generierenFür strukturierte Daten
JSON SchemaErzwingt JSON-StrukturFür API-Integration

Standardwert: Auto (empfohlen für die meisten Fälle)

Schritt 7: Verkaufskanal & Status​

7.1 Verkaufskanal zuordnen (Optional)​

Falls Sie mehrere Verkaufskanäle haben (z.B. DE, AT, CH):

  1. Finden Sie das Feld "Default Sales Channel"
  2. Wählen Sie einen Verkaufskanal aus
  3. Oder lassen Sie es leer für "Alle Kanäle"

7.2 Agent aktivieren​

Wichtig! Setzen Sie diese Optionen:

  • Is Active: ✅ An (sonst funktioniert der Agent nicht!)
  • Is Default: ✅ An (falls dies Ihr Haupt-Agent sein soll)
Agent muss aktiviert sein!

Ein Agent mit "Is Active" = Aus wird nicht funktionieren, auch wenn alles andere korrekt konfiguriert ist!

Schritt 8: Speichern​

  1. Scrollen Sie nach oben oder unten
  2. Finden Sie den "Save" Button
  3. Klicken Sie auf Speichern
Agent erstellt! 🎉

Ihr Agent wurde erfolgreich gespeichert und ist nun einsatzbereit!

Schritt 9: Agent testen​

9.1 Backend-Chat öffnen​

  1. Klicken Sie in der Navigation auf "5E OAI Agent Manager"
  2. Wählen Sie im Menü "Chat"
  3. Der Backend-Chat öffnet sich

9.2 Agent auswählen​

Falls Sie mehrere Agenten haben:

  1. Im Chat gibt es eine Agent-Auswahl (Dropdown)
  2. Wählen Sie Ihren neuen Agenten aus
  3. Oder: Standard-Agent wird automatisch geladen

9.3 Test-Szenarien durchführen​

Test 1: Begrüßung​

Eingabe: "Hallo!"
Erwartung: Freundliche Begrüßung

Test 2: Einfache Frage​

Eingabe: "Was verkauft ihr?"
Erwartung: Übersicht der Produktkategorien

Test 3: Produktsuche​

Eingabe: "Ich suche eine rote Jacke"
Erwartung: Agent fragt nach Details (Größe, Budget)

Test 4: Spezifische Anfrage​

Eingabe: "Zeig mir schwarze Winterjacken unter 100€ in Größe L"
Erwartung: Agent sucht und zeigt passende Produkte

Test 5: Tool-Test​

Eingabe: "Wie heißt du?"
Erwartung: Agent ruft get_chatbot_name() auf und antwortet korrekt

9.4 Qualität prüfen​

Achten Sie auf:

  • ✅ Antwortzeit: Sollte 1-10 Sekunden sein (je nach Modell)
  • ✅ Relevanz: Sind die Antworten passend?
  • ✅ Tonalität: Stimmt die Ansprache (Du/Sie)?
  • ✅ Tool-Nutzung: Werden Tools korrekt aufgerufen?
  • ✅ Produktempfehlungen: Sind sie relevant?

9.5 Logs überprüfen (Optional)​

  1. Gehen Sie zu 5E OAI Agent Manager → Logs
  2. Hier sehen Sie alle Konversationen
  3. Prüfen Sie:
    • Welche Tools wurden aufgerufen?
    • Wie viele Tokens wurden verbraucht?
    • Gab es Fehler?

Schritt 10: Optimieren & Anpassen​

Nach den ersten Tests werden Sie wahrscheinlich Anpassungen vornehmen wollen.

10.1 Agent bearbeiten​

  1. Gehen Sie zu 5E OAI Agent Manager
  2. Klicken Sie auf Ihren Agenten in der Liste
  3. Das Bearbeitungsformular öffnet sich
  4. Ändern Sie Instructions, Tools, Einstellungen
  5. Speichern Sie

10.2 Häufige Anpassungen​

Antworten sind zu lang:

  • → Temperature senken (von 0.7 auf 0.5)
  • → Max Output Tokens begrenzen (z.B. 500)
  • → In Instructions: "Halte Antworten kurz (max. 3 Sätze)"

Antworten sind zu generisch:

  • → Temperature erhöhen (von 0.7 auf 0.9)
  • → Besseres Modell wählen (von mini auf 4o)

Agent ruft Tools nicht auf:

  • → In Instructions explizit erwähnen: "Nutze product_search() für..."
  • → Reasoning Effort erhöhen (von low auf medium)

Zu teuer:

  • → Günstigeres Modell (4o → 4o-mini)
  • → Tools reduzieren
  • → Max Output Tokens limitieren

Zusammenfassung: Agent-Erstellung Checkliste​

Nutzen Sie diese Checkliste für jeden neuen Agenten:

  • Technical Name gewählt (kleinbuchstaben_mit_unterstrichen)
  • Display Name festgelegt (freundlicher Name)
  • Description geschrieben (interne Dokumentation)
  • Modell ausgewählt (Start: gpt-4o-mini)
  • Tools aktiviert (nur benötigte!)
  • System Instructions geschrieben (Verhalten definiert)
  • Init Instructions geschrieben (Begrüßung)
  • Fallback Instructions geschrieben (Fehlerbehandlung)
  • Temperature gesetzt (Standard: 0.7)
  • Reasoning Effort gesetzt (Standard: medium)
  • Is Active = ✅ An
  • Is Default = ✅ An (falls Haupt-Agent)
  • Gespeichert
  • Im Backend-Chat getestet
  • Optimiert basierend auf Tests

Nächste Schritte​

Glückwunsch! Sie haben erfolgreich Ihren ersten Agenten erstellt! 🎉

Jetzt geht es weiter mit:

➡️ Agent-Konfiguration - Alle Einstellungen im Detail

➡️ Tools & Funktionen - Tool-Referenz

➡️ Vector Stores - Eigene Dokumente hochladen

➡️ Best Practices - Optimierungs-Tipps