Miten AI-generoidaan ja parannetaan tuotekuvaukset?
Ohje AI Commerce -alustan facts-first AI‑tuotekuvauksiin: generointi, parannus, lähteet, virhetilanteet ja kumppanien käyttöönotto.
Sisällysluettelo
Miksi kuvaukset ovat tärkeitä verkkokaupassa
Hyvä tuotekuvaus ei ole “kiva lisä”, vaan se vaikuttaa suoraan myyntiin: se vähentää epävarmuutta, nostaa konversiota ja auttaa hakukonenäkyvyydessä (SEO). B2B-kaupassa korostuu erityisesti luottamus: ostaja haluaa ymmärtää mitä tuote on, mihin se sopii, ja mihin väitteet perustuvat.
Siksi tämä AI Commerce -ominaisuus on rakennettu eri tavalla kuin perinteiset “AI-copywriter”‑toiminnot: tavoitteena ei ole vain tuottaa sujuvaa tekstiä, vaan tuottaa faktoihin pohjautuva, lähteistetty ja tarkistettava tuotekuvaus.
Mitä tämä artikkeli kattaa
- Miten ominaisuus toimii ja miten sitä käytetään
- Mitkä ovat rajoitukset ja tyypillisimmät syyt, miksi tuote ei käsitteleydy
- Miten kumppanien kannattaa ottaa ominaisuus käyttöön asiakkaalle
- Miten tämä eroaa yleisistä vaihtoehdoista (esim. Shopify ja Salesforce) B2B‑näkökulmasta
Mitä ominaisuus tekee
Ominaisuudessa on kaksi pääkäyttötapaa.
1) Puuttuvien tuotekuvausten automaattinen generointi
- Kun tuotteen pitkä kuvaus on tyhjä, järjestelmä voi generoida sen automaattisesti.
- Generointi tehdään kaupan oletuskielellä (usein suomi).
- Tarvittaessa kuvaus voidaan myöhemmin kääntää muihin kieliin nykyisillä käännöstyökaluilla (käännökset eivät kuulu tämän toiminnon ytimeen).
- Jos lyhyt kuvaus on tyhjä, järjestelmä voi tuottaa myös lyhyen kuvauksen pitkän kuvauksen pohjalta (noin 50–150 sanaa).
2) Improve with AI — olemassa olevan kuvauksen parantaminen
Tuotteen muokkausnäkymässä on painike Improve with AI. Se on tarkoitettu tilanteeseen, jossa kuvaus on jo olemassa, mutta haluat:
- korjata kieliopin ja selkeyttää rakennetta
- parantaa luettavuutta
- täydentää tekstiä löydetyillä faktoilla
- kuitenkaan poistamatta mitään jo olemassa olevaa tietoa
Painikkeen painallus laittaa tuotteen “jonoon” kertaluonteista parannusta varten. Lopuksi näet mitä muuttui sekä alkuperäisen kuvauksen varmuuskopiona.

Mikä tekee tästä B2B‑henkisen
Lähteistetty “tutkimus” per tuote
Ominaisuuden keskeinen arvo on, että se tekee jokaiselle tuotteelle erillisen lähdehaun. Se ei nojaa vain siihen, mitä kauppias kirjoitti, vaan yrittää löytää julkisia, relevantteja lähteitä (esim. valmistajan sivu, datasheet, luotetut jakelijat) ja muodostaa kuvauksen niiden perusteella.
Audit trail: mistä väitteet tulivat
Järjestelmä tallentaa tuotteelle:
- Citations / lähteet: URL‑lista
- Fact check: rakenteinen faktataulukko, jossa jokaisella faktalla on arvo + lähde‑URL
- (Valinnainen laatuportti) post‑check: numeroiden ja standardien tarkistus fact checkiä vasten (jos käytössä)
Tämä on suojamekanismi, joka monelta perus-AI‑tuotekuvausratkaisulta puuttuu.

Miten “Faktan tarkastus” toimii käytännössä?
Jotta hallusinaatiot vähenevät, generointi tehdään kahdessa osassa (kauppiaan näkökulmasta se on silti yksi automaatio):
- AI kerää lähteistä faktapohjaisen‑listan (JSON)
- AI kirjoittaa pitkän kuvauksen vain tästä faktapohjaisesta‑listasta
Esimerkki faktapohjaisesta-sisällöstä
Faktan tarkastus voi sisältää esimerkiksi:
| Field | Value | Source |
|---|---|---|
| Materiaali | 100 % puuvillaa | lähde-URL |
| Väri | Black / Yellow Gold | lähde-URL |
| Istuvuus | Regular fit | lähde-URL |
Hallintapaneelissa faktan tarkistus näytetään taulukkona (Field / Value / Source), jolloin tarkistaminen on nopeaa: “mistä tämä väite tuli?”.

Lähdepolitiikka: Sallitut domainit + prioriteetit
Ominaisuus tukee Allowed domains ‑listaa, jolla määritetään mistä verkkotunnuksista tietoa saa hakea. Tämä on vapaaehtoinen:
- Jos lista on tyhjä → haku ei ole rajattu
- Jos lista on määritelty → haku tehdään vain listan lähteistä
Lisäksi listassa on järjestysluku, jolla määritetään prioriteetti (esim. valmistaja ensin):
- Valmistajan domain
- Datasheet‑domain
- Viralliset jakelijat
- Muut hyväksytyt lähteet
Tämä tuo kolme hyötyä:
- Nopeampi haku
- Parempi laatu ja vähemmän ristiriitoja
- “Governance”: lähteet pysyvät B2B‑tasoisina
Mistä editoidaan: Allowed domains hallitaan Hallintapaneelissa Tools-valikon kautta.
Tuotteen omat lähteet: PDF-liitteet Media Librarysta
Monessa B2B-kaupassa parhaat tuotetiedot eivät löydy avoimesta verkosta, vaan ne ovat jo kauppiaan hallussa: datasheetit, käyttöohjeet, sertifikaatit, tuoteperheen esitteet tai jakelijan viralliset PDF-dokumentit. AI Commerce osaa hyödyntää nämä tiedostot tuotekuvauksen lähteinä.
- Kun tuotteelle on liitetty PDF-tiedostoja, ne annetaan AI:lle ensisijaisina lähteinä (prioriteetti #1).
- AI ei ole silti “lukittu” pelkkiin PDF:iin, vaan se voi käyttää myös verkkohakua täydentäviin tietoihin.
Miksi tämä on tärkeää: kun kuvauksen faktat poimitaan suoraan tuotedokumentaatiosta, lopputulos on usein tarkempi, yhtenäisempi ja vähemmän altis hallusinaatioille kuin pelkkään verkkohakuun perustuva generointi.
Piilota tiedosto kaupasta, mutta käytä sitä AI:n lähteenä
Hallintapaneelissa voit merkitä Media Libraryyn lisätyn tiedoston “Hidden”/piilotetuksi. Tämä on tarkoitettu tilanteisiin, joissa dokumentti on hyödyllinen tuotekuvauksen lähteenä, mutta sitä ei haluta näyttää suoraan ostajalle (esim. sisäinen kooste, laaja kategoriamanuaali tai toimittajalta saatu materiaalipaketti).
Huomioi kuitenkin: tiedosto sijaitsee edelleen pilvitallennuksessa ja sen URL voi toimia sellaisenaan. Käytännössä sitä tulee käsitellä julkisena linkkinä. Älä lataa tiedostoja, jotka sisältävät luottamuksellista tai sopimuksellisesti rajoitettua tietoa.

Vinkit parhaaseen laatuun PDF-lähteillä
- Liitä mieluiten tuotekohtainen datasheet tai käyttöohje, ei liian yleinen katalogi (tämä helpottaa AI:ta löytämään oleelliset faktat).
- Jos kuvauksesta tulee lyhyt, tarkista ensin Fact check -taulukko: jos faktalista on lyhyt, myös kuvaus jää lyhyeksi (AI ei lisää väitteitä, joita ei ole faktoissa).
- Yhdistä PDF-lähteet tarvittaessa Allowed domains -prioriteetteihin (valmistaja / datasheet / virallinen jakelija), jotta ristiriitaiset tiedot vähenevät.
EU/FI-lähteiden suosiminen
Koska monet B2B‑tuotteet ja saatavuustiedot ovat aluekohtaisia, haku voidaan ohjata suosimaan EU / Suomi -kontekstia. Tämä parantaa todennäköisyyttä löytää “oikea” tuotetieto ja vähentää satunnaisia USA‑painotteisia lähteitä.
Miten jono ja priorisointi toimivat
Generointi/parannus tehdään taustalla pienissä erissä:
- Käsitellään enintään 5 tuotetta kerralla
- Yksittäinen tuote voi kestää tyypillisesti noin 1–3 minuuttia, mutta erityisesti PDF-lähteiden kanssa ajo voi kestää jopa noin 5 minuuttia
- Järjestelmässä on yläraja, jotta prosessi ei jää roikkumaan
Priorisointi:
- Ensisijaisesti käsitellään aktiiviset tuotteet
- Sen jälkeen uusimmat lisätyt tuotteet
- Lopuksi ID toimii tasoittavana järjestyksenä
Käytännössä tämä tarkoittaa, että “uudet myyntiin tulevat tuotteet” saavat kuvaukset ensin.
Näin kauppias ottaa ominaisuuden käyttöön
Vaihe 1: Aktivoi AI‑tuotekuvausgenerointi kategoriasta
- Kuvausten generointi tehdään vain niille tuotteille, joiden pääkategoria on merkitty sallimaan AI‑kuvausten luonti.
- Voit lisätä kategoriaan ohjeistuksen (instructions), esimerkiksi:
- valikoiman tone-of-voice
- mitä asioita painottaa (esim. istuvuus, käyttötarkoitus, standardit)
- mitä välttää (esim. “älä lupaa IP-luokitusta ellei lähteessä ole)

Vaihe 2: (Suositus B2B:lle) Määritä Allowed domains ja prioriteetti
Jos myyt teknisiä tuotteita, suosittelemme vahvasti rajaamaan hakua:
- Valmistaja
- Datasheetit
- Luotetut jakelijat
Lisävinkki teknisiin katalogeihin: liitä tuotteille valmistajan PDF-datasheetit tai käyttöohjeet Media Librarysta. Kun PDF löytyy, AI käyttää sitä ensisijaisena lähteenä ja “Fact check” -taulukosta näet suoraan, mitä tietoa dokumentista poimittiin.

Vaihe 3: Generoi puuttuvat kuvaukset
- Kun tuotekuvaus on tyhjä ja tuote kuuluu sallittuun kategoriaan, automaatio poimii tuotteen jonoon.
- Varmista että tuotekuvaus on tyhjä, eikä tuotteella ole kuvauksen laatimiseen estoja (AI Description Check).

Vaihe 4: Paranna olemassa olevaa kuvausta (Improve with AI)
- Tuotteen muokkausnäkymässä paina Improve with AI.
- Painike vaihtaa tilaa (vihreäksi “Processing…”) ja on estetty uudelleenklikkaukselta niin kauan kuin käsittely on käynnissä.
- Kun taustaprosessi on valmis, kuvaus päivittyy ja voit tarkastaa faktat ja lähteet.

Mitä Hallintapaneelissa näytetään hyväksyntää varten
- Products Description Original: vain luku, alkuperäinen teksti ennen AI‑muokkausta
- AI Description Diff: vihreä = lisäys, punainen = poistettava/muuttunut (auttaa hyväksynnässä)
- AI Description Citations: lähteet näkyvät linkkilistana (helpottaa nopeaa tarkistusta).
- AI Description Fact Check: faktat näkyvät taulukkona (Field / Value / Source), jotta näet yhdellä silmäyksellä mitä arvoja käytettiin ja mistä ne tulivat.
- AI Description Post Check: laatuportin tila (esim. ok) sekä mahdolliset poistot tai epävarmat väitteet, jos niitä löytyi.
Kaikki yllä olevat AI-kentät ovat vain luku -muodossa ja tarkoitettu hyväksyntään. Jos jostain syystä tallennettu data ei ole tulkittavassa muodossa, se voidaan näyttää varmuuden vuoksi myös raakatekstinä.
AI Description Check näyttää virheet ja onnistumiset. Mikäli järjestelmämme huomaa että AI teki virheen, virhe merkataan tagilla “needs_review”. Tämä tarkoittaa että virhe oli riittävän pieni, jotta kuvaus luettiin sisään, mutta kuvaukselle suositellaan manuaalista tarkistusta. Tarkistus voi myös näyttää virheitä kuten että ilmainen käyttöraja on täyttynyt, tai kategorian tuotteita ei voi muokata "This product belongs to category (*) which forbids this action".

Mistä editoidaan
- Kategoriat: pääkategorian AI‑generoinnin salliminen + kategoriaohjeet (instructions)
-
Allowed domains: Hallintapaneeli
Tools(domainit +sort_order-prioriteetit) - Tuotekuvauskohtainen parannus: tuotteen muokkausnäkymä → Improve with AI
- Bulk-hallinta: Categories CSV ja Products CSV import/export
CSV-työkalut kumppaneille ja bulk-hallintaan
Jos käytössä on tuotteiden ja kategorioiden CSV import/export, uudet kentät voidaan hallita myös CSV:llä.
Categories CSV
-
openai_product_description_enabled(0/1) -
openai_product_description_instructions(teksti)
Products CSV
-
openai_product_description_error(tyhjennä, jos haluat uudelleenyrityksen) -
openai_product_description_improve(aseta 1, jos haluat jonoon Improve-ajon)
Read-only export (näyttö vain viennissä)
openai_product_description_citationsopenai_product_description_fact_check-
openai_product_description_post_check(jos käytössä)
Hinnoittelu ja käyttörajat
Tämä ominaisuus on PAYG-tyyppinen ja käyttöä suojataan kuukausirajalla:
- Sisältyy: 10 tuotekuvausta / kk / kauppa (0 €).
-
Ylittävät kuvaukset:
- 11–100 kpl / kk: 0,87 € / tuote
- 101–1000 kpl / kk: 0,74 € / tuote
- 1001+ kpl / kk: 0,58 € / tuote
Ole yhteydessä AI Commerceen nostaaksesi rajan 10 tuotekuvauksesta / kk. Käyttöraportti (“montako tehtiin tässä kuussa”) löytyy raporteista (API Usage).
Jos raja ylittyy, järjestelmä estää uudet ajot ja näyttää virheen tyyliin:
- “AI Commerce usage limit exceeded”
- tai “Trial limit allows only X amount per month”
Vianmääritys: miksi tuotekuvaus ei synny?
Tarkista nämä järjestyksessä:
- Onko pääkategoria sallittu? Jos kategorian AI‑generointi ei ole päällä, tuote ei käsitteleydy.
-
Onko tuotteella virhe tallennettuna? Jos
openai_product_description_errorei ole tyhjä, järjestelmä ei yritä uudelleen ennen kuin virhe tyhjennetään (tämä estää loputtoman “retry-loopin”). - Onko kuukausiraja täynnä? Jos käyttöraja on saavutettu, uusia ajoja ei tehdä ennen seuraavaa kuukautta tai lisärajan hankintaa.
- Onko Allowed domains liian tiukka? Jos sallittuja domaineja on liian vähän tai ne eivät sisällä oikeita lähteitä, AI voi epäonnistua “ei löydy varmistettavia faktoja”.
- Kuvaus jäi lyhyeksi tai “yleiseksi”? Tarkista ensin Fact check -taulukko: kuvaus kirjoitetaan vain löydetyistä faktoista. Jos faktalista on lyhyt, lisää tuotteelle parempia lähteitä (esim. PDF-datasheet tai käyttöohje) tai laajenna Allowed domains -prioriteetteja luotettaviin valmistaja/jakelija‑lähteisiin.
- Tuote on epäselvä (SKU/tuotenimi/valmistaja) Jos samalla nimellä on useita variantteja, haku voi epäonnistua tai palauttaa ristiriitaista tietoa. Lisää tuotetietoihin tarkentavia tunnisteita tai rajaa lähteitä.
Vertailu: AI Commercen B2B‑lähtöinen ratkaisu vs Shopify vs Salesforce
Alla rehellinen vertailu “painotuksista” kauppiaan näkökulmasta. Huom: ominaisuudet ja lisenssit voivat muuttua, ja käytännön toteutus riippuu myös asiakkaan prosesseista.
| Ominaisuus | Meidän ratkaisu (B2B‑orientoitunut) | Shopify Magic | Salesforce Commerce (Einstein) |
|---|---|---|---|
| Lähdehaku per tuote | Kyllä: online research + lähteet talteen | Dokumentaatio painottaa käyttäjän antamia tietoja/avainsanoja ja tuottaa ehdotuksia niiden perusteella | Dokumentaatio kuvaa ohjeisiin perustuvaa “revised description” -generointia tuotteen tiedoista |
| Audit trail (lähteet + fakta-taulukko) | Kyllä: citations + fact_check (ja mahdollinen post-check) | Ei vastaavaa “faktataulukko + lähde per väite” -painotusta | Ei vastaavaa “web‑lähteisiin perustuvaa lähdeketjua” -painotusta |
| Omat dokumentit (PDF) lähteinä | Kyllä: tuotteelle liitetyt PDF:t voidaan käyttää ensisijaisina lähteinä ja lähde näkyy Fact checkissä | Vaihtelee: pääpaino on tekstin luomisessa ja parantelussa kauppiaan antamien tietojen pohjalta | Vaihtelee: enterprise-toteutuksissa voidaan käyttää omia datalähteitä, mutta käyttöönotto on projektikohtainen |
| B2B-riskien hallinta | Fact-first + (valinnainen) numero/standardi‑tarkistin + virhelogiikka | Shopify korostaa, että sisällön tarkistus ja vastuu on kauppiaalla | Vahva enterprise‑kokonaisuus, mutta tuotetekstin “todennusketju” ei ole kuvattu samalla tavalla |
| Kielituki (tuotekuvausten automaattinen generointi) | Generointi tehdään kaupan oletuskielellä (esim. suomi) | Automaattisesti generoituva tuotekuvaus tuetaan tietyillä kielillä (lista ei sisällä suomea) | Salesforce dokumentaatiossa tuoteteksti‑ohjeiden tuki on rajattu (esim. “instructions only in English”) |
| Hinnoittelu | 10/kk mukana + 0,95 €/kpl yli rajan (PAYG) | Shopify kertoo Shopify Magicin olevan saatavilla ilman erillistä maksua osana Shopifyta | Salesforce kertoo generatiivisen AI:n olevan käyttöperusteisesti veloitettu (“charges only for the activity you use”) |
| Kenelle paras | B2B / tekninen katalogi, jossa faktat ja lähteet ovat kriittisiä | Nopea sisällöntuotanto Shopify‑kauppiaille, kun lähteistys ei ole keskiössä | Enterprise‑organisaatiot, joilla Salesforce‑ekosysteemi ja prosessit jo käytössä |
Tarkentavat huomiot (Shopify ja Salesforce)
- Shopify Magic: Shopify kuvaa Shopify Magic -työkalujen olevan saatavilla ilman erillistä maksua, mutta ominaisuuksien saatavuus voi vaihdella. Automaattisesti generoitujen tuotekuvausten kielituki on rajattu tiettyihin kieliin.
- Salesforce: Salesforce dokumentoi, että Einstein Generative AI for Commerce “charges only for the activity you use”.
Suositus kumppaneille: miten onnistutte asiakkaan kanssa
Tämä toiminto on automaatio, mutta onnistunut käyttöönotto vaatii silti “asetusten kurinalaisuutta”. Siksi suosittelemme kumppanivetoista käyttöönottoa erityisesti B2B‑katalogeissa.
Kumppanin checklist
- Määritä lähteet: allowed domains + prioriteetit (valmistaja/datasheet/jakelija).
- Liitä asiakkaan omat dokumentit (esim. datasheetit ja käyttöohjeet) tuotteille Media Librarysta. Tarvittaessa merkitse tiedosto piilotetuksi (Hidden), jos sitä ei haluta näyttää ostajalle – mutta varmista, ettei dokumentissa ole luottamuksellista tietoa.
- Tee kategoria-ohjeet: 5–10 tärkeintä kategoriaa ensin, ei koko katalogia kerralla.
- Pilotointi: 20–50 tuotetta, tarkista faktat ja muoto.
- Laajennus: laita loput kategoria kerrallaan.
- Prosessi: sovitaan kuka hyväksyy, kuka korjaa, ja milloin virheet tyhjennetään.
Yhteenveto ja suositeltu seuraava toimenpide
Tämän ominaisuuden arvo B2B‑kauppiaalle on kolmessa asiassa:
- Ajan säästö: kuvausten luonti ja parannus automatisoituu.
- Luottamus: lähteet ja faktat ovat tarkistettavissa (audit trail).
- B2B‑laatu: hallusinaatioiden riskiä pienennetään facts-first‑mallilla, lähdepolitiikalla ja laatuporteilla.
- Omat lähteet: kun liität tuotteelle PDF-dokumentteja (datasheet, käyttöohje), AI voi käyttää niitä ensisijaisina lähteinä ja tuottaa tarkemman kuvauksen.
Suositeltu seuraava askel: ota käyttöön 5–10 tärkeintä kategoriaa, määritä Allowed domains -prioriteetit ja tee 20–50 tuotteen pilotti, jossa varmistat faktat, lähteet ja hyväksyntäprosessin ennen laajennusta.
Lisävinkki: voit muotoilla sisäiseen myyntikäyttöön tiiviin “sales one-pager” -version (1 sivu), joka sopii myyjälle suoraan asiakaskeskusteluun.
Avainsanat
- AI Commerce tuotekuvaus
- AI-tuotekuvausten generointi
- Improve with AI
- fact_check
- citations
- Allowed domains
- post-check
- openai_product_description_enabled
- openai_product_description_improve
- CSV import/export tuotteet kategoriat