# AI-malli ja BYOK Tällä sivulla kerrotaan, mikä AI-malli pyörittää bottiasi, miksi vain yhtä palveluntarjoajaa tuetaan **BYOK (Bring Your Own Key)** -toiminnossa ja miten määrität oman avaimen, jos tilauksesi sisältää sen. --- ## Mikä AI-malli pyörittää bottia Alusta käyttää **Anthropic Claudea** bottisi ensisijaisena mallina. Claude valittiin, koska laajojen, kaikkia markkinoiden merkittävimpiä frontier-malleja (alan termi edistyneimmille saatavilla oleville tekoälymalleille) koskevien testausten jälkeen se on ainoa, joka käsittelee tuotannon viestintämäärät luotettavasti. Sinun ei tarvitse valita mallia. Alusta valitsee automaattisesti oikean mallin kullekin tehtävälle ja optimoi sen käytön taustalla (mukaan lukien edistynyt kehotteiden välimuisti, joka vähentää merkittävästi keskustelukohtaisia kustannuksia). --- ## Miksi vain Anthropic BYOK-toiminnossa Asiakkaat kysyvät usein, lisäämmekö tuen OpenAI:lle, Google Geminille, OpenRouterille tai avoimen lähdekoodin malleille BYOK-käyttöä varten. Rehellinen vastaus on: mikään niistä ei sellaisenaan ja optimoimattomana kestä tuotantotason volyymia. **Pienessä projektissa 9/10 onnistumisprosentti tekoälyltä on riittävä.** Kun käytät todellisia asiakaskeskusteluja laajassa mittakaavassa, 10 % virheprosentti tarkoittaa epäonnistuneita varauksia, vääriä vastauksia, väliin jääneitä seurantoja ja menetettyjä myyntejä. Tämä on suunnilleen samaa luokkaa kuin mitä näemme muiden tarjoajien huipputason frontier-malleilla (noin 6–10 % haastavissa reunatapauksissa, eli hankalissa, tarkoituksella vaikeissa testikysymyksissä) – ja tämä on ennen kuin otetaan huomioon halvemmat mallit. Ongelmat jakautuvat kolmeen luokkaan: - **Reunaehdot rikkovat mallin arvaamattomasti.** Malli voi toimia täydellisesti sadoissa keskusteluissa, mutta yhtäkkiä hallusinoida työkalukutsun, väittää tehneensä jotain, mitä se ei tehnyt, tai unohtaa ohjeet kesken keskustelun. - **Pitkää kontekstia käsitellään huonosti.** Yksittäinen botin vastaus käyttää keskusteluhistoriaa, UKK-tietoja, jatkotoimenpidelogiikkaa, työkalukutsuja ja päättelyä. Useimmat mallit tukehtuvat tähän tietomäärään ja tuottavat huonompaa jälkeä. - **"Halvempi" on harvoin sitä.** Alhaisempi token-hinta kompensoituu useammilla uudelleenyrityksillä, suuremmalla määrällä tulostokeneita ja huonommalla konversiolla. Todelliset kustannukset onnistunutta keskustelua kohden ovat lopulta korkeammat. 100 eri mallin tukeminen on enemmän markkinointipuhetta kuin todellinen kyvykkyys. Tarjoamme mieluummin yhden palveluntarjoajan, joka toimii luotettavasti, kuin viisi, joista jokainen rikkoutuu eri tavoin. --- ## Oma mallimme: Max Rakensimme oman sisäisen mallimme, **Maxin** — sisäisen mallin sekä monivaiheisen optimointipinon, jota on hiottu alustan todellisella keskusteludatalla. Tavoitteena oli malli, joka on huomattavasti kustannustehokkaampi kuin Claude, mutta pysyy luotettavana alustalla käytettävissä keskustelumalleissa. Juuri tämän Max tarjoaa: murto-osan Pro-hinnasta (0,25 krediittiä per toiminto), ja se on hienosäädetty pysymään tarkkana siellä, missä tavallinen budjettimalli epäonnistuu. Max ei vaadi käyttöönottoa – ei mallin valintaa, ei palveluntarjoajan tiliä eikä avainta. Se toimii kokonaan meidän infrastruktuurissamme, ja se on tarkin toimittamamme malli: omien vertailutestiemme mukaan se noudattaa parhaiten sitä, mitä yrityksesi todellisuudessa sanoo. Katso täydellinen erittely siitä, miten Max vertautuu Claudeen ja niihin edullisiin kolmannen osapuolen malleihin, joista asiakkaat usein kysyvät – mukaan lukien se, mitä kyseiset mallit tekivät testeissämme väärin – kohdasta [Miksi Max on paras vaihtoehto](ai-model-comparison.md). ### Kuka näkee Max-tason Jos Agentin **AI-ohjeet**-välilehden **AI-laadun** valitsin näyttää vain **Pro**- ja **Economy**-vaihtoehdot, Max ei ole käytössä tilillä, jolle olet kirjautunut. Kaksi asiaa kytkevät sen päälle: - **Käyttäjätilit, joilla on oikeutettu elinikäinen tilaus**, saavat Max-ominaisuuden automaattisesti. - **Kaikkien muiden tilien** kohdalla Max on otettava käyttöön erikseen. > **Viraston tarjoamalla tilillä palveluntarjoajasi on saattanut valita mallin puolestasi.** Jos tekoälyn laadunvalitsin näyttää vain yhden kortin eikä vaihtoehtoja ole, kyseessä on tilisi tietoinen asetus, ei virhe – pyydä tilisi tarjoajaa muuttamaan sitä. Jos kortti näkyy edelleen huomautuksella, että se ei ole enää käytettävissä, agenttisi käyttää mallia, jonka palveluntarjoajasi on sittemmin poistanut: se vastaa edelleen, mutta jollakin sallituista malleista. Valitse siis jokin niistä, jotta valitsin vastaa todellisuudessa käytössä olevaa mallia. > Oman Anthropic-avaimen yhdistämisellä (BYOK) **ei ole mitään** tekemistä sen kanssa, onko Max näkyvissä. Nämä kaksi toimivat rinnakkain – katso poikkeushuomautus kohdasta [BYOK:n määrittäminen](#setting-up-byok), miten Max-Agent laskutetaan, kun avain on yhdistetty. API-avaimen poistaminen ei saa Maxia näkyviin. ### Mini-taso Jos näet Maxin, näet myös **Minin**, hintaan **0,15 krediittiä per toiminto**. Mini on sama tekoäly kuin Max, mutta edullisemmin ja kahdella kompromissilla: - **Suurempi virheiden mahdollisuus.** Mini on näistä kahdesta kevyempi malli. Max on tarkin toimittamamme malli – se on optimoitu pysymään mahdollisimman tiukasti siinä, mitä yrityksesi todellisuudessa sanoo – kun taas Minin kohdalla on suurempi mahdollisuus, että vastaukseen lipsahtaa pieni virhe tai hallusinaatio. - **Kevyempi muisti.** Pitkissä keskusteluissa Mini muistaa vähemmän vanhoja viestejä ja hakee vähemmän tietokannan katkelmia vastausta kohden. Max on edelleen suositeltu valinta kaikkeen, missä väärä yksityiskohta voi maksaa kaupan — varaukset, hinnoittelukysymykset, tuki, jossa on panoksia. Mini sopii suuren volyymin, hintatietoisiin keskusteluihin, joissa nopeus ja kustannukset ovat tärkeämpiä kuin viimeinen prosentti tarkkuudesta. Mini löytyy samasta tekoälyn laadunvalitsimesta kuin Max jokaiselta tililtä, jolla on Max käytössä. Kuten Max, myös Mini toimii kokonaan meidän infrastruktuurissamme eikä koskaan käytä BYOK-avainta, joten yhdistettyä Anthropic-avainta ei käytetä (eikä laskuteta), kun Agentti käyttää Miniä. **Mitä 0.15 Mini-hinta kattaa.** Mini-hinta koskee kaikkea, mitä tapahtuu live-keskustelun aikana: tekoälyn vastauksia, tekoälyn työkalukutsuja (kuten ajanvaraus tai ihmiselle ilmoittaminen), keskustelujen arviointia (päätös siitä, pitäisikö keskustelu jättää huomiotta tai sulkea), keskeytysten käsittelyä (kun yhteyshenkilö lähettää uuden viestin botin vielä kirjoittaessa vastaustaan), keskustelujen yhteenvetoja ja tekoälyn automaattista tägäämistä. Keskustelun ulkopuolisilla kertaluonteisilla tekoälyominaisuuksilla – kampanjaoptimoinnilla, tietokannan luomisella ja API:n kautta tehdyllä tägäämisellä – on kiinteä 0.25 krediitin hinta sekä Max- että Mini-malleissa, joten saatat nähdä satunnaisia 0.25 merkintöjä krediittihistoriassasi, vaikka jokainen agentti olisi asetettu Mini-tilaan. Nämä ovat kyseisiä ominaisuuksia, eivät Max-mallin vastauksia keskusteluihisi. --- ## BYOK-toiminnon määrittäminen BYOK sisältyy **Agency**- ja **Agency Unlimited** -tilauksiin sekä AppSumon elinikäisiin tasoihin **Plan 2**:sta ylöspäin. Se ei kuulu Business-tilaukseen. Jos tilauksesi sisältää sen, voit yhdistää oman Anthropic API -avaimesi (yksityinen koodi Anthropic-tililtäsi, jonka avulla alusta laskuttaa tekoälyn käytöstäsi suoraan sinua alustan krediittien käyttämisen sijaan). > **Vain viralliset Anthropic-avaimet toimivat.** Kelvollinen avain on peräisin omalta tililtäsi osoitteessa console.anthropic.com ja alkaa aina merkkijonolla `sk-ant-`. Jälleenmyyjien, välityspalvelinten tai "alennushintaisia Claude API" -sivustoja tarjoavien palveluiden avaimet (jotka alkavat usein eri etuliitteellä) eivät ole tuettuja, eikä niitä voi tallentaa. Ole varovainen tarjousten suhteen, joissa Claude-tunnuksia myydään huomattavasti Anthropicin omia hintoja halvemmalla – kukaan ei voi laillisesti jälleenmyydä Claude-käyttöoikeutta Anthropicin veloittamaa hintaa halvemmalla, ja kyseiset tarjoukset ovat lähes poikkeuksetta huijauksia, jotka perustuvat varastettuihin avaimiin tai joiden tarkoituksena on kalastella maksutietojasi. > **Käytätkö puhelinta?** Vasen sivupalkki saattaa olla piilotettuna. Napauta ensin valikkokuvaketta (**☰**) ja napauta sitten **Asetukset**. > **Etkö näe BYOK API-avaimia Lisäasetukset-ryhmässä?** Kyseinen osio näkyy vain tilauksissa, jotka sisältävät BYOK-ominaisuuden. Jos tilisi on palveluntarjoajan hallinnoima, se näkyy vain, kun he ovat kytkeneet **Bring Your Own API Key** -ominaisuuden päälle tilillesi. 1. Napsauta vasemmassa sivupalkissa **Asetukset** (rataskuvake alareunan lähellä). 2. Vieritä Asetukset-sivun vasemmassa valikossa **Lisäasetukset**-ryhmään. 3. Napsauta **BYOK API -avaimet**. 4. Napsauta **Add key** Anthropic-kortissa. Näkyviin tulee **Secret key** -kenttä (paikkamerkki `sk-ant-…`). 5. Liitä Anthropic API -avaimesi kenttään ja napsauta sitten **Save key**. Kun ominaisuus on käytössä, bottisi käyttää omaa avaintasi tekoälykutsuissa, ja maksat kyseisestä käytöstä suoraan Anthropicille sen sijaan, että käyttäisit alustan krediittejä tekoälyvastauksiin. Kanavainfrastruktuuri (WhatsApp Web -palvelimet, puhelinnumerot jne.) käyttää edelleen krediittejä tavalliseen tapaan. > **Yksi poikkeus – Max-taso.** Jos Agentin AI-laaduksi on asetettu **Max**-taso, kyseinen Agentti toimii kokonaan meidän omassa infrastruktuurissamme ja se laskutetaan 0,25 krediittiä per toiminto, vaikka BYOK olisi yhdistetty – Max ei koskaan käytä Anthropic-avaintasi. (Sama pätee **Mini**-tasoon, jos se on saatavilla: 0,15 krediittiä per toiminto, ei koskaan avaintasi.) Jos haluat laskuttaa vastaukset omalle Anthropic-tilillesi, pidä Agentti **Pro**-tasolla (vakio). **AI-laadun** valitsin löytyy jokaisen Agentin **AI-ohjeet**-välilehdeltä. **BYOK API-avaimet** -asetussivulla näkyy ilmoitus aina, kun avain on tallennettu, mutta yksi tai useampi Agentti käyttää yhä Max-tasoa, ja siinä listataan kyseiset Agentit – näin näet yhdellä silmäyksellä, miksi krediittejä kuluu edelleen. **Huomautus kustannuksista:** Oman avaimen tuominen ei ole enää halvin vaihtoehto. Kun avain on yhdistetty, agenttisi toimii Claudella ja maksat Anthropicin käytön mukaiset hinnat suoraan (Anthropic laskuttaa sinua todellisen käytön mukaan, samalla tavalla kuin sähkölaskua). Oman avaimen käyttävien tilien kohdalla yksi tekoälyn vastaus maksaa karkeasti ottaen kolme kertaa enemmän kuin sama vastaus Max-mallilla ja yli viisi kertaa enemmän kuin Mini-mallilla, kun otetaan huomioon vastauksen käynnistämä taustatyö (tietokantahaku, roskapostin tarkistus, nimen ja sähköpostin poiminta, keskustelujen arviointi, tägääminen). Kaikki tämä sisältyy Max- ja Mini-mallien kiinteään hintaan, mutta laskutetaan token-pohjaisesti omalla avaimellasi. Kehotteiden välimuistioptimointimme (prompt-caching) koskevat myös omaa avaintasi, joten kyse ei ole välimuistin puutteesta; Max ja Mini ovat yksinkertaisesti paljon halvempia malleja, jotka saavat myös paremmat pisteet myyntikeskustelujen vertailutestissämme. Käytä BYOK-vaihtoehtoa (Bring Your Own Key) silloin, kun haluat nimenomaan, että tekoälyn käyttö laskutetaan omalta Anthropic-tililtäsi, ei rahan säästämiseksi. > **Miksi keskustelun ensimmäinen vastaus maksaa huomattavasti enemmän kuin muut.** Välimuisti toimii tallentamalla keskustelun kontekstin Anthropicille ensimmäisellä lähetyskerralla ja käyttämällä sitä sen jälkeen uudelleen. Sen kirjoittaminen maksaa enemmän kuin tavallinen pyyntö; jokainen vastaus, joka käyttää sitä uudelleen, maksaa noin kahdeskymmenesosan alkuperäisestä. Siksi ensimmäinen vastaus näyttää hälyttävän kalliilta ja sitä seuraavat ovat erittäin halpoja. Kaikki keskustelun suuri sisältö kasvattaa ensimmäistä vastausta – erityisesti käyttäjän lataama tiedosto. 24-sivuinen PDF-tiedosto vastaa noin 70 000 tokenia, koska jokainen sivu lähetetään sekä tekstinä että kuvana, ja se pysyy keskustelussa, joten se lähetetään (ja välimuistitetaan) uudelleen jokaisen vastauksen yhteydessä. Jos keskustelu on hiljaa yli tunnin, tallennettu kopio vanhenee ja seuraava vastaus maksaa kirjoitusmaksun uudelleen. > > Jos rakennat jotain asiakirjapainotteista – sopimusten selittäjiä, käyttöohjeiden hakuja tai mitä tahansa, missä ihmiset lataavat tiedostoja – **Max**-taso on yleensä parempi vaihtoehto: se on kiinteä 0,25 krediittiä per vastaus riippumatta asiakirjan koosta, joten ensimmäisen viestin piikkiä tai token-kohtaista riskiä ei ole. Katso [Miksi Max on paras vastine rahalle](ai-model-comparison.md) nähdäksesi, miten Max vertautuu laadun ja kustannusten osalta. **Jos BYOK-avaimesi toiminta epäonnistuu (se on virheellinen, kiintiö on täynnä tai nopeusrajoitettu – eli Anthropic on väliaikaisesti rajoittanut avaimellasi tehtävien pyyntöjen määrää), botin toiminnan jatkuminen riippuu samalla BYOK API -avaimet -sivulla olevasta "Fallback to credits" (käytä krediittejä varajärjestelmänä) -valitsimesta:** - **Päällä:** alusta käyttää väliaikaisesti alustan krediittejä, jotta bottisi vastaa edelleen, ja yrittää samalla taustalla käyttää avaintasi uudelleen – heti kun kutsu onnistuu, se vaihtaa automaattisesti takaisin omaan avaimeesi. - **Pois päältä** *(oletus)*: AI-vastaukset estetään, kunnes korjaat avaimen. Krediittejäsi ei käytetä huomaamatta, mutta bottisi lakkaa myös vastaamasta. Jos haluat botin jatkavan toimintaansa krediiteillä sillä välin kun selvität avainasiaa, kytke tämä valitsin päälle etukäteen. Saat joka tapauksessa sähköpostiviestin ensimmäisellä kerralla, kun avaimen käyttö epäonnistuu (ei viestikohtaisesti). --- ## Usein kysyttyä **Voinko käyttää OpenAI:ta, Geminiä tai muuta palveluntarjoajaa BYOK-ratkaisussa?** Ei tällä hetkellä muiden palveluntarjoajien osalta. Useimmille vastaus löytyy jo tästä: **Max** ja **Mini** ovat omia sisäisiä tasojamme, joiden hinta on 0,25 ja 0,15 krediittiä per toiminto. **Käytetäänkö BYOK-avaintani kaikkeen?** Useimmat tekoälytoiminnot ovat krediittimaksuista vapaita, kun oma Anthropic-avaimesi (BYOK) on yhdistetty: tekoälyvastaukset, työkalujen käyttö, kampanjoiden optimointi, tietokannan luominen ja verkkohaku toimivat kaikki avaimellasi. Neljä asiaa maksaa edelleen krediittejä, vaikka avain olisi yhdistetty: Max-taso (0,25 krediittiä per toiminto) ja Mini-taso (0,15 krediittiä per toiminto), koska molemmat käyttävät omia mallejamme; Lead Finder (0,25 per löydetty sähköpostiosoite); sekä automaatiot (0,25 per suoritus plus 0,25 per tekoälyvaihe). Jos haluat pitää agentin täysin omalla avaimellasi 0 krediitin kustannuksella, jätä se Pro-tasolle. Kanavamaksut (WhatsApp Webin kuukausimaksu, WhatsAppin viestikohtaiset toimitus- ja mallimaksut) laskutetaan joka tapauksessa erikseen tekoälyn käytöstä. Jos avain epäonnistuu kutsussa, joka olisi muuten toiminut sillä, riippuu alustan siirtyminen krediittien käyttöön **Fallback to credits** -valinnastasi – katso tällä sivulla aiemmin kuvattu "Fallback to credits" -valinta. **Milloin tekoälyvastaukset maksavat tasan 0 krediittiä?** BYOK (Bring Your Own Key) on tilikohtainen. Tekoälyvastaukset maksavat 0 krediittiä vain silloin, kun **tämä tili** on yhdistänyt **oman** Anthropic-avaimensa. Ilman omaa avainta vastaukset kuluttavat krediittejä normaalilla hinnalla. **Vaikuttaako BYOK viestien toimitukseen tai kanavan luotettavuuteen?** Ei. BYOK muuttaa vain sen, miten bottisi tekoälykutsut laskutetaan. Kaikki muu – viestien reititys, kanavainfrastruktuuri, seurannat, kampanjat ja lähetykset – toimii täsmälleen samalla tavalla. --- Katso myös: [Miksi Max on paras vastine rahalle](ai-model-comparison.md) · [Tekoälybotin määrittäminen](ai-bot-setup.md) · [Tekoälyagentit](../ai-agents/ai-agents.md)