KI Agenten
      Zurück zur Startseite
      1. moinAI Help Center
      2. KI Agenten & Themen
      3. KI Agenten

      Shopify‑Produktsuche per KI Aktion

      Diese Anleitung zeigt die Einrichtung einer KI Aktion vom Typ Webhook, um einen KI Agenten mit der Shopify Admin API zu verbinden, um eine performante Produktsuche bereitzustellen.

      1 Voraussetzungen

      Voraussetzung Details
      Shopify Access Token Token mit mindestens der Berechtigung read_products.
      Hub‑Rollen Rolle Owner, um Webhooks/KI Aktionen anzulegen.
      Shopify Admin API‑Version mit 2025‑01 getestet
      Grundwissen GraphQL Für das Anpassen von Query & Variablen.

       

      2 · Schritt‑für‑Schritt‑Anleitung

      2.1 KI Agent für Produktsuche anlegen

      1. Navigation: Knowledge Base → ➕ (Neuer Agent)

      2. Zweck des Agenten: Beschreibung, für welche Produktsuche der Agent zuständig ist, z.B.: Der Nutzer sucht nach einem Sneaker oder Accessior

      3. Quelle hinzufügen: Lege mind. ein Dokument an, das einen Überblick über das Sortiment bietet (Produktkategorien, Marken, Price‑Ranges …).

      4. Speichern & Staging aktivieren

      2.2 Webhook konfigurieren

      1. Navigation: Integrationen → Webhooks → Webhook Erstellen➕

      2. Methode & URL

        POST https://{your‑shop}.myshopify.com/admin/api/2025-01/graphql.json

      3. Header:

        X‑Shopify‑Access‑Token: <DEIN_ACCESS_TOKEN>
        Content‑Type: application/json

      4. Body (GraphQL‑Query‑Template):

        {
          "query": "query SearchProducts { products(first: 10, query: \"\") { edges { node { title productType descriptionHtml variants(first: 10) { edges { node { title price } } } } } } }",
          "variables": {}
        }

        Passe first: 10 sowie die Felder title, productType, descriptionHtml und variants an deine Shop‑Bedürfnisse an.

      2.3 KI Aktion anlegen

      1. Navigation: Knowledge Base → Aktionen → ➕ Neue Aktion

      2. Aktionsname: z. B. Shopify Produktsuche

      3. Tool auswählen: Deinen eben angelegten Webhook

      4. Toolbeschreibung: Führt eine Produktsuche in Shopify anhand einer Such‑Query durch.

      5. Anweisung vorher (optional):

        "Ich suche gerade nach passenden Produkten … einen Moment bitte."

      6. Anweisung danach (optional):

        "Hier sind die Produkte, die ich gefunden habe:"

      7. Parameter definieren:

        Feld Wert
        Name QUERY
        Typ Zeichenfolge
        Beschreibung „Shopify‑Query‑Syntax, z. B. title:*vans* OR product_type:Shoes“

      Wichtig: Der Parameter‑Name muss exakt der Platzhalter‑Variable () im Webhook‑Body entsprechen.

      2.4 Agent testen & veröffentlichen

      1. Preview öffnen: Klicke im Agenten rechts oben auf Preview oder nutze den Playground.

      2. Testfrage stellen: „Zeig mir Vans Sneaker unter 100 €“

      3. Erwartetes Verhalten:

        • Die KI ruft die Aktion auf (im Playground einsehbar).

        • Der Webhook liefert bis zu 10 passende Produkte.

        • Die Antwort des Agenten enthält Titel, Preis und ggf. Varianten.

      4. Feinjustieren: Passe Parameter‑Beschreibung, Anweisungen oder Query‑Template an, wenn das Ergebnis nicht zufriedenstellend ist.

      5. Veröffentlichen: Wenn alles funktioniert, Agent veröffentlichen, damit die Aktion im Live‑System verfügbar ist.

      3 · Erweiterte Abfragen (Vendor, Tag, Preis …)

      3.1 Datenbasis erweitern

      1. CSV‑Export aus Shopify für Vendors, Tags und Produkttypen.

      2. Dateien der Knowledge Base des Agenten hinzufügen.

      3. Parameter‑Beschreibung in der KI Aktion anpassen, z. B.:

        „Shopify‑Query‑Syntax. Unterstützte Felder: title, tag, product_type, vendor, price.
        Beispiele:
        vendor:'nike' AND tag:'kid' AND price:>50 AND price:<100“

      3.2 Beispiel

      Nutzeranfrage Automatisch generierte Query
      „Hast du günstige Kinder‑Sneaker von Nike?“ vendor:'nike' AND tag:'kid' AND price:<100

       

      4 · Best Practices

      • Toolbeschreibung prägnant halten – so versteht der Agent, wann er die Aktion auslösen soll.

      • SCREAMING_SNAKE_CASE für Parameternamen; keine Leer‑ oder Sonderzeichen.

      • Timeout kommunizieren – längere Webhook‑Antwortzeiten mit einer Vorher‑Anweisung ankündigen.

      • Preview und Playground  nutzen – jede Änderung erst testen, bevor sie live geht.