Keskustelutyökalu
Luo työkalu, jota AI voi käyttää keskustelujen aikana. AI päättää, milloin sitä kutsutaan kontekstin perusteella.
Milloin käyttää
Käytä tätä laukaisevaa tekijää laajentaaksesi, mitä AI voi tehdä:
- Etsi tuotteita luettelostasi
- Tarkista tilauksen tila järjestelmässäsi
- Etsi asiakastietoja CRM:stä
- Luo tukilippuja JIRA:ssa
- Varaa tapaamisia
- Mikä tahansa mukautettu kyky
Asetukset
Perusasetukset
| Kenttä | Kuvaus |
|---|---|
| Työkalun nimi | Ihmisen luettavissa oleva nimi (näkyy Solmukirjastossa) |
| Kuvaus | Selittää, milloin/kuinka AI:n tulisi käyttää tätä työkalua |
Käyttäjäkohdistus
Valitse, kuka voi käyttää tätä työkalua:
| Vaihtoehto | Kuvaus |
|---|---|
| Kaikki käyttäjät | Anonyymit + kirjautuneet käyttäjät |
| Vain kirjautuneet käyttäjät | Vain sisäänkirjautuneet käyttäjät |
| Roolipohjainen pääsy | Tietyt käyttäjäroolit |
Työkalun muuttujat
Määritä parametrit, jotka AI:n on kerättävä käyttäjältä:
| Kenttä | Kuvaus |
|---|---|
| Muuttujan nimi | Sisäinen nimi (esim. query, orderId) |
| Kuvaus | Auttaa AI:ta ymmärtämään, mitä kysyä |
Muuttujat tulevat saataville muodossa {{variableName}} prosessissasi.
Kuinka se toimii
- Määrität työkalun nimen, kuvauksen ja muuttujat
- AI oppii, milloin sitä käytetään kuvauksesi perusteella
- Käyttäjä kysyy jotain siihen liittyvää (esim. "Etsi minulle kannettava tietokone")
- AI kerää tarvittavat muuttujat keskustelun aikana
- Prosessi etenee kerättyjen tietojen avulla
- Tulokset palautuvat AI:lle lopullista vastausta varten
Työkalujen nimeäminen: Miksi se on tärkeää
Kun AI-avustajallasi on pääsy useisiin työkaluihin, se valitsee, mitä kutsua, perustuen vain kolmeen asiaan: työkalun nimeen, työkalun kuvaukseen ja muuttujien kuvauksiin. Se ei voi nähdä, mitä prosessissa on — se lukee tekstiä ja päättää.
Jos nämä kolme kenttää ovat epämääräisiä tai liian samankaltaisia eri työkaluissa, AI valitsee väärän työkalun. Tutkimukset LLM-funktioiden kutsumisesta osoittavat, että parantamalla kuvauksen selkeyttä voidaan yksin parantaa oikean työkalun valintaa 15–20 prosenttiyksikköä ilman, että taustamallia muutetaan.
Tämä on erityisen kriittistä, kun sinulla on useita työkaluja, jotka etsivät eri tietopohjia — AI:n näkökulmasta ne kaikki "etsivät tietoa." Nimi ja kuvaus ovat ainoa tapa, jolla se voi erottaa ne toisistaan.
Työkalun nimi
Käytä kaavaa domain_action_target, jotta nimi yksinään erottuu jokaisesta työkalusta:
| ❌ Epämääräinen | ✅ Selkeä |
|---|---|
Etsi | rgpd_oikeudellinen_analyysi |
etsi_dokumentit | verkkokauppa_tuote_haku |
Työkalu 2 | tukilippu_haku |
AI käyttää nimeä ensimmäisenä suodattimena ennen kuvauksen lukemista. Selkeä nimi mahdollistaa sen lyhentämisen heti; geneerinen nimi pakottaa sen arvaamaan.
Työkalun kuvaus
Kuvaus on voimakkain vipusi. Käytä tätä kaavaa:
[Mitä se tekee — 1 lause]
Käytä: [3–5 konkreettista käyttötapausta sanoilla, joita käyttäjäsi todella käyttäisivät]
❌ Huono:
Etsi tietopohjasta tietoa.
✅ Hyvä:
Etsii CNIL-sanktioita ja CJUE:n oikeuskäytäntöä.
Käytä: löytää rangaistuspäätöksiä sektorin tai rikkomustyypin mukaan,
etsii sakkojen määriä, lainopillisten ennakkotapausten siteeraamista,
arvioi RGPD:n noudattamatta jättämisen taloudellista riskiä.
Sanoja "Käytä" -osiossa toimivat semanttiset laukaisijat. Kun käyttäjän viesti sisältää "sakko", "rangaistus" tai "riski", AI yhdistää sen heti tähän työkaluun.
Muuttujien kuvaukset
Muuttuja, jota kuvataan "Haku kysymyksenä", ei kerro AI:lle mitään. Se liittää käyttäjän raakakysymyksen joka kerta. Parempi kuvaus ohjaa AI:ta poimimaan oikeat avainsanat ennen niiden lähettämistä.
| ❌ Epämääräinen | ✅ Selkeä |
|---|---|
Haku kysymys | Haku kysymys: rikkomustyyppi, yrityksen nimi, sektori, sakkomäärä tai oikeudellinen käsite |
Käyttäjän syöte | Pyydetty asiakirjatyyppi: malli, malli, lomake, klausuuli tai sopimus |
Tämä pakottaa AI:n muotoilemaan kysymyksen uudelleen sen sijaan, että se kopioisi käyttäjän koko viestin — mikä johtaa tarkempiin hakuun ja parempiin tuloksiin.
Työkalukonfliktien välttäminen
Kun kaksi työkalua voi vastata samaan kysymykseen, AI epäröi — ja joskus valitsee satunnaisesti. Jokaisen työkalun on katettava yksinoikeudellinen alue.
Sääntö: jos voit keksiä käyttäjäkysymyksen, joka voisi mennä kumpaankin työkaluun, kuvauksesi tarvitsee tarkkuutta.
Esimerkki — 5 vaatimustyökalua, joilla on selkeät rajat:
| Työkalu | Kattaa | EI kata |
|---|---|---|
vaatimusten_oikeudellinen_analyysi | Lain artikkeleita, oikeudellisia velvoitteita, oikeuksia | Ei käytännön neuvoja, ei tosielämän tapauksia |
vaatimusten_menetelmät | Askeltavat oppaat, tarkastustoimenpiteet, kehykset | Ei oikeudellista tekstiä, ei malleja |
vaatimusten_dokumenttimallit | Valmiita malleja, lomakkeita, sopimusklauseja | Ei metodologiaa, ei oikeudellista analyysiä |
vaatimusten_liiketoimintaprosessit | Operatiiviset työnkulut, hyväksymiskierrokset | Ei oikeudellista tekstiä, vain sisäisiä prosesseja |
vaatimusten_operatiiviset_ratkaisut | Konkreettiset korjaukset, tekniset suositukset | Ei teoriaa, vain toteuttamiskelpoisia ratkaisuja |
Mitä tarkempia jokaisen kuvauksen on oltava siitä, mitä työkalu kattaa, sitä vähemmän epäselvyyksiä on. Sinun ei tarvitse kirjoittaa eksplisiittisiä poissulkemisia — tarkkuus tekee työn.
Nopean tarkistuslista
Ennen kuin julkaiset prosessin, jossa on Keskustelutyökalun laukaisija, varmista:
- Nimi noudattaa
domain_action_target— erottuva ilman kuvauksen lukemista - Kuvaus alkaa siitä, mitä työkalu tekee yhdessä lauseessa
- Kuvaus sisältää "Käytä:" 3–5 konkreettista käyttötapausta
- Muuttujien kuvaukset luettelevat odotettavat tietotyypit, eivät vain "kysymyksen"
- Ei päällekkäisyyksiä toisen työkalun alueen kanssa
- Testattu 2–3 epäselvällä kysymyksellä Testipaneelissa oikean reitityksen varmistamiseksi
Esimerkki: Tuotehaku
Työkalun asetukset:
- Nimi:
verkkokauppa_tuote_haku - Kuvaus: Etsii tuotekatalogista nimen, kategorian tai ominaisuuden mukaan. Käytä: löytääksesi tietyn tuotteen, vertaillaksesi tuotteita kategoriassa, tarkistaaksesi, onko tuote olemassa, etsiäksesi tuoteominaisuuksia tai hintoja.
- Muuttuja:
query— "Tuotteen nimi, kategoria, ominaisuus tai hintahaarukka, jota etsitään"
Prosessi:
- Laukaisin: Keskustelutyökalu
- Toiminto: Etsi tietopohjasta (
{{query}}) - Toiminto: Aseta havainto (palauta tulokset)
Käyttäjän keskustelu:
Käyttäjä: "Onko teillä langattomia kuulokkeita?"
AI: kutsuu verkkokauppa_tuote_haku muuttujalla="langattomat kuulokkeet"
AI: "Kyllä! Löysin 3 langatonta kuuloketta. Sony WH-1000XM5 on meidän myydyin hintaan 349 €..."
Esimerkki: JIRA-lippu
Työkalun asetukset:
- Nimi:
support_create_jira_ticket - Kuvaus: Luo JIRA-tukilippu keskustelusta. Käytä: kun käyttäjä ilmoittaa virheestä, pyytää ominaisuutta tai tarvitsee asian nostamista tekniselle tiimille.
- Muuttujat:
title— "Ongelman lyhyt yhteenveto (1 lause)",description— "Yksityiskohtainen kuvaus, mukaan lukien toimenpiteet toistamiseen, odotettu käyttäytyminen ja todellinen käyttäytyminen"
Prosessi:
- Laukaisin: Keskustelutyökalu
- Toiminto: AI-pyyntö (tuota otsikko/kuvaus)
- Rinnakkain: Tuota kuvaus + otsikko
- Toiminto: JIRA Luo ongelma
