AI-työkalujen luominen

Anna AI-avustajallesi supervoimia räätälöityjen työkalujen avulla

AI SmartTalkin SmartFlow-visuaalinen solmukonstruktori mahdollistaa räätälöityjen työkalujen luomisen AI-avustajallesi ilman koodin kirjoittamista. Nämä työkalut laajentavat AI:si kykyjä keskustelusta todellisiin toimiin.

---

Mitä ovat AI-työkalut?

Työkalut (jotka tunnetaan myös nimellä "toimintokutsuminen") mahdollistavat AI:si suorittaa tiettyjä tehtäviä keskustelujen aikana. Sen sijaan, että se vain vastaisi kysymyksiin, AI:si voi:

• Etsiä tuotekatalogistasi
• Varaa tapaamisia
• Luoda tukilippuja
• Tarkistaa tilauksen tilan
• Ja paljon muuta

Ilman työkaluja vs Työkalujen kanssa

Tilanne	Ilman työkaluja	Työkalujen kanssa
Tilauksen tila	"Ole hyvä ja vieraile verkkosivustollamme tarkistaaksesi tilauksesi"	AI hakee seurantatiedot ja näyttää ne heti
Tapaamisen varaaminen	"Soita meille numeroon 555-1234 varataksesi"	AI tarkistaa saatavuuden ja varaa ajan
Tuotehaku	"Selaa katalogiamme osoitteessa..."	AI etsii ja näyttää vastaavat tuotteet

---

Työkalujen luominen SmartFlowlla

Käytä Keskustelutyökalun laukaisevaa toimintoa luodaksesi työkaluja, joita AI:si voi käyttää keskustelujen aikana.

Vaihe 1: Luo uusi SmartFlow

1. Siirry kohtaan Automaatio → SmartFlows
2. Napsauta + Uusi SmartFlow
3. Anna sille kuvaava nimi (esim. "Tuotehaku Työkalu")

Vaihe 2: Lisää Keskustelutyökalun laukaisin

Vedä Keskustelutyökalun laukaisin kankaalle:

Määritä laukaisin:

Kenttä	Kuvaus
Nimi	Työkalun nimi, jonka AI tunnistaa
Kuvaus	Auttaa AI:ta ymmärtämään, milloin käyttää tätä työkalua
Käyttäjäkohdistus	Kuka voi käyttää tätä työkalua (kaikki käyttäjät, vain yhteydessä olevat jne.)
Työkalun muuttujat	Parametrit, jotka AI:n tulisi kerätä käyttäjältä

Vaihe 3: Määritä muuttujat

Lisää muuttujia, joita AI:si tulisi kerätä keskustelun aikana:

Muuttuja	Tyyppi	Kuvaus
productName	Merkkijono	Minkä tuotteen etsitään
maxPrice	Numero	Suurin hintasuodatin
category	Merkkijono	Tuotekategoria

AI kysyy luonnollisesti käyttäjiltä näitä arvoja keskustelun aikana.

Vaihe 4: Lisää toimintoja

Yhdistä toimintoja suorittamaan varsinaista työtä:

Yleiset toimintoyhdistelmät:

Käyttötapa	Toiminnot
Tuotehaku	Etsi tietopankista → Aseta havainto
Lipun luominen	JIRA Luo ongelma → Aseta havainto
Tapaaminen	API-kutsu (kalenteri) → Lähetä viesti
Tilauksen tarkistus	API-kutsu (verkkokauppa) → Aseta havainto

Vaihe 5: Palauta tulokset Aseta havainto -toiminnolla

Käytä Aseta havainto -toimintoa lähettääksesi tulokset takaisin AI:lle:

AI vastaanottaa havainnon ja käyttää sitä vastatakseen käyttäjälle.

Vaihe 6: Testaa työkalusi

Napsauta ▶ Testaus kokeillaksesi työkalua:

1. Luo testikeskustelu
2. Kirjoita viesti, joka laukaisee työkalusi
3. Katso, kuinka virta toteutuu
4. Varmista, että AI vastaa oikein

---

Esimerkki: Tuotehaku Työkalu

Tavoite: Anna käyttäjien etsiä tuotteita kysymällä luonnollisesti

Laukaisun määrittely:

• Nimi: searchProducts
• Kuvaus: "Etsi tuotekatalogista nimen, kategorian tai hinnan mukaan"
• Muuttujat: query (Merkkijono), maxPrice (Numero, valinnainen)

Virta:

Keskustelutyökalun laukaisin
    ↓
Etsi tietopankista
  → Kysely: {{trigger.query}}
  → Rajoita: 5 tulosta
    ↓
Aseta havainto
  → Tulokset: {{searchResults}}

Käyttäjäkokemus:

Käyttäjä: Onko teillä sinisiä widgettejä alle 50 €?

AI: Anna minun etsiä se...

    Löysin 3 sinistä widgettiä alle 50 €:
    1. Sininen Widget Perus - 29,99 €
    2. Sininen Widget Pro - 45,00 €
    3. Sininen Widget Mini - 19,99 €
    
    Haluatko lisätietoja jostakin näistä?

---

Esimerkki: JIRA-lipun luominen

Tavoite: Anna käyttäjien luoda tukilippuja keskustelusta

Laukaisun määrittely:

• Nimi: createTicket
• Kuvaus: "Luo tukilippu teknisiin ongelmiin"
• Muuttujat: title (Merkkijono), description (Merkkijono), priority (Merkkijono)

Virta:

Keskustelutyökalun laukaisin
    ↓
JIRA Luo ongelma
  → Projekti: SUPPORT
  → Tyyppi: Bug
  → Yhteenveto: {{trigger.title}}
  → Kuvaus: {{trigger.description}}
    ↓
Aseta havainto
  → "Lippu {{jiraIssue.key}} luotiin onnistuneesti"

---

Parhaat käytännöt

Selkeät työkalukuvaukset

Kirjoita kuvauksia, jotka auttavat AI:ta ymmärtämään, milloin käyttää kutakin työkalua:

// Hyvä
"Etsi tuotekatalogista nimen, kategorian tai hintahaarukan mukaan"

// Liian epämääräinen
"Etsi tuotteita"

Merkitykselliset muuttujan nimet

Käytä kuvaavia muuttujan nimiä ja kuvauksia:

Muuttuja	Kuvaus
customerEmail	Sähköpostiosoite tilauksen tarkistamiseksi
appointmentDate	Suositeltu päivämäärä tapaamiselle

Virheiden käsittely

Sisällytä virheiden käsittely havaintoihisi:

// Onnistuminen
{"found": true, "results": [...]}

// Ei tuloksia
{"found": false, "message": "Ei tuotteita, jotka vastaavat hakua"}

Testaa keskustellen

Testaa työkaluja keskustelemalla luonnollisesti, älä vain napsauttamalla painikkeita. Varmista, että AI:

• Kysyy tarvittavat muuttujat luonnollisesti
• Käyttää työkalua oikeaan aikaan
• Esittää tulokset selkeästi

---

Liittyvä dokumentaatio

• SmartFlow Johdanto — Opi solmukonstruktori
• Keskustelutyökalun laukaisin — Täydellinen laukaisun viite
• Havainnot — Datan palauttaminen AI:lle
• Toimintojen yleiskatsaus — Kaikki saatavilla olevat toiminnot