Kowal AI Product Feed voor OpenAI Vector Store en LLMs
Kowal AI Product Feed is een Magento 2-module voor het opbouwen van een datalaag voor AI, die winkelcontent voorbereidt in een vorm die direct bruikbaar is voor OpenAI Vector Store, AI-assistenten, semantische zoekmachines, RAG-pipelines en openbare mechanismen voor content discovery zoals llms.txt en NDJSON-feeds.
Dit is geen gewone export van de productcatalogus. De module ordent, normaliseert en publiceert de kennis van de winkel op een manier die het mogelijk maakt om AI-systemen er veilig mee te voeden, met behoud van controle over de actualiteit van de gegevens, de inhoudsomvang en de documentstructuur.
Hierdoor kan Magento een echte kennisbron worden voor:
- chatbots en product-copilots,
- intelligente klantenservice,
- semantische zoekmachines,
- door AI gegenereerde antwoorden,
- contentautomatisering,
- externe AI-integraties gebaseerd op openbare of private feeds.
Wat de module in de praktijk doet
De module haalt gegevens uit Magento en bouwt daaruit gestructureerde kennisdocumenten op. Hierbij ondersteunt hij niet alleen productcontent, maar ook aanvullende contentkanalen die relevant zijn vanuit AI- en verkoopperspectief.
Momenteel kan hij werken met content zoals:
product.core- basisproductgegevens, beschrijvingen, URL, attributen en categorieën,product.faq- productvragen en antwoorden,product.docs- documentatie en Markdown-bestanden,blog.article- blogartikelen,category.content- categoriecontent,cms.page- CMS-pagina's.
Elk document wordt lokaal opgeslagen, op checksum vergeleken en alleen gesynchroniseerd wanneer het daadwerkelijk is gewijzigd. Dit beperkt overbodige uploads, stabiliseert het synchronisatieproces en geeft meer controle over kosten en datakwaliteit.
Openbare AI- en LLM-endpoints
In de nieuwe versie kan de module gegevens ook publiceren via openbare frontend-endpoints:
/llms.txt/ai-feed/{storeCode}/index.json/ai-feed/{storeCode}/{contentType}.ndjson
Dit betekent dat de winkel gegevens niet alleen kan synchroniseren naar OpenAI Vector Store, maar ook een gecontroleerde contentlaag kan aanbieden voor externe AI-agents, crawlers en integratietools.
De module kan daarnaast:
- een signaal toevoegen aan de
headvan de pagina via een link naarllms.txt, - optioneel een link naar
llms.txtin de footer tonen, - feeds publiceren per store view en per taal,
- consistentie bewaren tussen winkelcontent, de AI-laag en de openbare content-discoverylaag.
Waarom dit zakelijk belangrijk is
In veel webshops zijn de gegevens die nodig zijn voor de implementatie van AI versnipperd: een deel staat in productbeschrijvingen, een deel in FAQ, een deel in de blog en een deel in aparte technische materialen. Zonder integratielaag is het lastig om daarop stabiele AI-oplossingen te bouwen.
Kowal AI Product Feed lost dit probleem op, omdat het:
- de kennis van de winkel centraliseert in één architectuur voor export en synchronisatie,
- gegevens structureert voor gebruik door taalmodellen,
- de kosten voor het bouwen van volgende AI-integraties verlaagt,
- de implementatietijd van chats, assistenten en semantische zoekmachines verkort,
- het mogelijk maakt een strategie voor
AI SEO,AEOenLLM discoverabilityte ontwikkelen, - een basis biedt voor meertalige AI-implementaties in Magento 2.
Dit betekent een snellere lancering van nieuwe functies, meer consistentie in door AI gegenereerde antwoorden en beter gebruik van de content die de winkel al heeft.
Voor wie deze module is bedoeld
De module is bedoeld voor:
- Magento 2-webshops die een AI-chat of AI assistant implementeren,
- bedrijven die semantische zoekmachines en RAG bouwen op e-commercegegevens,
- technische teams die Magento integreren met
OpenAI, - webshops die meertalige productkennisbanken ontwikkelen,
- bureaus en softwarehuizen die AI in Magento implementeren,
- merken die hun webshop willen voorbereiden op toekomstige kanalen voor content discovery via LLMs.
Hoe andere modules hiervan gebruikmaken
Andere modules kunnen Kowal AI Product Feed gebruiken als centrale kennisbron en integratielaag, in plaats van afzonderlijke exports, eigen dataserialisaties en eigen synchronisatieprocessen op te bouwen.
Voorbeelden van toepassingen:
- een AI-chatmodule kan vragen stellen aan
Vector Storeen antwoorden op basis van actuele productkennis, - een FAQ-module kan de gezamenlijke kennisbank verrijken met aanvullende vragen en antwoorden,
- een documentatiemodule kan AI voeden met instructie- en technische content,
- een klantenservicemodule kan dezelfde gegevens gebruiken voor contextuele antwoorden,
- een aanbevelingsmodule kan gestructureerde content gebruiken voor een betere productmatching,
- contentmodules kunnen de kennislaag uitbreiden met blog, CMS en aanvullende documenttypen.
Het belangrijkste is dat andere modules de technische details van synchronisatie, checksums, bestandsexport of upload naar OpenAI niet hoeven te kennen. Ze krijgen een kant-en-klare, consistente en uitbreidbare datalaag.
Belangrijkste voordelen
- kant-en-klare AI-datalaag voor Magento 2,
- ondersteuning voor
OpenAI Vector Store, - openbare
llms.txtenNDJSON-feeds, - synchronisatie van alleen gewijzigde content,
- ondersteuning voor meerdere contentkanalen,
- voorbereiding op
AI SEO,AEOen LLM-integraties, - compatibiliteit met de store view-architectuur en taalversies van Magento,
- een solide basis voor de verdere ontwikkeling van AI-automatisering in de webshop.
Kowal AI Product Feed - installatie en configuratie
Doel van het document
Dit document beschrijft het volledige proces van installatie, ingebruikname en configuratie van de module Kowal_AiProductFeed in Magento 2. Het is zo opgesteld dat u van de technische implementatie naar de eerste werkende export en publicatie van llms.txt kunt gaan.
Functionele reikwijdte van de module
De module maakt het volgende mogelijk:
- export van winkelcontent naar
JSON- enJSONL-bestanden, - synchronisatie van gegevens naar
OpenAI Vector Store, - ondersteuning voor meerdere contentkanalen, zoals product, blog, categorie en CMS,
- publicatie van openbare endpoints:
/llms.txt/ai-feed/{storeCode}/index.json/ai-feed/{storeCode}/{contentType}.ndjson
- toevoeging van een link naar
llms.txtin de sectiehead, - optionele toevoeging van een link naar
llms.txtin de footer van de webshop.
llms.txt werkt per huidige Store View. Dit betekent dat elke taalversie een eigen manifest en eigen links naar feeds kan retourneren.
Vereisten vooraf
Controleer vóór de installatie of:
- Magento 2 correct werkt,
- u SSH-toegang hebt tot de hoofdmap van Magento,
Composerbeschikbaar is in de omgeving,- het PHP-proces schrijfrechten heeft voor de map
var/, - u een actieve
OpenAI API Keyhebt als u synchronisatie naarOpenAI Vector Storewilt gebruiken.
Installatie van de module
1. Toevoegen van de Composer-repository
Als de module wordt geïnstalleerd vanuit een Git-repository:
composer config repositories.ai.product.feed vcs https://github.com/kowalco/module-ai-product-feedAls de repository privé is:
composer config --global --auth github-oauth.github.com 2. Installatie van het pakket
composer require kowal/module-ai-product-feed3. Inschakelen van de module
bin/magento module:enable Kowal_AiProductFeed4. Bijwerken van Magento
bin/magento setup:upgrade5. Compilatie en cache
Voer in een productieomgeving daarnaast het volgende uit:
bin/magento setup:di:compilebin/magento cache:flushIn een ontwikkelomgeving is meestal voldoende:
bin/magento cache:flushAls er vóór Magento een extra cachelaag draait, voer dan ook een purge uit aan de kant van:
VarnishCloudflareNginx fastcgi/proxy cache- een andere reverse proxy of CDN
6. Bevestiging van de modulestatus
bin/magento module:status Kowal_AiProductFeedLocatie van de configuratie
De configuratie van de module is beschikbaar in het paneel:
Stores -> Configuration -> General -> Kowal AI Feed
Aanbevolen configuratiemodel
De beste praktijk is configuratie op het niveau van Store View, vooral als de webshop in meerdere talen werkt.
Aanbeveling:
- één
Store View= één taal, - één
Store View= éénVector Store ID, - één
Store View= een aparte openbare laag van AI-feeds.
Voorbeeld:
PLstore view -> PoolseVector Store IDENstore view -> EngelseVector Store ID
Configuratie van velden
Enable Module
Schakelt de module in voor de geselecteerde scope.
Aanbeveling:
- stel
Yesin voor dieStore Views die AI-gegevens moeten genereren
OpenAI API Key
Globale API-sleutel die wordt gebruikt voor communicatie met OpenAI.
Vereist als:
- u bestanden wilt synchroniseren naar
OpenAI Vector Store
Niet vereist als:
- u alleen lokale exports wilt gebruiken,
- u alleen
llms.txten openbare feeds wilt gebruiken.
Vector Store ID
Identificatie van OpenAI Vector Store voor een specifieke Store View.
Aanbeveling:
- configureren op het niveau van
Store View, - een aparte identificatie instellen voor elke taal.
Feed Location
Relatief pad naar de map waarin exportbestanden worden opgeslagen.
Standaardwaarde:
var/ai-feeds
Aanbeveling:
- de map binnen
var/laten staan, - deze map niet rechtstreeks via de webserver publiceren.
Enable Public AI Feed
Schakelt openbare endpoints in:
/llms.txt/ai-feed/{storeCode}/index.json/ai-feed/{storeCode}/{contentType}.ndjson
Schakel deze optie alleen in voor die winkelweergaven waarvan de content openbaar beschikbaar mag zijn.
Belangrijk:
/llms.txtis geen globale index van alle winkels- elke taalversie van de webshop retourneert een eigen manifest
/llms.txtzelf vereist niet dat gegenereerde bestanden al bestaan om correct te reageren
Show LLMs.txt Link in Footer
Voegt een zichtbare link naar /llms.txt toe in de footer van de webshop.
Aanbeveling:
Nostandaard,Yesals u de beschikbaarheid van de AI-laag expliciet wilt communiceren aan partners, integrators of bots.
Docs Location
Relatief pad naar de map met productdocumentatie in Markdown voor product.docs.
Voorbeelden:
var/ai-docsvar/ai-docs/pl
Ondersteunde bestanden zijn onder andere:
{docsLocation}/{SKU}.md{docsLocation}/{SKU}.markdown{docsLocation}/{storeCode}/{SKU}.md{docsLocation}/{storeCode}/{SKU}.markdown{docsLocation}/{SKU}/*.md{docsLocation}/{SKU}/*.markdown{docsLocation}/{storeCode}/{SKU}/*.md{docsLocation}/{storeCode}/{SKU}/*.markdown
Max Products Per Batch
Batchgrootte voor productexport.
Startwaarde:
500
Verlaag de waarde als:
- de catalogus zeer groot is,
- de omgeving beperkt geheugen heeft,
- aanvullende AI-bewerkingen de belasting verhogen.
Sync Product Core
Schakelt het contenttype product.core in.
Aanbeveling:
Yes
Sync Product FAQ
Schakelt product.faq in.
Gebruik dit als de webshop gegevens heeft in de tabel kowal_zapytajoprodukt_pytania.
Sync Product Docs
Schakelt product.docs in.
Gebruik dit als de Markdown-documentatie al is voorbereid.
Sync Blog Content
Schakelt het kanaal blog en het type blog.article in.
Sync Category Content
Schakelt het kanaal category en het type category.content in.
Sync CMS Pages
Schakelt het kanaal cms_page en het type cms.page in.
Max Retries
Maximumaantal pogingen voor API-bewerkingen.
Standaard:
3
Polling Timeout
Maximale wachttijd voor voltooiing van bestandsverwerking aan de zijde van OpenAI.
Standaard:
600
Polling Interval
Interval tussen opeenvolgende statuscontroles.
Standaard:
5
HTTP Timeout
Maximale duur van één HTTP-request naar OpenAI.
Standaard:
60
Aanbevolen configuratievolgorde
Configureer de module na installatie in deze volgorde:
- Schakel de module in voor de doel-
Store View. - Voeg de
OpenAI API Keytoe als u synchronisatie metOpenAIplant. - Stel de
Vector Store IDin voor elke taal. - Controleer de
Feed Location. - Stel de
Docs Locationin als u Markdown-documentatie gebruikt. - Schakel de benodigde contenttypen en kanalen in.
- Schakel
Enable Public AI Feedin als de endpoints openbaar beschikbaar moeten zijn. - Schakel optioneel
Show LLMs.txt Link in Footerin. - Leeg de Magento-cache.
bin/magento cache:flushEerste start
Dry run
Voer eerst een dry run uit voor één Store View:
bin/magento kowal:ai-export:sync --channel=product --store=1 --dry-runWerkelijke export
Start daarna de daadwerkelijke synchronisatie:
bin/magento kowal:ai-export:sync --channel=product --store=1Statuscontrole
bin/magento kowal:ai-export:status --store=1Verificatie van openbare endpoints
Als Enable Public AI Feed is ingeschakeld, controleer dan:
curl -i https://twoja-domena.pl/llms.txtcurl -i https://twoja-domena.pl/ai-feed/pl/index.jsoncurl -i https://twoja-domena.pl/ai-feed/pl/product.core.ndjsonAls de webshop aparte taalversies in de URL heeft, controleer dan ook:
curl -i https://twoja-domena.pl/en/llms.txtcurl -i https://twoja-domena.pl/de/llms.txtVerwacht gedrag:
/llms.txtretourneert alleen een manifest voor de huidigeStore View/llms.txtwerkt zelfs wanneer er nog geen feedbestanden zijn gegenereerd/ai-feed/{storeCode}/index.jsontoont alleen bestaande feeds voor die winkel/ai-feed/{storeCode}/{contentType}.ndjsonwerkt pas wanneer de bijbehorende bronbestanden bestaan
Verificatie van cacheheaders:
curl -I https://twoja-domena.pl/llms.txtcurl -I https://twoja-domena.pl/ai-feed/pl/index.jsonU zou het volgende moeten zien:
- voor
/llms.txtheaders die de cache praktisch uitschakelen, - voor
index.jsoneen korte cachelevensduur en geforceerde revalidatie.
Verificatie van HTML:
- in de paginabron moet een link in
headnaar/llms.txtverschijnen, - als u de footeroptie hebt geactiveerd, moet in de footer een link
LLMs.txtverschijnen.
CLI-commando's
Synchronisatie
bin/magento kowal:ai-export:sync --channel=productbin/magento kowal:ai-export:sync --channel=product --store=1bin/magento kowal:ai-export:sync --channel=product --store=1 --content-type=product.core --identifier=example-sku --dry-runbin/magento kowal:ai-export:sync --channel=blog --store=1 --source=amasty_blogbin/magento kowal:ai-export:sync --channel=category --store=1bin/magento kowal:ai-export:sync --channel=cms_page --store=1Status
bin/magento kowal:ai-export:statusbin/magento kowal:ai-export:status --store=1bin/magento kowal:ai-export:status --channel=blog --store=1bin/magento kowal:ai-export:status --channel=blog --store=1 --source=amasty_blogImport van blogbronnen
bin/magento kowal:ai-blog-source:import --source=amasty_blog --store=1Oude productalias
Nog steeds beschikbaar voor achterwaartse compatibiliteit:
bin/magento kowal:ai-feed:generatebin/magento kowal:ai-feed:generate --store=1 --content-type=product.core --sku=example-sku --dry-runCron
De module gebruikt drie cronjobs:
kowal_ai_blog_source_importkowal_ai_feed_generatekowal_ai_feed_cleanup
Zorg ervoor dat de Magento-cron correct werkt in de omgeving.
Meest voorkomende problemen
/llms.txt retourneert 404
Controleer:
- of de actuele versie van de module met frontend-routing is uitgerold,
- of u
bin/magento setup:upgradehebt uitgevoerd, - of u in production mode
bin/magento setup:di:compilehebt uitgevoerd, - of u de standaard static content deploy hebt uitgevoerd volgens het projectproces,
- of u de cache hebt geleegd,
- of u een purge van de CDN- / reverse proxy-laag hebt uitgevoerd,
- of
Enable Public AI Feedis ingeschakeld.
Als https://twoja-domena.pl/llms.txt?v=123 werkt, maar https://twoja-domena.pl/llms.txt niet, betekent dit meestal dat er onderweg nog steeds een oude gedeelde cache actief is.
/llms.txt werkt, maar de feeds zijn leeg
Dit betekent meestal dat:
- de export nog niet is uitgevoerd,
- er geen actieve content is voor het betreffende kanaal,
- de relevante synchronisatievlaggen zijn uitgeschakeld.
Dit gedrag is correct. Het manifest zelf kan al werken voordat de eigenlijke feeds beschikbaar zijn.
Geen bestanden in var/ai-feeds
Controleer:
- of de module actief is op de juiste
Store View, - of de vereiste contenttypen zijn ingeschakeld,
- of Magento schrijfrechten heeft voor
var/, - of het synchronisatieproces is gestart.
Problemen met synchronisatie naar OpenAI
Controleer:
- de juistheid van de
OpenAI API Key, - de juistheid van de
Vector Store ID, - de beschikbaarheid van uitgaande HTTP-verbindingen,
- de waarden van time-outs en retries.
Samenvatting
Na correcte installatie en configuratie biedt de module Magento 2 een kant-en-klare datalaag voor AI:
- lokaal,
- meertalig,
- te synchroniseren met
OpenAI, - klaar voor publicatie via
llms.txtenNDJSON-feeds, - uitbreidbaar voor verdere integraties en AI-modules.
























