Your AI Connector Docs

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 pitää keskustelukohtaiset kustannukset alhaisina.


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.


Max

Max on rakennettu alustan varsinaisia myynti- ja tukikeskusteluja varten. Se maksaa murto-osan Pro-hinnasta (0,25 krediittiä per toiminto) ja pysyy tarkkana siellä, missä budjettimallit epäonnistuvat.

Max ei vaadi käyttöönottoa: ei mallin valintaa, ei palveluntarjoajan tiliä eikä avainta. Se on tarkin toimittamamme malli ja paras pysymään siinä, mitä yrityksesi todella sanoo. Lisätietoja Maxin vertailusta Claudeen ja asiakkaiden usein kysymiin kolmannen osapuolen budjettimalleihin löydät kohdasta Miksi Max on paras vaihtoehto.

Kuka näkee Max-tason

Jos agenttisi AI-ohjeet-välilehden AI-laadun valitsin näyttää Pro-vaihtoehdon, mutta ei Max- tai Mini-vaihtoehtoja, Max ei ole käytössä kirjautumallasi tilillä. 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, 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, kaikilta tileiltä, joilla on Max käytössä. Kuten Max, myöskään Mini ei 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 – agentin optimoinnilla (Optimoi tekoälyllä), tietokannan luomisella ja API:n kautta tehdyllä tägäämisellä – on kiinteä 0.25 krediitin hinta sekä Max- että Mini-tasoilla, joten saatat nähdä krediittihistoriassasi satunnaisia 0.25 merkintöjä, vaikka jokainen agentti olisi asetettu Mini-tasolle. Nämä koskevat kyseisiä ominaisuuksia, eivät sitä, että Max-malli vastaisi 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.
  1. Napsauta Add key Anthropic-kortissa. Näkyviin tulee Secret key -kenttä (paikkamerkki sk-ant-…).
  1. Liitä Anthropic API -avaimesi kenttään ja napsauta sitten Save key.

Kun tämä on käytössä, Pro-tason tekoälyn laadulla varustetut agentit käyttävät vastauksiinsa omaa avaintasi, ja maksat käytöstä suoraan Anthropicille sen sijaan, että käyttäisit alustan krediittejä näihin vastauksiin. Max- tai Mini-tason agentit eivät koskaan käytä avaintasi ja käyttävät edelleen krediittejä (katso poikkeus alta). Kanavien infrastruktuuri (WhatsApp Web -palvelimet, puhelinnumerot jne.) käyttää edelleen krediittejä tavalliseen tapaan.

Yksi poikkeus – Max-taso. Jos agentin tekoälyn laaduksi on asetettu Max-taso, kyseistä agenttia laskutetaan 0,25 krediittiä per toiminto, vaikka BYOK olisi yhdistetty – Max ei koskaan käytä Anthropic-avaintasi. (Sama koskee Mini-tasoa, jos se on käytettävissä: 0,15 krediittiä per toiminto, ei koskaan avaintasi.) Jos haluat laskuttaa vastaukset omalta Anthropic-tililtäsi, pidä agentti Pro-tasolla. Tasot ovat Max, Pro ja Mini; erillistä Standard-tasoa ei ole. Tekoälyn laadun valitsin löytyy jokaisen agentin Tekoälyn ohjeet -välilehdeltä. BYOK API -avaimet -asetussivulla näkyy ilmoitus aina, kun avain on tallennettu, mutta yksi tai useampi agentti käyttää edelleen Max-tasoa. Sivulla luetellaan kyseiset agentit, jotta näet yhdellä silmäyksellä, miksi krediittejä kuluu edelleen.

Huomautus kustannuksista: Oman avaimen tuominen (BYOK) 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, kuten sähkölaskun). Oman avaimen käyttäjien kohdalla yksi tekoälyvastaus maksaa karkeasti kolme kertaa enemmän kuin sama vastaus Maxilla ja yli viisi kertaa enemmän kuin Minillä, kun otetaan huomioon vastauksen laukaisemat taustatoiminnot (tietokantahaku, roskapostin tarkistus, nimen ja sähköpostin poiminta, keskustelujen arviointi, tägäys). Kaikki nämä sisältyvät Maxin ja Minin kiinteään hintaan, mutta laskutetaan avainta käytettäessä token-kohtaisesti. Max ja Mini ovat yksinkertaisesti paljon halvempia, ja Max on lisäksi tarkin toimittamamme malli. Käytä BYOK-vaihtoehtoa vain, jos haluat nimenomaan tekoälyn käytön laskutettavan omalle Anthropic-tilillesi, et säästääksesi rahaa.

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 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-vaihtoehdossa? Muut palveluntarjoajat eivät ole tällä hetkellä tuettuja. Useimmille vastaus löytyy jo tästä: Max ja Mini, 0,25 ja 0,15 krediittiä per toiminto.

Käytetäänkö BYOK-avaintani kaikkeen? Useimmat tekoälytoiminnot ovat ilmaisia (eivät kuluta krediittejä), kun oma Anthropic-avaimesi (BYOK) on yhdistetty: tekoälyvastaukset, työkalujen käyttö, agentin optimointi, tietokannan luominen ja verkkohaku toimivat avaimellasi. Neljä asiaa kuluttaa edelleen krediittejä, vaikka avain olisi yhdistetty: Max-taso (0,25 krediittiä per toiminto) ja Mini-taso (0,15 krediittiä, sisältää tietokannan tuonnin Max-tilaan asetettuun agenttiin, 0,25 per lohko); Lead Finder (0,25 per löydetty sähköpostiosoite); sekä automaatiot (0,25 per ajo 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, viestikohtaiset WhatsApp-toimitus- ja mallimaksut) laskutetaan joka tapauksessa erikseen tekoälyn käytöstä. Jos avain epäonnistuu kutsussa, joka olisi pitänyt suorittaa sillä, riippuu alustan siirtyminen krediittien käyttöön Siirry krediitteihin -valintakytkimestäsi – katso “Siirry krediitteihin” -valintakytkimen kuvaus tämän sivun yläpuolelta.

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 ja lähetykset – toimii täsmälleen samalla tavalla.


Katso myös: Miksi Max on paras vastine rahalle · Tekoälybotin määrittäminen · Tekoälyagentit