Keskustelutyökalu
Luo työkalu, jota AI voi käyttää keskustelujen aikana. AI päättää, milloin kutsua sitä kontekstin perusteella.
Make your AI agent ACT · build your first Tool
Milloin Käyttää
Käytä tätä laukaistaaksesi, mitä AI voi tehdä:
- Etsi tuotteita luettelostasi
- Tarkista tilauksen tila järjestelmässäsi
- Etsi asiakastietoja CRM:stä
- Luo tukipyyntöjä JIRA:ssa
- Varaa aikoja
- Mikä tahansa mukautettu kyky
Kokoonpano
Perusasetukset
| Kenttä | Kuvaus |
|---|---|
| Työkalun nimi | Ihmisten 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 + yhteydessä olevat käyttäjät |
| Vain yhteydessä olevat käyttäjät | Vain kirjautuneet 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 ovat saatavilla muodossa {{variableName}} työnkulussasi.
Kuinka Se Toimii
- Määrität työkalun nimen, kuvauksen ja muuttujat
- AI oppii, milloin käyttää sitä kuvauksestasi
- Käyttäjä kysyy jotain liittyvää (esim., "Etsi minulle kannettava tietokone")
- AI kerää tarvittavat muuttujat keskustellen
- Työnkulku suoritetaan kerätyillä tiedoilla
- 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 muuttujan kuvauksiin. Se ei näe, mitä työnkulussa 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ä pelkästään kuvauksen selkeyden parantaminen voi lisätä oikean työkalun valintaa 15–20 prosenttiyksikköä ilman, että perusmallia muutetaan.
Tämä on erityisen kriittistä, kun sinulla on useita työkaluja, jotka etsivät eri tietopohjia — AI:n näkökulmasta kaikki "etsivät tietoa." Nimi ja kuvaus ovat ainoa tapa, jolla se voi erottaa ne.
Työkalun Nimi
Käytä kaavaa domain_action_target, jotta nimi yksinään erottaa jokaisen työkalun:
| ❌ Epämääräinen | ✅ Selkeä |
|---|---|
Etsi | rgpd_legal_analysis |
search_docs | ecommerce_product_search |
Työkalu 2 | support_ticket_lookup |
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ääksesi rangaistuspäätöksiä sektorin tai rikkomustyypin mukaan,
etsimään sakkojen määriä, viittaamaan oikeudellisiin ennakkotapauksiin,
arvioimaan RGPD:n noudattamatta jättämisen taloudellista riskiä.
Sanoja "Käytä" -osiossa toimivat semanttisina laukaisimina. Kun käyttäjän viesti sisältää "sakko", "rangaistus" tai "riski", AI yhdistää sen heti tähän työkaluun.
Muuttujan Kuvaukset
Muuttuja, joka on kuvattu "Haku kysely", 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 kysely | Haku kysely: 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 uudelleen sen sijaan, että se kopioisi käyttäjän koko viestin — mikä johtaa tarkempiin hakuun ja parempiin tuloksiin.
Työkalujen Konfliktien 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 ajatella käyttäjäkysymystä, joka voisi mennä molempiin työkaluihin, kuvauksesi tarvitsevat tarkkuutta.
Esimerkki — 5 vaatimustyökalua, joilla on selkeät rajat:
| Työkalu | Kattaa | EI kata |
|---|---|---|
compliance_legal_analysis | Lakiartikkeleita, oikeudellisia velvoitteita, oikeuksia | Ei käytännön neuvoja, ei tosielämän tapauksia |
compliance_methodology | Askel askeleelta -oppaat, tarkastusmenettelyt, kehykset | Ei oikeudellista tekstiä, ei malleja |
compliance_document_templates | Valmiita malleja, lomakkeita, sopimusklauseja | Ei metodologiaa, ei oikeudellista analyysiä |
compliance_business_processes | Toiminnallisia työnkulkuja, hyväksymiskierroksia | Ei oikeudellista tekstiä, vain sisäisiä prosesseja |
compliance_operational_solutions | Konkreettisia ratkaisuja, teknisiä suosituksia | Ei teoriaa, vain toteuttamiskelpoisia ratkaisuja |
Mitä tarkempia jokainen kuvaus on 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 työnkulun, jossa on Keskustelutyökalun laukaisu, varmista:
- Nimi noudattaa
domain_action_target— erottuva ilman kuvauksen lukemista - Kuvaus alkaa siitä, mitä työkalu tekee 1 lauseessa
- Kuvaus sisältää "Käytä:" 3–5 konkreettista käyttötapausta
- Muuttujan kuvaukset listaavat odotettujen tietotyyppien, ei vain "kyselyn"
- Ei päällekkäisyyksiä toisen työkalun alueen kanssa
- Testattu 2–3 epäselvällä kysymyksellä Testipaneelissa oikean reitityksen varmistamiseksi
Esimerkki: Tuotehaku
Työkalun Kokoonpano:
- Nimi:
ecommerce_product_search - Kuvaus: Etsii tuotekatalogista nimen, kategorian tai ominaisuuden mukaan. Käytä: löytääksesi tietyn tuotteen, vertaillaksesi tuotteita kategoriassa, tarkistaaksesi, onko tuotetta olemassa, etsiäksesi tuotteen teknisiä tietoja tai hinnoittelua.
- Muuttuja:
query— "Tuotteen nimi, kategoria, ominaisuus tai hintahaarukka, jota etsitään"
Työnkulku:
- 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 ecommerce_product_search kyselyllä="langattomat kuulokkeet"
AI: "Kyllä! Löysin 3 langatonta kuuloketta. Sony WH-1000XM5 on myydyin hintaan 349 €..."
Esimerkki: JIRA-lippu
Työkalun Kokoonpano:
- Nimi:
support_create_jira_ticket - Kuvaus: Luo JIRA-tukilipun keskustelusta. Käytä: kun käyttäjä ilmoittaa virheestä, pyytää ominaisuutta tai tarvitsee ongelman eskaloimista 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"
Työnkulku:
- Laukaisin: Keskustelutyökalu
- Toiminto: AI-pyyntö (tuota otsikko/kuvaus)
- Rinnakkain: Tuota kuvaus + otsikko
- Toiminto: JIRA Luo Ongelma
