Tarkkojen agenttipyyntöjen perusteet

Agentic Commerce -agentti toimii parhaiten, kun pyyntö kertoo selvästi tavoitteen, kohteen ja tarvittavat rajaukset. Tarkassa haussa käytä yksilöivää tunnistetta. Listassa, rankingissa tai yhteenvedossa kerro aihealue, ajanjakso, suodattimet, mittari, järjestys ja haluttu rivimäärä niin tarkasti kuin tehtävä vaatii.

Agentti ei muuta kaupan tietoja. Se voi etsiä ohjeita, lukea tuettua liiketoimintatietoa, näyttää taulukon tai yhteenvedon, tarjota CSV-latauksen ja liittää tunnistettuun tulokseen hallintapaneelin avauspainikkeen.

Aloita tavoitteesta

Agentic Commerce -agentille kannattaa kertoa ensimmäisessä virkkeessä, minkä tuloksen tarvitset. Pyydä esimerkiksi yksittäinen tietue, rajattu lista, TOP-ranking, summa, määrä, raporttiesikatselu tai käyttöohje.

Hyvä pyyntö erottaa tuloksen taustasta:

• Näytä viimeisin tilaus.
• Listaa brändittömät tuotteet.
• Hae TOP 10 asiakasta vuodelta 2026.
• Miten toimitustavat vaikuttavat kassaan?

Vältä pelkkää aihetta, kuten tilaukset tai tuotteet. Siitä ei käy ilmi, haluatko yhden tietueen, listan, tunnusluvun vai ohjeen.

Käytä tarkkaa tunnistetta yksittäisessä haussa

Agentic Commerce -agentti saa varmemman yksittäisen tuloksen, kun annat käyttöliittymässä näkyvän yksilöivän tunnisteen. Esimerkiksi:

• tilaus: Kuka teki tilauksen 66385?
• asiakas: Hae asiakas 68455. tai Hae asiakas jane@example.com.
• tuote: Hae tuote HAM-440. tai Look up product 1R12BCU.

Nimi voi sopia hakuun, mutta sama nimi voi kuulua usealle tietueelle. Jos agentti pyytää tarkennusta, vastaa pyydetyllä numerolla, sähköpostilla, SKU:lla tai muulla täsmällisellä arvolla. Älä lisää viestiin salasanaa, API-avainta tai tarpeetonta henkilötietoa.

Rajaa lista tai raportti

Agentic Commerce -agentin listalle tai raportille kannattaa määrittää vain ne rajaukset, joilla on liiketoimintamerkitys:

1. Nimeä kohde, esimerkiksi tilaukset, asiakkaat, tuotteet tai hakutermit.
2. Kerro ajanjakso, jos kysymys koskee tiettyä kautta.
3. Lisää tarvittava tila, maa, tuote, asiakasryhmä tai muu suodatin.
4. Kerro laskettava mittari, kuten määrä tai summa.
5. Määritä järjestys ja TOP-raja, jos haluat rankingin.
6. Pyydä vain ne sarakkeet, joita tuloksen käsittelyssä tarvitaan.

Esimerkiksi Hae TOP 10 asiakasta vuodelta 2026 on täsmällisempi kuin Ketkä ovat parhaat asiakkaat?, koska se kertoo rivimäärän ja ajanjakson. Jos sanalla *paras* voisi tarkoittaa myyntiä, tilausten määrää tai muuta mittaria, nimeä mittari erikseen.

Pidä samaan tulokseen kuuluvat ehdot yhdessä

Agentic Commerce -agentille voi antaa samassa pyynnössä useita toisiinsa liittyviä rajauksia. Esimerkiksi ajanjakso, tila ja maa voivat kaikki kuulua samaan tilauslistaan. Sen sijaan toisistaan riippumattomat tehtävät kannattaa jakaa eri viesteihin.

Hyvä yhden tuloksen pyyntö voisi olla: Listaa vuoden 2026 maksetut tilaukset Suomesta, järjestä summa suurimmasta pienimpään ja näytä 20 ensimmäistä.

Liian laaja pyyntö voisi pyytää samalla asiakasrankingia, tuotevirheen selvitystä ja toimitustapaohjetta. Jakaminen tekee jokaisen tuloksen rajauksista näkyviä ja helpottaa virheen paikantamista.

Pyydä avaamaan täsmällinen kohde

Agentic Commerce -agentille pitää kertoa selvästi, jos tavoite on avata hallintapaneelin näkymä:

• Avaa tilaus 66385.
• Avaa asiakas jane@example.com.
• Avaa tuote HAM-440.

Avaustoiminto voidaan näyttää vain, jos tulos sisältää kanonisen tunnisteen ja kohteelle on tunnettu sisäinen reitti. Monirivisessä tuloksessa toiminto voi näkyä oikean taulukkorivin yhteydessä. Jos painiketta ei näy, tarkenna kohde tai avaa se tuloksen tunnistetiedoilla.

Vastaa tarkennuskysymykseen suoraan

Agentic Commerce -agentti voi pyytää tarkennusta, jos aihealue, kohde, mittari tai rajaus ei riitä turvallisen kyselyn muodostamiseen. Vastaa juuri puuttuvaan kohtaan ja säilytä sama keskustelu, jotta aiempi konteksti on käytettävissä.

Jos kysyit Hae asiakas Matti, tarkennus voi koskea esimerkiksi asiakasnumeroa tai sähköpostia. Jos kysyit Näytä tuote varaosa, anna SKU tai tarkempi nimi. Jos kysyit Avaa viimeisin asiakas, määritä mitä *viimeisin* tarkoittaa, jos agentti ei pysty johtamaan yksiselitteistä aikakenttää.

Älä arvaa puuttuvaa arvoa vain saadaksesi vastauksen. Jos tarvittavaa rajausta ei ole, muuta tavoitetta esimerkiksi yksittäisestä avauksesta rajatuksi listaksi.

Tarkista tulos ennen käyttöä

Agentic Commerce -agentin vastaus pitää tarkistaa kuten mikä tahansa hallintapaneelin raportti:

• vastaako otsikko pyydettyä aihetta;
• näkyvätkö pyydetty ajanjakso ja suodattimet tuloksessa;
• ovatko sarakkeet, mittari, järjestys ja rivimäärä tarkoituksenmukaisia;
• onko valuutta tai muu yksikkö yksiselitteinen;
• onko tulos yksittäinen tietue vai usean osuman lista;
• sisältääkö CSV-esikatselu vain tarvittavat tiedot.

Jos tulos näyttää ristiriitaiselta, täsmennä yksi rajaus kerrallaan. Älä tee liiketoimintapäätöstä pelkän sujuvan sanamuodon perusteella.

Tarkista tuetut pyynnöt komennolla

Agentic Commerce -agentin ajantasaiset liiketoimintahaun aihealueet, esimerkit ja rajaukset näkyvät komennolla /apua suomenkielisessä käyttöliittymässä. Englanninkielisessä käyttöliittymässä vastaava komento on /help.

Ohje kannattaa avata, kun et tiedä, kuuluuko pyyntö nykyiseen semanttiseen tietomalliin. Jos tehtävä edellyttää kaupan tietojen muuttamista, tee muutos hallintapaneelin varsinaisessa työkalussa omilla käyttöoikeuksillasi; agentin nykyiset live-ominaisuudet ovat vain luku -tilassa.

Tiivistettynä: nimeä tavoite, yksilöi kohde tai rajaa tietojoukko, määritä mittari ja ajanjakso tarvittaessa, vastaa tarkennukseen suoraan ja tarkista tulos ennen avausta, vientiä tai päätöstä.