Zum Hauptinhalt springen

Glossar - Begriffserklärungen

Dieses Glossar erklärt alle wichtigen Begriffe rund um das OpenAI Agents Manager Plugin.

A​

Agent​

Ein virtueller Assistent mit spezifischer Aufgabe und eigenem Wissen. Jeder Agent hat eigene Instructions, Tools und Einstellungen. Beispiel: "Produktberater-Agent", "Kundenservice-Agent".

API (Application Programming Interface)​

Eine Schnittstelle, über die Software-Programme miteinander kommunizieren. Das Plugin nutzt die OpenAI API, um mit den KI-Modellen zu sprechen.

API-Schlüssel (API Key)​

Ein geheimer Code, der Ihr Shopware-System authentifiziert und den Zugriff auf Ihr OpenAI-Konto ermöglicht. Sieht aus wie: sk-proj-abc123...

Assistant Logs​

Die Wissensdatenbank des Systems. Hier werden Fragen, Antworten und Konversationen gespeichert, um den Agenten kontinuierlich zu verbessern.

B​

Backend​

Der Administrationsbereich von Shopware, in dem Sie Agenten erstellen, konfigurieren und testen können.

Backend-Chat​

Eine Chat-Oberfläche im Shopware-Backend zum direkten Testen Ihrer Agenten.

C​

Cached Tokens​

Tokens, die bereits in vorherigen Anfragen verwendet wurden und von OpenAI zwischengespeichert (gecacht) werden. Cached Tokens kosten nur einen Bruchteil der normalen Token-Kosten (z.B. $0.08 statt $0.15).

Chat-Verlauf​

Die komplette Konversation zwischen Benutzer und Agent, inklusive aller Nachrichten und Tool-Aufrufe.

Context​

Der Kontext einer Konversation – alles, was der Agent "weiß": vorherige Nachrichten, Instructions, Tool-Rückgaben etc.

D​

Display Name​

Der Anzeigename eines Agenten – der Name, den Benutzer sehen (z.B. "Produktberater Max").

F​

Fallback Instructions​

Anweisungen, die der Agent nutzen soll, wenn er nicht weiterkommt oder ein Problem auftritt. Z.B.: "Entschuldige dich höflich und biete an, einen Mitarbeiter zu kontaktieren."

Function Call / Function Tool​

Siehe Tool.

G​

GPT (Generative Pre-trained Transformer)​

Die KI-Technologie hinter OpenAI's Modellen (wie GPT-4o, GPT-4o-mini etc.). "Generativ" bedeutet, dass sie Text generieren können.

I​

Init Instructions​

Die initialen Anweisungen, die zu Beginn einer Konversation geladen werden. Oft enthält dies die Begrüßungsnachricht.

Instructions​

Anweisungen, die definieren, wie sich ein Agent verhält. Bestehen aus:

  • System Instructions: Grundverhalten
  • Init Instructions: Begrüßung/Start
  • Fallback Instructions: Fehlerbehandlung

J​

JSON (JavaScript Object Notation)​

Ein Format zur Datenübertragung. Wird verwendet, um strukturierte Daten zwischen Systeme auszutauschen.

L​

Log-Eintrag​

Ein gespeicherter Eintrag in der Wissensdatenbank (Assistant Logs), der eine Frage und Antwort enthält.

LONGTEXT​

Ein großes Textfeld in der Plugin-Konfiguration, in dem Sie umfangreiche Informationen hinterlegen können (z.B. FAQs, Meta-Informationen).

M​

Metadata​

Zusätzliche Informationen zu einer Anfrage oder einem Agenten (z.B. Verkaufskanal-ID, Benutzer-ID).

Modell (Model)​

Das KI-Modell von OpenAI, das der Agent nutzt. Beispiele: gpt-4o-mini, gpt-4o, gpt-5.

O​

OpenAI​

Die Firma, die ChatGPT und die GPT-Modelle entwickelt. Das Plugin nutzt OpenAI's Responses API.

Output​

Die Rückgabe/Antwort eines Tools oder des Agenten.

P​

Pay-as-you-go​

Abrechnungsmodell von OpenAI: Sie zahlen nur für das, was Sie nutzen (pro API-Anfrage).

Prompt​

Die Eingabe, die an die KI gesendet wird (= Benutzernachricht + Instructions + Tool-Ergebnisse).

Prompt Caching​

OpenAI's System zum Zwischenspeichern häufig genutzter Prompts. Spart 50-90% Kosten.

R​

Rate Limit​

Die Anzahl der API-Anfragen, die Sie pro Minute/Stunde senden dürfen. Bei Überschreitung müssen Sie warten.

Reasoning Effort​

Die "Denktiefe" eines Modells. Werte: low (schnell, einfach), medium (ausgewogen), high (gründlich, langsam).

Responses API​

Die moderne OpenAI API, die das Plugin nutzt. Ersetzte die veraltete Assistants API.

Response Format​

Das Format der Agent-Antwort:

  • Auto: HTML (Standard)
  • JSON Object: Versucht JSON zu generieren
  • JSON Schema: Erzwingt JSON-Struktur

S​

Sales Channel (Verkaufskanal)​

Ein Shopware-Konzept: verschiedene Shops/Sprachen/Währungen innerhalb eines Systems. Agenten können Verkaufskanal-spezifisch konfiguriert werden.

System Instructions​

Die Haupt-Anweisungen, die das Grundverhalten eines Agenten definieren. Z.B.: "Du bist ein freundlicher Produktberater..."

T​

Tag​

Ein Schlagwort zur Kategorisierung von Log-Einträgen. Beispiele: "versand", "rückgabe", "produkt".

Technical Name​

Der technische Name eines Agenten (nur Kleinbuchstaben, Zahlen, Unterstriche). Wird in Code/APIs verwendet. Beispiel: product_advisor.

Temperature​

Einstellung für die Kreativität/Zufälligkeit der KI-Antworten:

  • 0.1-0.5: Sehr konsistent, vorhersehbar
  • 0.6-1.0: Ausgewogen
  • 1.1-2.0: Kreativ, variabel

Thread​

Eine komplette Konversation zwischen Benutzer und Agent. Jeder Thread hat eine eindeutige ID.

Token​

Die kleinste Einheit, die OpenAI verarbeitet. Ein Token ≈ 4 Zeichen ≈ 0.75 Wörter im Deutschen.

Beispiel:

"Hallo, wie geht's?" = ca. 6 Tokens

Tool / Tool Call​

Eine Funktion, die der Agent aufrufen kann, um Informationen abzurufen oder Aktionen auszuführen. Beispiele: product_search, get_order_status.

Top P (Nucleus Sampling)​

Alternative Einstellung zur Temperature. Kontrolliert die Vorhersagbarkeit der Antworten. Werte: 0.0-1.0.

U​

Usage (Nutzung)​

Die Anzahl der API-Aufrufe und verbrauchten Tokens. Wird zur Kostenberechnung verwendet.

V​

Vector Store​

Eine Datenbank für Dokumente (PDFs, Textdateien), die der Agent als Wissensquelle nutzen kann. Wird von OpenAI bereitgestellt.

Verbosity​

Die Ausführlichkeit der Agent-Antworten. Höhere Verbosity = längere, detailliertere Antworten.

Z​

Zeitzone (Timezone)​

Die Zeitzone des Shops (z.B. "Europe/Berlin"). Wichtig für zeitabhängige Antworten.

Symbole & Abkürzungen​

API​

Application Programming Interface (siehe oben)

CMS​

Content Management System (Shopware's System zur Inhaltsverwaltung)

FAQ​

Frequently Asked Questions (Häufig gestellte Fragen)

JSON​

JavaScript Object Notation (siehe oben)

PLZ​

Postleitzahl (wird z.B. bei get_order_status zur Verifizierung genutzt)

SKU​

Stock Keeping Unit (= Produktnummer)

URL​

Uniform Resource Locator (= Webadresse)

USD / EUR​

Währungen (US-Dollar / Euro) - OpenAI rechnet in USD ab

Häufig verwechselte Begriffe​

Agent vs. Assistant​

Gleiche Bedeutung in diesem Plugin. Früher hießen sie "Assistants" (OpenAI), jetzt "Agents".

Tool vs. Function​

Gleiche Bedeutung. "Tool" ist der moderne Begriff, "Function" der alte.

Thread vs. Conversation​

Fast gleich. Ein Thread ist technisch gesehen die ID, Conversation die inhaltliche Konversation.

Prompt vs. Message​

  • Prompt = Gesamte Eingabe an die KI (inklusive Instructions, History etc.)
  • Message = Einzelne Nachricht vom Benutzer

Nächste Schritte​

Jetzt verstehen Sie alle wichtigen Begriffe! Weiter geht's mit:

➡️ API-Referenz - Technische Details

➡️ Troubleshooting - Problemlösungen

➡️ Zurück zur Haupt-Dokumentation