Miten teen Shopify-kaupasta agenttivalmiin?
Shopify-kaupan tekee agenttivalmiiksi kolmella kerroksella: löydettävyys, agentin datapääsy ja agenttimaksu. Löydettävyys tarkoittaa discovery-tiedostoja jotka kertovat agentille mistä kauppasi rajapinnat löytyvät. Datapääsy tarkoittaa MCP-palvelinta (Model Context Protocol) jonka kautta agentti hakee tuotteet ja saldot. Agenttimaksu tarkoittaa protokollaa jolla agentti voi viimeistellä oston, kuten ACP tai UCP.
Tämä ohje käy kerrokset läpi vaihe vaiheelta oikeine tiedostoineen ja endpointteineen. Agenttivalmius rakentuu tavallisen hakukoneoptimoinnin ja tuotefeedien päälle, ei niiden tilalle. Ohje olettaa että sinulla on toimiva Shopify-kauppa ja pääsy sen hallintaan sekä sovellusasetuksiin.
Vaihe 1: Julkaise discovery-tiedostot juureen
Ensimmäinen askel on kertoa agenteille mistä kauppasi löytyy, ja se tehdään juureen sijoitettavilla tiedostoilla. Tekoälyagentti ei arvaa rajapintojasi, vaan etsii ne vakiopoluista. Kolme keskeistä tiedostoa ovat /llms.txt, /AGENTS.md ja /.well-known/-kansion agenttikortti.
/llms.txt on lyhyt kuvaus kaupasta kielimallille luettavaksi:
# Esimerkkikauppa Oy Suomalainen verkkokauppa. Myymme villavaatteita ja kotitekstiilejä. ## Rajapinnat agenteille - Tuotehaku ja ostoskori (MCP): https://esimerkkikauppa.fi/api/mcp - Agenttikortti: https://esimerkkikauppa.fi/.well-known/agent-card.json ## Yhteys sahkoposti: [email protected]
/.well-known/agent-card.json kuvaa mitä agentti voi tehdä ja mistä. Tämä on koneluettava versio samasta tiedosta:
{
"name": "Esimerkkikauppa Oy",
"description": "Villavaatteet ja kotitekstiilit",
"capabilities": ["tuotehaku", "saatavuus", "ostoskori"],
"endpoints": {
"mcp": "https://esimerkkikauppa.fi/api/mcp"
}
}Shopifyssa nämä lisätään teeman tai sovelluksen kautta niin että ne palautuvat oikeasta juuripolusta. Tarkista julkaisun jälkeen että tiedosto vastaa selaimessa osoitteessa https://kauppasi.fi/llms.txt.
Vaihe 2: Kytke MCP-palvelin tuotteille
Toinen askel on avata agentille rakenteinen pääsy tuotteisiin MCP-palvelimen kautta. Shopify tarjoaa MCP-tuen osana alustaa, joten ensimmäinen tarkistus on onko se kaupallasi jo käytössä. Jos on, varmista että se palauttaa oikeat tuotteet, hinnat ja saldot. Jos ei, MCP-palvelin rakennetaan Shopifyn Admin- tai Storefront-API:n päälle.
MCP-palvelin tarjoaa agentille nimettyjä työkaluja. Tuotehaku näyttää tältä:
{
"name": "hae_tuotteet",
"description": "Hae kaupan tuotteita hakusanalla. Palauttaa nimen, hinnan ja saatavuuden.",
"inputSchema": {
"type": "object",
"properties": { "hakusana": { "type": "string" } },
"required": ["hakusana"]
}
}Testaa palvelin ennen kuin luotat siihen. MCP-endpoint vastaa yleensä POST-kutsuun, joten voit tarkistaa sen elossaolon komentoriviltä:
curl -X POST https://kauppasi.fi/api/mcp \
-H "Content-Type: application/json" \
-d '{"method":"tools/list"}'Vastauksen pitäisi listata työkalut. Jos saat tyhjän vastauksen tai virheen, palvelin ei ole vielä valmis agentille.
Vaihe 3: Avaa agenttimaksu Stripe ACP:lla tai UCP:lla
Kolmas askel on antaa agentin viimeistellä osto, ja Shopify-kaupalle se tapahtuu tyypillisesti Stripe ACP:n tai UCP:n kautta. ACP (Agentic Commerce Protocol) on OpenAI:n ja Stripen maksuvirtaus jossa agentti (esimerkiksi ChatGPT) tekee oston kaupan olemassa olevan Stripe-yhteyden läpi. UCP (Universal Commerce Protocol) on Shopifyn ja Googlen yhteinen malli jossa agentti käyttää yhtenäistä ostoskoria ja checkoutia.
Kumman valitset riippuu siitä missä ostaja-agentit sinua kohtaavat ja mikä maksukäsittely sinulla on käytössä. Molempien vertailu on omalla sivullaan. Käytännön askel Shopify-kauppiaalle on tarkistaa onko Stripe maksunvälittäjänäsi, koska se avaa ACP-reitin ilman erillistä maksuintegraatiota.
Agenttimaksun payload noudattaa protokollan rakennetta. Havainnollistava esimerkki ostotapahtuman rungosta:
{
"protocol": "acp",
"order": {
"items": [{ "sku": "villasukat-harmaa", "quantity": 1 }],
"currency": "EUR",
"payment_token": "<agentin_maksutoken>"
}
}Älä ota agenttimaksua käyttöön ennen kuin olet testannut sen testitilassa. Väärin konfiguroitu maksuvirtaus on liiketoimintariski, ei kokeilu.
Vaihe 4: Testaa koko polku agentin silmin
Neljäs askel on ajaa koko ostopolku läpi kuten agentti tekisi, ennen kuin julistat kaupan agenttivalmiiksi. Tarkista järjestyksessä: löytyykö /llms.txt ja agenttikortti, listaako MCP-palvelin työkalut, palauttaako tuotehaku oikeat hinnat ja saldot, ja meneekö testimaksu läpi. Vasta kun jokainen kohta toimii, kauppa on agenttivalmis.
- ✓
/llms.txtja/.well-known/agent-card.jsonvastaavat selaimessa - ✓ MCP-palvelin listaa työkalut ja palauttaa oikean datan
- ✓ Tuotehaku näyttää ajantasaisen hinnan ja saldon
- ✓ Agenttimaksu menee läpi testitilassa
- ✓ Discovery-tiedostot osoittavat oikeisiin endpointteihin
Vaatiiko agenttivalmius jatkuvaa ylläpitoa?
Agenttivalmius vaatii jatkuvaa ylläpitoa, koska protokollat, tuotedata ja alustan tuki muuttuvat. MCP-palvelin pitää päivittää valikoiman mukana, maksuprotokollien versiot elävät, ja discovery-tiedostot pidetään ajan tasalla. Kertaasennus ei riitä, koska agenttikaupan standardit ovat vasta muotoutumassa.
Onko Shopify-kauppasi jo agenttivalmis?
Agenttivalmiuskartoitus ajaa kaupan läpi kuten agentti tekisi ja kertoo mikä kolmesta kerroksesta puuttuu ja missä järjestyksessä se kannattaa korjata.