Architektura e-commerce pod GenAI: API, dane i JSON

W tym artykule znajdziesz analizę transformacji architektury e-commerce w stronę systemów projektowanych dla inteligentnych agentów, co wymaga odejścia od struktur budowanych wyłącznie pod frontend. Dowiesz się, jak tworzyć dane produktowe i schematy JSON "AI-ready", które minimalizują ryzyko halucynacji modeli oraz jak optymalizować API pod kątem systemów RAG. Poznasz również rolę warstwy pośredniej Semly, która standaryzuje dane i pozwala na szybkie wdrożenie funkcji AI przy jednoczesnej kontroli kosztów i bezpieczeństwa.

Po co zmieniać architekturę sklepu internetowego pod generatywne AI?

Generatywne AI wymusza zmianę myślenia o backendzie e-commerce z podejścia "API dla frontu" na "API dla inteligentnych agentów".

Nowe typy konsumentów API

Twoje API będzie konsumowane nie tylko przez stronę sklepu czy aplikację mobilną, ale również przez:

• chatboty produktowe (RAG, agenci AI),

• warstwę rekomendacji i personalizacji (LLM jako orkiestrator),

• pipeline-y generowania treści (asynchroniczne joby AI),

• narzędzia analityczne z warstwą językową.

Rola Semly w tej zmianie

Semly działa jako warstwa pośrednia między Twoim sklepem a modelami generatywnymi. Standaryzuje dane produktowe i eventy, zarządza promptami, cachingiem i kosztami modeli, pozwalając programistom skupić się na logice domenowej sklepu zamiast na szczegółach integracji z LLM.

Jakie wymagania stawia generatywne AI wobec architektury e-commerce?

Kluczowe use case-y AI a potrzeby danych

• Chatbot produktowy: Potrzebuje pełnych danych produktowych, dostępności, cen i kontekstu użytkownika.
• Wyszukiwarka semantyczna: Wymaga bogatych opisów i API search pozwalającego na filtrowanie i sortowanie.
• Rekomendacje z LLM: Potrzebują ustrukturyzowanych eventów zachowań (view, add_to_cart, purchase).

Typy danych niezbędnych dla jakości AI

• Dane produktowe (ID, teksty, atrybuty techniczne, marketingowe, SEO, multimedia, relacje).

• Dane zdarzeniowe (standard GA4: view_item, add_to_cart, begin_checkout, purchase).

• Dane kontekstowe (kanał wejścia, lokalizacja, ograniczenia biznesowe).

Projekt API sklepu pod generatywne AI

REST vs GraphQL w kontekście AI

W architekturze "AI-ready" często łączy się oba podejścia:

• REST: Idealny do eksportu katalogu i batch-owania (ETL do indeksu wektorowego).
• GraphQL: Pozwala pobrać dokładnie te pola, które są potrzebne w promcie on-demand.

Przykładowa odpowiedź GET /api/products/{id} z myślą o AI:

{
"id": "product-uuid",
"sku": "TRAIL-001",
"slug": "buty-biegania-teren",
"title": "Buty do biegania w terenie",
"brand": "Acme Sports",
"attributes": {
"terrain": "trail",
"cushioning": "high",
"weight_g": 280
},
"price": {"amount": 399.0, "currency": "PLN"},
"availability": "in_stock"
}

Dane produktowe pod generatywne AI

Normalizacja i taksonomie

Aby AI mogło sensownie wnioskować, dane muszą być spójne. Warto inspirować się standardami schema.org/Product oraz specyfikacją Google Merchant Center.

Przykład modelu w duchu schema.org:

{
"@context": "[https://schema.org/](https://schema.org/)",
"@type": "Product",
"name": "Running Shoes Blue",
"brand": {"@type": "Brand", "name": "Acme Sports"},
"offers": {
"@type": "Offer",
"priceCurrency": "PLN",
"price": "299.00"
}
}

Struktury JSON dla wymiany danych z modelami AI

JSON koszyka i sesji użytkownika

Koszyk stanowi kluczowy kontekst dla chatbota:

{
"cart_id": "cart-123",
"items": [{
"product_id": "TRAIL-001",
"quantity": 1,
"unit_price": 399.0
}],
"total": 399.0
}

JSON eventów użytkownika

Wzorując się na GA4, przyjmij wspólny format:

{
"event_type": "view_item",
"occurred_at": "2026-01-12T10:05:00Z",
"ecommerce": {
"items": [{"item_id": "TRAIL-001", "price": 399.0}],
"currency": "PLN"
}
}

Warstwa zdarzeń i historii zachowań użytkownika

Jeśli zbierasz eventy przez GA4, Segment czy Snowplow, masz już bazę. Dla AI eventy służą do personalizacji odpowiedzi i detekcji intencji.

Integracja z generatywnym AI w praktyce

Wzorce architektoniczne

• Microserwis AI: Odpowiada za integrację z LLM i przygotowanie promptów.

• Middleware / BFF: Frontend komunikuje się z BFF, który łączy dane z API sklepu i AI.

• Event-driven AI workers: Asynchroniczne generowanie opisów po evencie "ProductCreated".

Bezpieczeństwo i koszty

Jak Semly wspiera programistów?

Semly adresuje wyzwania integracji dostarczając:

1. Standaryzację danych: Mapowanie struktur (Shopify, Magento) do modelu "AI-ready".
2. Gotową warstwę API: Endpointy do chatbota i rekomendacji.
3. Kontrolę jakości: Mechanizmy cachingu i monitoringu zapytań.

FAQ dla programistów

Jak zacząć wdrażanie na istniejącej platformie SaaS (np. Shopify, Shopware)?

Należy wykorzystać istniejące interfejsy API (REST lub GraphQL) do sprawnego eksportu katalogu produktów oraz strumieniowania eventów. Kluczowym krokiem jest identyfikacja braków w danych produktowych, takich jak słabe opisy czy brak atrybutów technicznych, oraz zaplanowanie ich uzupełnienia. Zamiast bezpośrednio łączyć frontend z modelami LLM, rekomendowane jest dodanie warstwy pośredniej, takiej jak Semly

Co zrobić w przypadku danych niekompletnych lub niespójnych?

AI potrafi "wypełniać luki" w języku naturalnym, nie wolno na tym polegać w przypadku faktów, takich jak parametry techniczne czy kompatybilność. Najbezpieczniejszą strategią jest używanie AI wyłącznie do wzbogacania opisów na bazie już zweryfikowanych danych technicznych. W samych promptach należy wyraźnie zabraniać modelowi "zgadywania" – musi on otwarcie komunikować brak informacji, jeśli nie znajduje ich w źródle. Równolegle należy inwestować w jakość danych u źródła, np. w systemach PIM.

Czy do rozpoczęcia pracy niezbędna jest osobna hurtownia danych i feature store?

Na samym starcie nie jest to konieczne – można zacząć od prostego eksportu katalogu i zdarzeń bezpośrednio do Semly lub wybranego serwisu AI. Hurtownia danych oraz feature store stają się jednak kluczowe na etapie skalowania rozwiązania, gdy zachodzi potrzeba łączenia danych z wielu źródeł, budowania zaawansowanych, hybrydowych rekomendacji lub obsługi wielu marek i rynków jednocześnie.

Jak podejść do migracji danych produktowych do nowej struktury JSON?

Zaleca się stworzenie warstwy mapowania między istniejącym modelem danych a docelowym, ustandaryzowanym schematem "AI-ready". Proces ten może odbywać się stopniowo – na początku mapowanie może być częściowe, a dane mogą być sukcesywnie wzbogacane w ramach codziennych procesów merchandisingowych lub zautomatyzowanych procesów AI generujących brakujące opisy na podstawie dostępnych atrybutów.

Podsumowanie

Skuteczne wdrożenie generatywnej sztucznej inteligencji w sklepie internetowym to proces wykraczający poza prostą integrację z chatbotem. Wymaga on fundamentalnego przemodelowania sposobu, w jaki system "rozmawia" z algorytmami, przesuwając ciężar z prezentacji wizualnej na precyzyjną strukturę danych.

Oto kluczowe filary nowoczesnej architektury e-commerce:

• Semantyczne API (REST & GraphQL): Fundamentem jest odejście od interfejsów projektowanych wyłącznie pod frontend. Architektura musi oferować endpointy, które dostarczają modelom LLM pełen kontekst biznesowy bez zbędnego szumu informacyjnego. GraphQL staje się tu kluczowym narzędziem, pozwalając na pobieranie precyzyjnych zestawów pól (np. tylko atrybutów technicznych i dostępności) bezpośrednio do promptu.
• Bogate i znormalizowane dane produktowe: Modele AI działają najlepiej na danych ustrukturyzowanych, zgodnych ze standardami takimi jak schema.org czy Google Merchant Center. Pełny model produktu musi zawierać nie tylko opisy marketingowe, ale przede wszystkim typowane atrybuty techniczne (np. wagę, moc, kompatybilność) oraz listę konkretnych korzyści i zastosowań.
• Ustrukturyzowane zdarzenia (Eventy): Dane o zachowaniu użytkownika (view, add_to_cart, purchase) przestają być tylko surowym logiem dla analityki, a stają się paliwem dla personalizacji. Zdarzenia te, w połączeniu z historią sesji, pozwalają AI na trafną detekcję intencji zakupowych klienta.

Źródła:

• commercetools HTTP API – Products
• Shopify Storefront API – Product object
• Google Merchant Center – Product data specification
• Google Analytics 4 – Ecommerce measurement
• Vertex AI Search for Commerce – User events
• GA4 – Recommended events for retail/ecommerce
• Snowplow – GA migration guide (schematy eventów)

Udostępnij:

Skopiuj link