Your AI Connector Docs

Model AI și BYOK

Această pagină explică ce model AI alimentează botul tău, de ce este acceptat un singur furnizor pentru BYOK (Bring Your Own Key - Adu propria cheie) și cum să îți configurezi propria cheie dacă planul tău include acest lucru.


Ce model AI alimentează botul

Platforma utilizează Anthropic Claude ca model principal pentru botul tău. Claude a fost ales deoarece, după teste extinse asupra fiecărui model de frontieră major (termen industrial pentru cele mai avansate modele AI disponibile) de pe piață, este singurul care gestionează fiabil volumul de mesaje în producție.

Nu trebuie să alegeți un model. Platforma îl alege automat pe cel potrivit pentru fiecare sarcină și menține costul per conversație la un nivel scăzut.


De ce doar Anthropic pentru BYOK

Clienții întreabă adesea dacă vom adăuga suport pentru OpenAI, Google Gemini, OpenRouter sau modele open-source pentru BYOK. Răspunsul sincer este: niciunul dintre acestea, utilizate în stare brută și neoptimizată, nu rezistă la volumul de producție.

Pentru un proiect mic, o rată de succes de 9 din 10 din partea unui AI este acceptabilă. Odată ce rulezi conversații reale cu clienții la scară largă, o rată de eșec de 10% înseamnă rezervări ratate, răspunsuri greșite, follow-up-uri omise și vânzări pierdute. Aceasta este aproximativ valoarea pe care o observăm chiar și la modelele de frontieră de top de la alți furnizori (aproximativ 6–10% în cazuri limită adversariale, adică întrebări dificile, create intenționat pentru a fi grele) — și asta înainte de a lua în considerare modelele mai ieftine.

Problemele se împart în trei categorii:

  • Cazurile limită eșuează imprevizibil. Un model poate funcționa perfect pentru sute de chat-uri, apoi să halucineze brusc un apel de instrument, să pretindă că a făcut ceva ce nu a făcut sau să ignore instrucțiunile în mijlocul conversației.
  • Contextul lung este gestionat prost. Un singur răspuns al botului utilizează istoricul chat-ului, întrebările frecvente, logica de follow-up, apelurile de instrumente și raționamentul. Majoritatea modelelor se blochează la acest volum și produc rezultate mai slabe.
  • „Mai ieftin” este rar adevărat. Prețul mai mic per token este compensat de mai multe reîncercări, mai multe token-uri de ieșire și o conversie mai slabă. Costul real per conversație reușită ajunge să fie mai mare.

Suportarea a 100 de modele diferite este mai mult un argument de marketing decât o capacitate reală. Preferăm să îți oferim un furnizor care funcționează fiabil decât cinci care se defectează fiecare în moduri diferite.


Max

Max este creat pentru conversațiile de vânzări și asistență pe care platforma le desfășoară efectiv. Costă o fracțiune din prețul Pro (0,25 credite per acțiune) și rămâne precis acolo unde un model de buget dă greș.

Max nu necesită configurare: nicio alegere de model, niciun cont de furnizor, nicio cheie. Este cel mai precis model pe care îl oferim și cel mai bun la a respecta ceea ce spune afacerea dumneavoastră. Pentru a vedea cum se compară Max cu Claude și cu modelele de buget de la terți despre care clienții întreabă adesea, consultați De ce Max este cea mai bună valoare.

Cine vede nivelul Max

Dacă selectorul Calitate AI din fila Instrucțiuni AI a Agentului dumneavoastră afișează Pro, dar nu și Max sau Mini, înseamnă că Max pur și simplu nu este activat pentru contul în care sunteți conectat. Două lucruri îl activează:

  • Conturile cu un plan pe viață eligibil primesc Max automat.
  • Orice alt cont are nevoie ca Max să fie activat explicit pe acesta.

În cazul unui cont furnizat de o agenție, este posibil ca furnizorul tău să fi ales modelul pentru tine. Dacă selectorul de Calitate AI afișează un singur card și nu există nimic la care să poți comuta, aceasta este o setare deliberată a contului tău, nu o eroare — cere celui care îți furnizează contul să o modifice. Dacă un card este în continuare afișat cu o notă care indică faptul că nu mai este disponibil, Agentul tău folosește un model pe care furnizorul l-a eliminat între timp: acesta continuă să răspundă, dar folosind unul dintre modelele pe care le permite, așa că alege unul dintre acestea pentru ca selectorul să corespundă cu ceea ce rulează efectiv.

Conectarea propriei chei Anthropic (BYOK) nu are nicio legătură cu vizibilitatea Max. Cele două funcționează împreună — consultă nota de excepție din Configurarea BYOK pentru a vedea cum este facturat un Agent Max atunci când ai o cheie conectată. Eliminarea cheii API nu va face ca Max să apară.

Nivelul Mini

Dacă poți vedea Max, poți vedea și Mini, la 0,15 credite per acțiune. Mini este același AI ca Max, la un preț mai mic, cu două compromisuri:

  • O probabilitate mai mare de erori. Mini este modelul mai ușor dintre cele două. Max este cel mai precis model pe care îl oferim — optimizat riguros pentru a respecta ceea ce spune efectiv afacerea ta — în timp ce, în cazul Mini, există o probabilitate mai mare ca o mică eroare sau halucinație să apară într-un răspuns.
  • Memorie mai redusă. În conversațiile lungi, Mini reține mai puține mesaje vechi și extrage mai puține fragmente din baza de cunoștințe pentru fiecare răspuns.

Max rămâne alegerea recomandată pentru orice situație în care un detaliu greșit poate costa o vânzare — rezervări, întrebări despre prețuri, asistență cu mize reale. Mini se potrivește conversațiilor cu volum mare, sensibile la preț, unde viteza și costul contează mai mult decât ultimul procent de acuratețe.

Mini se află în același selector de Calitate AI ca și Max, în fiecare cont care are Max. La fel ca Max, Mini nu folosește niciodată o cheie BYOK, deci o cheie Anthropic conectată nu este utilizată (și nu este facturată) cât timp un Agent folosește Mini.

Ce acoperă tariful Mini de 0,15. Prețul Mini se aplică la tot ce se întâmplă în cadrul unei conversații live: răspunsuri AI, apeluri de instrumente AI (cum ar fi programarea unei întâlniri sau alertarea unui operator uman), evaluări ale chat-ului (decizia dacă o conversație trebuie ignorată sau închisă), gestionarea întreruperilor (când un contact trimite un mesaj nou în timp ce botul încă își compune răspunsul), rezumate ale chat-ului și etichetarea automată AI. Funcțiile AI unice din afara conversației — optimizarea agentului (Optimize with AI), generarea bazei de cunoștințe și etichetarea efectuată prin API — au un tarif fix unic de 0,25 credite atât pe Max, cât și pe Mini, deci este posibil să vedeți ocazional intrări de 0,25 în istoricul creditelor, chiar și atunci când fiecare Agent este setat pe Mini. Acelea sunt acele funcții, nu modelul Max care răspunde la chat-urile dumneavoastră.


Configurarea BYOK

BYOK este inclus în planurile Agency și Agency Unlimited, precum și în nivelurile pe viață AppSumo începând cu Plan 2. Acesta nu face parte din planul Business. Dacă planul tău îl include, poți conecta propria cheie API Anthropic (un cod privat din contul tău Anthropic care permite platformei să îți factureze utilizarea AI direct ție, în loc să folosească creditele platformei).

Doar cheile oficiale Anthropic funcționează. O cheie validă provine din propriul tău cont de pe console.anthropic.com și începe întotdeauna cu sk-ant-. Cheile de la revânzători, proxy-uri sau site-uri de „API Claude cu reducere” (care încep adesea cu un prefix diferit) nu sunt acceptate și nu vor fi salvate. Fii atent la ofertele de tokenuri Claude ieftine, mult sub prețurile practicate de Anthropic — nimeni nu poate revinde în mod legitim accesul la Claude sub prețurile percepute de Anthropic, iar acele oferte sunt aproape întotdeauna escrocherii bazate pe chei furate sau create pentru a-ți obține datele de plată prin phishing.

Ești pe telefon? Bara laterală stângă poate fi ascunsă. Atinge mai întâi pictograma de meniu (☰), apoi atinge Settings.

Nu vezi Cheile API BYOK în grupul Avansat? Secțiunea apare doar în planurile care includ BYOK. Dacă contul tău este gestionat de un furnizor, aceasta apare doar atunci când acesta a activat Adu-ți propria cheie API pentru contul tău.

  1. În bara laterală principală din stânga, faceți clic pe Settings (pictograma roată de lângă partea de jos).
  2. Pe pagina Settings, în meniul din stânga, derulați până la grupul Advanced.
  3. Faceți clic pe BYOK API Keys.
  1. Faceți clic pe Add key (Adăugare cheie) pe cardul Anthropic. Va apărea un câmp Secret key (Cheie secretă) (substituent sk-ant-…).
  1. Lipiți cheia API Anthropic în câmp, apoi faceți clic pe Save key (Salvare cheie).

Odată activat, Agenții de pe nivelul de Calitate AI Pro folosesc propria cheie pentru răspunsurile lor, iar dumneavoastră plătiți direct către Anthropic pentru acea utilizare, în loc să consumați credite de platformă pentru acele răspunsuri. Agenții de pe nivelurile Max sau Mini nu folosesc niciodată cheia dumneavoastră și continuă să utilizeze credite (consultați excepția de mai jos). Infrastructura canalelor (servere WhatsApp Web, numere de telefon etc.) continuă să utilizeze credite ca de obicei.

O excepție — nivelul Max. Dacă nivelul de Calitate AI al unui Agent este setat pe Max, acel Agent este facturat cu 0,25 credite per acțiune chiar și atunci când aveți conectat BYOK — Max nu folosește niciodată cheia dumneavoastră Anthropic. (Același lucru este valabil și pentru Mini, acolo unde este disponibil: 0,15 credite per acțiune, niciodată cheia dumneavoastră.) Pentru a factura răspunsurile în contul dumneavoastră Anthropic, păstrați Agentul pe nivelul Pro. Nivelurile sunt Max, Pro și Mini; nu există un nivel Standard separat. Selectorul de Calitate AI se află în fila Instrucțiuni AI a fiecărui Agent. Pagina de setări Chei API BYOK afișează o notificare ori de câte ori cheia dumneavoastră este înregistrată, dar unul sau mai mulți dintre Agenții dumneavoastră rulează încă pe nivelul Max, enumerându-i pe aceștia — astfel încât să puteți observa dintr-o privire de ce sunt încă utilizate credite.

O notă despre costuri: Utilizarea propriei chei nu mai este opțiunea ieftină. Cu o cheie conectată, Agentul dumneavoastră rulează pe Claude și plătiți tarifele contorizate ale Anthropic direct (Anthropic vă facturează în funcție de cât utilizați efectiv, similar cu o factură de utilități). Măsurat în conturile care își rulează propria cheie, un răspuns AI costă aproximativ de 3 ori mai mult decât același răspuns pe Max și de peste 5 ori mai mult decât pe Mini, odată ce luați în calcul munca de fundal pe care o declanșează un răspuns (căutarea în baza de cunoștințe, verificarea spam-ului, extragerea numelui și a e-mailului, evaluările chat-ului, etichetarea), toate fiind incluse în tariful fix Max și Mini, dar facturate per token pe cheia dumneavoastră. Max și Mini sunt pur și simplu mult mai ieftine, iar Max este, de asemenea, cel mai precis model pe care îl oferim. Utilizați BYOK atunci când doriți în mod specific ca utilizarea AI să fie facturată în contul dumneavoastră Anthropic, nu pentru a economisi bani.

De ce primul răspuns dintr-o conversație costă mult mai mult decât restul. Caching-ul funcționează prin stocarea contextului conversației la Anthropic prima dată când este trimis, apoi reutilizându-l. Scrierea acestuia costă mai mult decât o cerere normală; fiecare răspuns care îl reutilizează costă aproximativ o douăzecea parte. Așadar, primul răspuns pare alarmant de scump, iar cele care urmează sunt foarte ieftine. Orice element mare din conversație face ca acel prim răspuns să fie mai voluminos — un document încărcat de un vizitator este principalul exemplu. Un PDF de 24 de pagini înseamnă aproximativ 70.000 de token-uri, deoarece fiecare pagină este trimisă atât sub formă de text, cât și ca imagine a paginii, și rămâne în conversație, deci este retrimisă (și recached) la fiecare răspuns. Dacă o conversație rămâne inactivă mai mult de o oră, copia stocată expiră și următorul răspuns plătește din nou taxa de scriere.

Dacă dezvolți ceva care implică multe documente — explicatoare de contracte, consultări de manuale, orice situație în care utilizatorii încarcă fișiere — nivelul Max este de obicei alegerea mai potrivită: are un cost fix de 0,25 credite per răspuns, indiferent cât de mare este documentul, deci nu există un vârf de cost la primul mesaj și nicio expunere la costuri per token. Consultă De ce Max este cea mai bună valoare pentru a vedea cum se compară Max în ceea ce privește calitatea și costul.

Dacă cheia BYOK eșuează (este invalidă, a depășit cota sau este limitată de rată — ceea ce înseamnă că Anthropic a limitat temporar numărul de solicitări pe care le poate face cheia dvs.), faptul că botul continuă să funcționeze depinde de comutatorul „Fallback to credits” de pe aceeași pagină BYOK API Keys:

  • Activat: platforma revine temporar la creditele platformei, astfel încât botul să continue să răspundă și să reîncerce utilizarea cheii în fundal — în momentul în care un apel reușește din nou, sistemul revine automat la cheia proprie.
  • Dezactivat (setarea implicită): răspunsurile AI sunt blocate până când remediați cheia. Nimic nu vă consumă creditele în mod silențios, dar botul încetează să mai răspundă, așa că, dacă preferați ca acesta să continue să funcționeze pe baza creditelor în timp ce remediați problema cheii, activați acest comutator din timp.

Oricum ar fi, veți primi un e-mail prima dată când cheia eșuează (nu unul pentru fiecare mesaj).


Întrebări frecvente

Pot folosi OpenAI, Gemini sau un alt furnizor pentru BYOK? În prezent, nu pentru alți furnizori. Pentru majoritatea oamenilor, răspunsul este deja aici: Max și Mini, la 0,25 și 0,15 credite per acțiune.

Cheia mea BYOK va fi folosită pentru tot? Majoritatea operațiunilor AI sunt scutite de taxe de credit atunci când este conectată propria cheie Anthropic (BYOK): răspunsurile AI, utilizarea instrumentelor, optimizarea agentului, generarea bazei de cunoștințe și căutarea pe web rulează toate pe cheia dumneavoastră. Patru lucruri costă în continuare credite chiar și cu o cheie conectată: nivelul Max la 0,25 credite per acțiune și nivelul Mini la 0,15 (aceasta include un import al bazei de cunoștințe legat de un Agent setat pe Max, la 0,25 per fragment); Lead Finder la 0,25 per adresă de e-mail găsită; și Automatizări la 0,25 per rulare plus 0,25 per pas AI. Pentru a menține un Agent complet pe propria cheie la 0 credite, lăsați-l pe nivelul Pro. Taxele de canal (taxa lunară WhatsApp Web, taxele per mesaj de livrare WhatsApp și taxele pentru șabloane) sunt facturate separat de utilizarea AI în ambele cazuri. Dacă cheia eșuează într-un apel care ar fi rulat pe ea, dacă platforma revine la credite depinde de comutatorul Revenire la credite — consultați comutatorul “Revenire la credite” descris mai sus pe această pagină.

Când costă exact 0 credite răspunsurile AI? BYOK este per cont. Răspunsurile AI costă 0 credite doar atunci când acest cont și-a conectat propria cheie Anthropic. Fără propria cheie, răspunsurile consumă credite la rata normală.

BYOK afectează livrarea mesajelor sau fiabilitatea canalului? Nu. BYOK schimbă doar modul în care sunt facturate apelurile AI ale botului dumneavoastră. Tot restul — rutarea mesajelor, infrastructura canalului, follow-up-urile și transmisiunile (Broadcasts) — funcționează exact la fel.


Vezi și: De ce Max este cea mai bună valoare · Configurarea botului tău AI · Agenți AI