Cum rulați un agent Claude Agent SDK pe WhatsApp (cu MonoChat)

Claude Agent SDK este agent harness-ul Anthropic: aceeași buclă de raționament, utilizare de instrumente și autoverificare care alimentează Claude Code, ambalată pentru ca dezvoltatorii să își poată construi propriii agenți. Pentru a rula unul pe WhatsApp aveți nevoie de încă trei lucruri în jurul lui: o conexiune la WhatsApp Business Platform, o modalitate de a-i oferi agentului instrumentele afacerii dvs. și o cale sigură către un om când agentul trebuie să se oprească. Cu Agent Harness de la MonoChat, adăugați Claude Agent SDK ca AI Harness, puneți un nod AI Agent într-un flux, conectați numărul WhatsApp și testați. Fără servere de administrat.

Acest ghid explică ce aduce Claude Agent SDK în conversațiile cu clienții, cum funcționează configurarea în MonoChat și ce trebuie făcut corect înainte ca clienții să înceapă să scrie.

Ce este Claude Agent SDK (și de ce se potrivește suportului)

Cea mai mare parte a AI-ului de pe WhatsApp astăzi este un singur apel de model: sosește un mesaj, modelul scrie un răspuns, gata. Este în regulă pentru „Care este programul de funcționare?” Se destramă la „Comanda mea nu a ajuns și călătoresc vineri.”

Un harness rulează modelul într-o buclă. Modelul decide ce face în continuare, harness-ul execută acel pas (caută ceva, apelează un instrument, citește un fișier), reintroduce rezultatul și repetă până când sarcina este încheiată sau este nevoie de o persoană. Claude Agent SDK este versiunea Anthropic a acestei bucle. Este fundația Claude Code și vine cu elementele de bază pe care dezvoltatorii se bazează acolo: utilizarea de instrumente, suport MCP, sub-agenți, gestionarea contextului pentru sesiuni lungi și controale de permisiuni.

În mesageria cu clienții, această buclă transformă un răspuns într-o rezolvare:

• Verifică înainte să promită. Stocul, starea livrării, intervalele de programare sau o regulă de rambursare sunt căutate în momentul răspunsului, nu ghicite.
• Duce un caz la capăt în mai mulți pași. Găsește comanda, verifică transportatorul, vede că pachetul este blocat, oferă un înlocuitor, totul într-o singură conversație.
• Știe când să se oprească. Un harness bun predă cazul unei persoane în loc să improvizeze când ajunge la limita a ceea ce are voie să facă.

Dacă doriți contextul despre harness-uri versus inferența simplă, citiți ce este un agent harness și de ce are nevoie suportul pe WhatsApp de unul.

Trei moduri de a folosi agenți Claude în MonoChat

MonoChat acceptă trei căi către un agent bazat pe Claude. Toate trei folosesc același nod AI Agent, aceleași canale și aceeași predare.

Opțiune	Unde rulează	Ce vă trebuie
Claude Agent SDK	Agent runner-ul MonoChat; fiecare rulare este un proces de agent izolat, în stil Claude Code	Nimic în plus; modelele dvs. AI prin gateway-ul MonoChat
Claude Managed Agents	Cloud-ul Anthropic	Cheia dvs. API Anthropic
Custom (propriul serviciu Claude Agent SDK)	Propriul server	Un URL de endpoint și un secret partajat

Pentru majoritatea echipelor, prima opțiune este începutul potrivit: obțineți harness-ul Claude Agent SDK fără să implementați sau să mențineți nimic. Alegeți Claude Managed Agents dacă deja construiți pe agenții găzduiți de Anthropic și vreți să îi păstrați acolo. Alegeți Custom dacă dezvoltatorii dvs. și-au construit și testat propriul agent cu SDK-ul și vor să îl ruleze în continuare pe propria infrastructură; ghidul nostru despre conectarea propriului agent AI la WhatsApp acoperă această cale.

Pas cu pas: un agent Claude Agent SDK pe WhatsApp

1. Adăugați un AI Harness

În MonoChat, un AI Harness este o definiție de serviciu pe care o adăugați o singură dată și o reutilizați. Adăugați unul și alegeți Claude Agent SDK ca furnizor. Nu mai este nimic de configurat pentru furnizorul în sine: rulează pe agent runner-ul MonoChat și ajunge la modelele dvs. AI prin gateway-ul MonoChat.

2. Adăugați un nod AI Agent într-un flux

Deschideți fluxul care gestionează conversațiile primite sau creați unul nou și adăugați un nod AI Agent. Selectați harness-ul tocmai creat. Aici primește agentul sarcina: scrieți instrucțiuni care descriu cui servește, ce are voie să facă și când trebuie să predea.

3. Alegeți modelele principal, de rezervă și rapid

Fiecare nod AI Agent are trei roluri de model:

• Model principal: raționează, decide și scrie răspunsurile.
• Model de rezervă: preia după o limită soft sau când modelul principal eșuează, astfel încât clientul să primească totuși un răspuns.
• Model rapid: se ocupă de munca din fundal.

Stabiliți și o limită de buget pe rulare. O conversație cu un client rareori cere un lanț lung de pași, iar un buget împiedică un caz neobișnuit să devină unul costisitor. Articolul nostru despre de ce agentul dvs. orientat către clienți are nevoie de un model de rezervă explică cum alegeți perechea.

4. Oferiți agentului instrumente

Un agent fără instrumente poate doar vorbi. În MonoChat, agentul poate folosi:

• Instrumente de funcții AI pentru a apela API-urile dvs. cu intrări structurate, de exemplu „obține starea comenzii” sau „creează o returnare”.
• Servere MCP pentru a aduce instrumente din orice sistem compatibil MCP.
• Baza de cunoștințe AI pentru răspunsuri bazate pe propriile politici și documente.
• Funcții personalizate pentru logică de afaceri care rulează în interiorul conversației.

Începeți cu două sau trei instrumente care acoperă cele mai frecvente solicitări. Fiecare instrument adăugat este încă un lucru pe care agentul îl poate face și încă un lucru de testat.

5. Conectați WhatsApp și celelalte canale

Conectați numărul WhatsApp Business la MonoChat, dacă nu ați făcut-o deja (MonoChat este partener oficial Meta Business Partner și folosește WhatsApp Business Platform oficială). Deoarece agentul se află într-un flux, puteți atașa același flux la Instagram, Messenger, TikTok, Telegram, web chat, SMS și voce fără să reconstruiți nimic.

6. Testați, apoi lansați

Trimiteți agentului mesajele pe care le trimit efectiv clienții dvs.: scurte, cu greșeli, în mai multe limbi, trei întrebări într-un singur mesaj. Verificați că folosește instrumentul potrivit, rămâne în regulile dvs. și predă la momentul potrivit. Apoi activați fluxul pentru trafic real.

Scrierea instrucțiunilor pentru un agent WhatsApp

Claude Agent SDK a crescut în zona de programare, unde răspunsurile lungi și detaliate sunt binevenite. WhatsApp este opusul. Câteva reguli fac o mare diferență:

• Păstrați răspunsurile scurte. Două sau trei propoziții pe mesaj, o întrebare pe rând. Clienții citesc pe telefon.
• Confirmați înainte de a acționa. „Pot anula comanda 4821 și rambursa 39 €. Continui?” înainte de orice costă bani sau nu poate fi anulat.
• Numiți explicit regula de predare. De exemplu: „Predă unei persoane în cazul reclamațiilor despre personal, amenințărilor juridice, rambursărilor peste 100 € sau când clientul cere un om.”
• Rămâneți în limitele afacerii dvs. Din 15 ianuarie 2026, termenii WhatsApp țin asistenții AI de uz general în afara platformei. Un agent care servește propriii dvs. clienți este în regulă; unul care scrie eseuri pe orice subiect nu este. Ghidul nostru despre politica WhatsApp pentru chatboți AI explică regula.
• Respectați fereastra de 24 de ore. Răspunsurile libere sunt permise în 24 de ore de la ultimul mesaj al clientului. După aceea, un mesaj are nevoie de un șablon aprobat.

Predarea: partea care face sau desface încrederea

Clienții iartă un agent care spune „Permiteți-mi să chem un coleg.” Nu iartă unul care se învârte în cerc. În MonoChat, agentul predă conversația echipei dvs. în inboxul comun, cu tot istoricul: ce a întrebat clientul, ce a căutat agentul și ce a încercat deja. Persoana care preia nu trebuie să îi ceară clientului să o ia de la capăt.

Planificați regulile de predare înainte de a vă planifica instrumentele. Stabiliți ce cazuri agentul nu ar trebui să gestioneze niciodată singur, cine le primește și ce îi spune agentul clientului cât timp așteaptă.

Costuri și control

Cu un agent există două linii de cost pe lângă planul dvs. MonoChat: utilizarea modelelor AI și taxele WhatsApp ale Meta. Din 1 octombrie 2026, Meta taxează răspunsurile de serviciu după primele 1.000 pe număr de companie în fiecare lună; ghidul nostru despre prețurile WhatsApp API conține detaliile.

Pe partea de AI, MonoChat nu adaugă niciun adaos când folosiți propriile chei de furnizor. O limită de buget pe rulare, un model de rezervă potrivit și un model rapid pentru munca din fundal mențin utilizarea previzibilă pe măsură ce volumul crește.

Când alegeți un alt harness

Claude Agent SDK este o alegere implicită puternică pentru agenții care trebuie să raționeze prin mai mulți pași. Dar Agent Harness este construit astfel încât să nu fiți blocat. Dacă echipa dvs. lucrează deja cu OpenAI Agents SDK, Pi, un agent OpenAI sau Anthropic găzduit ori cu propriul framework, puteți adăuga un alt AI Harness și comuta nodul AI Agent, fără să atingeți canalele, instrumentele sau predarea. Vedeți toate opțiunile pe pagina Agent Harness.