Store-API-Funktionen

Diese Seite erklärt die Store-API-Funktionen, die der FelAIProductAdvisor verwenden kann, um Informationen aus Ihrem Shopware-Shop abzurufen.

Überblick

Der FelAIProductAdvisor verwendet verschiedene Store-API-Funktionen, um auf Daten aus Ihrem Shopware-Shop zuzugreifen. Diese Funktionen ermöglichen es dem Produktberater, Informationen über Produkte, Kategorien, Hersteller und mehr abzurufen und so präzise und hilfreiche Antworten auf Kundenanfragen zu geben.

Verfügbare Funktionen

get_categories

Ruft Kategorieinformationen aus dem Shop ab.

Beschreibung: Diese Funktion ermöglicht es dem Produktberater, auf verfügbare Shop-Kategorien zuzugreifen und diese zu präsentieren, einschließlich ihrer URLs, Namen und Breadcrumb-Strukturen.

Beispielanwendung:

Wenn ein Kunde nach Produktkategorien fragt
Um relevante Kategorien basierend auf Kundeninteressen vorzuschlagen
Um Kunden bei der Navigation durch die Shop-Struktur zu helfen

Antwortbeispiel:

{
  "categories": [
    {
      "id": "category-id-1",
      "name": "Elektronik",
      "url": "/elektronik",
      "childCount": 5,
      "breadcrumb": ["Startseite", "Elektronik"]
    },
    {
      "id": "category-id-2",
      "name": "Smartphones",
      "url": "/elektronik/smartphones",
      "childCount": 0,
      "breadcrumb": ["Startseite", "Elektronik", "Smartphones"]
    }
  ]
}

get_manufacturer

Ruft Informationen über Produkthersteller ab.

Beschreibung: Diese Funktion ermöglicht es dem Produktberater, Benutzern detaillierte Informationen über die Hersteller Ihrer Produkte bereitzustellen.

Beispielanwendung:

Wenn ein Kunde nach bestimmten Marken fragt
Um Produkte nach Hersteller zu filtern
Um Informationen über den Hintergrund eines Herstellers bereitzustellen

Antwortbeispiel:

{
  "manufacturers": [
    {
      "id": "manufacturer-id-1",
      "name": "Apple",
      "description": "Apple Inc. ist ein amerikanisches multinationales Technologieunternehmen...",
      "url": "/hersteller/apple"
    },
    {
      "id": "manufacturer-id-2",
      "name": "Samsung",
      "description": "Samsung Electronics Co., Ltd. ist ein südkoreanisches multinationales Elektronikunternehmen...",
      "url": "/hersteller/samsung"
    }
  ]
}

get_product_properties

Ruft Eigenschaften, Hersteller und Kategorien von Produkten ab.

Beschreibung: Diese Funktion ermöglicht es dem Produktberater, Produkteigenschaften, Herstellernamen und Kategorien abzurufen und zu nutzen, um Produktsuche und Filterfunktionen zu verbessern.

Beispielanwendung:

Um verfügbare Produktattribute zu verstehen
Um Kunden Filteroptionen vorzuschlagen
Um Produktspezifikationen zu erklären

Antwortbeispiel:

{
  "properties": [
    {
      "id": "property-id-1",
      "name": "Farbe",
      "options": ["Rot", "Blau", "Grün", "Schwarz"]
    },
    {
      "id": "property-id-2",
      "name": "Größe",
      "options": ["S", "M", "L", "XL"]
    }
  ],
  "manufacturers": [...],
  "categories": [...]
}

get_payment_methods

Ruft verfügbare Zahlungsmethoden ab.

Beschreibung: Diese Funktion ermöglicht es dem Produktberater, Benutzern Informationen über die verfügbaren Zahlungsmethoden in Ihrem Shop bereitzustellen.

Beispielanwendung:

Wenn ein Kunde nach Zahlungsoptionen fragt
Um Zahlungsprozesse zu erklären
Um zahlungsbezogene Fragen zu beantworten

Antwortbeispiel:

{
  "paymentMethods": [
    {
      "id": "payment-id-1",
      "name": "Kreditkarte",
      "description": "Zahlen Sie sicher mit Ihrer Kreditkarte."
    },
    {
      "id": "payment-id-2",
      "name": "PayPal",
      "description": "Schnelle und sichere Zahlung mit PayPal."
    }
  ]
}

get_delivery_times

Ruft Informationen über Lieferzeiten ab.

Beschreibung: Diese Funktion ermöglicht es dem Produktberater, Benutzer über die geschätzten Lieferzeiten für Produkte oder Dienstleistungen zu informieren.

Beispielanwendung:

Wenn ein Kunde nach Versandzeiten fragt
Um Liefervoranschläge bereitzustellen
Um Versandoptionen zu erklären

Antwortbeispiel:

{
  "deliveryTimes": [
    {
      "id": "delivery-id-1",
      "name": "Standardversand",
      "min": 2,
      "max": 5,
      "unit": "day"
    },
    {
      "id": "delivery-id-2",
      "name": "Expressversand",
      "min": 1,
      "max": 2,
      "unit": "day"
    }
  ]
}

get_countries

Ruft verfügbare Länder für den Versand ab.

Beschreibung: Diese Funktion ermöglicht es dem Produktberater, Benutzern eine Liste verfügbarer Länder bereitzustellen, nützlich für Versand und Lokalisierung.

Beispielanwendung:

Wenn ein Kunde nach internationalem Versand fragt
Um Informationen über Versandziele bereitzustellen
Um länderspezifische Fragen zu beantworten

Antwortbeispiel:

{
  "countries": [
    {
      "id": "country-id-1",
      "name": "Vereinigte Staaten",
      "iso": "US"
    },
    {
      "id": "country-id-2",
      "name": "Deutschland",
      "iso": "DE"
    }
  ]
}

product_search

Sucht nach Produkten basierend auf verschiedenen Kriterien.

Beschreibung: Diese Funktion ermöglicht es dem Produktberater, Produktsuchen basierend auf Benutzeranfragen durchzuführen, mit der Möglichkeit, Ergebnisse nach Kategorien, Eigenschaften, Preisbereich und Sortieroptionen zu filtern.

Parameter:

query: Suchbegriff
categories: Array von Kategorie-IDs
properties: Array von Eigenschafts-IDs
price_min: Mindestpreis
price_max: Höchstpreis
limit: Anzahl der Ergebnisse (Standard: 10)
page: Seitenzahl für Paginierung
order: Sortierreihenfolge (z.B. "price_asc", "price_desc", "name_asc")

Beispielanwendung:

Wenn ein Kunde nach bestimmten Produkten fragt
Um Produkte zu zeigen, die bestimmten Kriterien entsprechen
Um Produkte basierend auf Kundenpräferenzen zu filtern

Antwortbeispiel:

{
  "products": [
    {
      "id": "product-id-1",
      "name": "iPhone 13 Pro",
      "description": "Apples Flaggschiff-Smartphone mit fortschrittlichem Kamerasystem.",
      "price": {
        "amount": 999.00,
        "currency": "EUR",
        "formatted": "999,00 €"
      },
      "images": [
        {
          "url": "https://example.com/images/iphone-13-pro.jpg",
          "alt": "iPhone 13 Pro"
        }
      ],
      "url": "/detail/iphone-13-pro",
      "properties": [
        {
          "name": "Farbe",
          "value": "Graphit"
        },
        {
          "name": "Speicher",
          "value": "256GB"
        }
      ]
    }
  ],
  "total": 25,
  "page": 1,
  "limit": 10
}

get_product_details

Ruft detaillierte Informationen über ein bestimmtes Produkt ab.

Beschreibung: Diese Funktion ermöglicht es dem Produktberater, detaillierte Informationen über bestimmte Produkte anhand ihrer Produkt-IDs oder -Nummern abzurufen und Benutzern umfassende Produktdetails anzubieten.

Parameter:

productId: ID des Produkts

Beispielanwendung:

Wenn ein Kunde nach mehr Informationen über ein bestimmtes Produkt fragt
Um detaillierte Spezifikationen bereitzustellen
Um produktspezifische Fragen zu beantworten

Antwortbeispiel:

{
  "product": {
    "id": "product-id-1",
    "name": "iPhone 13 Pro",
    "description": "Apples Flaggschiff-Smartphone mit fortschrittlichem Kamerasystem.",
    "longDescription": "Das iPhone 13 Pro verfügt über ein 6,1-Zoll Super Retina XDR Display mit ProMotion-Technologie, A15 Bionic Chip, Pro-Kamerasystem mit neuen 12MP Teleobjektiv-, Weitwinkel- und Ultraweitwinkelkameras und bis zu 1TB Speicher.",
    "price": {
      "amount": 999.00,
      "currency": "EUR",
      "formatted": "999,00 €"
    },
    "images": [
      {
        "url": "https://example.com/images/iphone-13-pro-1.jpg",
        "alt": "iPhone 13 Pro Vorderseite"
      },
      {
        "url": "https://example.com/images/iphone-13-pro-2.jpg",
        "alt": "iPhone 13 Pro Rückseite"
      }
    ],
    "url": "/detail/iphone-13-pro",
    "properties": [
      {
        "name": "Farbe",
        "value": "Graphit"
      },
      {
        "name": "Speicher",
        "value": "256GB"
      },
      {
        "name": "Display",
        "value": "6,1 Zoll Super Retina XDR"
      },
      {
        "name": "Prozessor",
        "value": "A15 Bionic"
      }
    ],
    "manufacturer": {
      "name": "Apple",
      "id": "manufacturer-id-1"
    },
    "categories": [
      {
        "name": "Smartphones",
        "id": "category-id-2"
      }
    ],
    "stock": {
      "available": true,
      "quantity": 15
    }
  }
}

Integration im Produktberater

Der Produktberater hat automatisch Zugriff auf diese Funktionen und verwendet sie basierend auf dem Kontext der Konversation. Sie müssen diese Funktionen nicht explizit aktivieren oder konfigurieren, da sie in die Fähigkeiten des Produktberaters integriert sind.

Wie der Produktberater diese Funktionen verwendet

Kundenbedürfnisse verstehen: Der Berater analysiert Kundenanfragen, um zu bestimmen, welche Funktion verwendet werden soll
Relevante Daten abrufen: Er ruft die entsprechende Funktion auf, um die benötigten Informationen zu erhalten
Informationen präsentieren: Er formatiert und präsentiert die Daten benutzerfreundlich
Nachfassen: Basierend auf den abgerufenen Daten kann er Folgefragen stellen oder Empfehlungen aussprechen

Beispiel-Gesprächsverlauf

Hier ist ein Beispiel, wie diese Funktionen in einer Konversation verwendet werden könnten:

Kunde: "Ich suche ein Smartphone unter 500€"
Berater: Verwendet product_search mit Parametern { "categories": ["smartphones"], "price_max": 500 }
Berater: "Ich habe mehrere Smartphones unter 500€ gefunden. Hier sind einige Optionen..."
Kunde: "Können Sie mir mehr über dieses Samsung-Modell erzählen?"
Berater: Verwendet get_product_details, um detaillierte Informationen abzurufen
Berater: "Das Samsung Galaxy A52 verfügt über ein 6,5-Zoll Super AMOLED Display..."
Kunde: "Welche Zahlungsmethoden akzeptieren Sie?"
Berater: Verwendet get_payment_methods, um Zahlungsinformationen abzurufen
Berater: "Wir akzeptieren mehrere Zahlungsmethoden, einschließlich Kreditkarte, PayPal..."

Leistungsüberlegungen

Die Funktionen sind auf Leistung optimiert, aber komplexe Abfragen können länger dauern
Erwägen Sie, die Anzahl der in Suchen zurückgegebenen Produkte zu begrenzen, um Antwortzeiten zu verbessern
Der Produktberater verarbeitet automatisch die Paginierung für große Ergebnismengen

Nächste Schritte

Nachdem Sie die Store-API-Funktionen verstanden haben, können Sie:

Ihre Produktdaten optimieren, um Suchergebnisse zu verbessern
Die KI konfigurieren, um diese Funktionen besser zu nutzen
Verschiedene Szenarien testen, um zu sehen, wie die Funktionen in der Praxis funktionieren
Leistung überwachen, um Verbesserungsbereiche zu identifizieren

Store-API-Funktionen

Überblick​

Verfügbare Funktionen​

get_categories​

get_manufacturer​

get_product_properties​

get_payment_methods​

get_delivery_times​

get_countries​

product_search​

get_product_details​

Integration im Produktberater​

Wie der Produktberater diese Funktionen verwendet​

Beispiel-Gesprächsverlauf​

Leistungsüberlegungen​

Nächste Schritte​

Überblick

Verfügbare Funktionen

get_categories

get_manufacturer

get_product_properties

get_payment_methods

get_delivery_times

get_countries

product_search

get_product_details

Integration im Produktberater

Wie der Produktberater diese Funktionen verwendet

Beispiel-Gesprächsverlauf

Leistungsüberlegungen

Nächste Schritte