WhatsApp'ta Claude Agent SDK ajanı nasıl çalıştırılır (MonoChat ile)

Claude Agent SDK, Anthropic’in ajan harness’idir: Claude Code’a güç veren aynı akıl yürütme, araç kullanımı ve kendini kontrol etme döngüsü, geliştiricilerin kendi ajanlarını oluşturabilmesi için paketlenmiş hâliyle. Birini WhatsApp’ta çalıştırmak için etrafında üç şeye daha ihtiyacınız var: WhatsApp Business Platform’a bir bağlantı, ajana işletme araçlarınızı vermenin bir yolu ve ajanın durması gerektiğinde bir insana güvenli bir yol. MonoChat’in Agent Harness yapısıyla Claude Agent SDK’yı bir AI Harness olarak eklersiniz, bir akışa AI Agent düğümü bırakırsınız, WhatsApp numaranızı bağlarsınız ve test edersiniz. Çalıştıracağınız sunucu yok.

Bu rehber, Claude Agent SDK’nın müşteri konuşmalarına ne kattığını, kurulumun MonoChat’te nasıl çalıştığını ve müşteriler yazmaya başlamadan önce nelerin doğru yapılması gerektiğini açıklıyor.

Claude Agent SDK nedir (ve neden desteğe uygundur)

Bugün WhatsApp’taki yapay zekânın çoğu tek bir model çağrısıdır: bir mesaj gelir, model bir yanıt yazar, iş biter. “Çalışma saatleriniz nedir?” için bu yeterlidir. “Siparişim ulaşmadı ve Cuma günü seyahatteyim” için ise yetersiz kalır.

Harness, modeli bir döngüde çalıştırır. Model sıradaki adıma karar verir, harness o adımı yürütür (bir şeyi sorgulama, bir aracı çağırma, bir dosyayı okuma), sonucu geri besler ve görev tamamlanana ya da bir kişiye ihtiyaç duyulana kadar tekrarlar. Claude Agent SDK, bu döngünün Anthropic’teki sürümüdür. Claude Code’un temelidir ve oradaki geliştiricilerin güvendiği yapı taşlarıyla gelir: araç kullanımı, MCP desteği, alt ajanlar, uzun oturumlar için bağlam yönetimi ve izin kontrolleri.

Müşteri mesajlaşmasında bir yanıtı bir çözüme dönüştüren şey bu döngüdür:

• Söz vermeden önce kontrol eder. Stok, teslimat durumu, randevu saatleri veya bir iade kuralı tahmin edilmez, yanıt verildiği anda sorgulanır.
• Bir vakayı birkaç adımda yürütür. Siparişi bulur, kargoyu kontrol eder, paketin takıldığını görür, bir yenisini önerir; hepsi tek bir konuşmada.
• Ne zaman duracağını bilir. İyi bir harness, yapabileceklerinin sınırına geldiğinde doğaçlama yapmak yerine vakayı bir kişiye devreder.

Harness ile düz çıkarım arasındaki farkın arka planını merak ediyorsanız, agent harness’in ne olduğunu ve WhatsApp desteğinin neden ona ihtiyaç duyduğunu okuyun.

MonoChat’te Claude ajanlarını kullanmanın üç yolu

MonoChat, Claude destekli bir ajana giden üç yolu destekler. Üçü de aynı AI Agent düğümünü, aynı kanalları ve aynı devri kullanır.

Seçenek	Nerede çalışır	Neye ihtiyacınız var
Claude Agent SDK	MonoChat’in ajan çalıştırıcısı; her çalıştırma izole, Claude Code tarzı bir ajan sürecidir	Ek bir şey gerekmez; yapay zekâ modelleriniz MonoChat’in ağ geçidi üzerinden
Claude Managed Agents	Anthropic’in bulutu	Anthropic API anahtarınız
Özel (kendi Claude Agent SDK hizmetiniz)	Kendi sunucunuz	Bir uç nokta URL’si ve paylaşılan bir gizli anahtar

Çoğu ekip için ilk seçenek doğru başlangıçtır: hiçbir şey dağıtmadan veya bakımını yapmadan Claude Agent SDK harness’ine sahip olursunuz. Zaten Anthropic’in barındırılan ajanları üzerinde geliştirme yapıyorsanız ve onları orada tutmak istiyorsanız Claude Managed Agents’ı seçin. Geliştiricileriniz SDK ile kendi ajanlarını geliştirip test ettiyse ve onu kendi altyapılarında çalıştırmaya devam etmek istiyorsa Özel’i seçin; kendi yapay zekâ ajanınızı WhatsApp’a bağlama rehberimiz bu yolu kapsıyor.

Adım adım: WhatsApp’ta bir Claude Agent SDK ajanı

1. Bir AI Harness ekleyin

MonoChat’te AI Harness, bir kez eklediğiniz ve yeniden kullandığınız bir hizmet tanımıdır. Bir tane ekleyin ve sağlayıcı olarak Claude Agent SDK’yı seçin. Sağlayıcının kendisi için yapılandırılacak başka bir şey yok: MonoChat’in ajan çalıştırıcısında çalışır ve yapay zekâ modellerinize MonoChat’in ağ geçidi üzerinden ulaşır.

2. Bir akışa AI Agent düğümü ekleyin

Gelen konuşmaları işleyen akışı açın veya yeni bir tane oluşturun ve bir AI Agent düğümü ekleyin. Az önce oluşturduğunuz harness’i seçin. Ajanın görevini aldığı yer burasıdır: kime hizmet ettiğini, neler yapabileceğini ve ne zaman devretmesi gerektiğini anlatan talimatlar yazın.

3. Ana, yedek ve hızlı modelleri seçin

Her AI Agent düğümünün üç model rolü vardır:

• Ana model: akıl yürütür, karar verir ve yanıtları yazar.
• Yedek model: esnek bir sınırdan sonra veya ana model başarısız olduğunda devralır, böylece müşteri yine de yanıt alır.
• Hızlı model: arka plan işlerini üstlenir.

Ayrıca çalıştırma başına bir bütçe sınırı belirleyin. Bir müşteri konuşması nadiren uzun bir adım zinciri gerektirir; bütçe, sıra dışı bir vakanın pahalı bir vakaya dönüşmesini engeller. Müşteriyle konuşan ajanınızın neden yedek modele ihtiyacı olduğunu anlatan makalemiz, ikiliyi nasıl seçeceğinizi açıklıyor.

4. Ajana araçlar verin

Araçsız bir ajan yalnızca konuşabilir. MonoChat’te ajan şunları kullanabilir:

• API’lerinizi yapılandırılmış girdilerle çağırmak için AI fonksiyon araçları, örneğin “sipariş durumunu getir” veya “iade oluştur”.
• MCP uyumlu herhangi bir sistemden araçlar getirmek için MCP sunucuları.
• Kendi politikalarınıza ve belgelerinize dayanan yanıtlar için yapay zekâ bilgi bankası.
• Konuşmanın içinde çalışan iş mantığı için özel fonksiyonlar.

En yaygın taleplerinizi kapsayan iki veya üç araçla başlayın. Eklediğiniz her araç, ajanın yapabileceği bir şey daha ve test edilecek bir şey daha demektir.

5. WhatsApp’ı ve diğer kanallarınızı bağlayın

Henüz yapmadıysanız WhatsApp Business numaranızı MonoChat’e bağlayın (MonoChat resmi bir Meta Business Partner’dır ve resmi WhatsApp Business Platform’u kullanır). Ajan bir akışta yaşadığı için aynı akışı hiçbir şeyi yeniden oluşturmadan Instagram’a, Messenger’a, TikTok’a, Telegram’a, web sohbetine, SMS’e ve sesli kanala bağlayabilirsiniz.

6. Test edin, sonra yayına alın

Ajana müşterilerinizin gerçekten gönderdiği mesajları gönderin: kısa, yazım hatalı, birden fazla dilde, tek mesajda üç soru. Doğru aracı kullandığını, kurallarınız içinde kaldığını ve doğru anda devrettiğini kontrol edin. Ardından akışı gerçek trafik için açın.

Bir WhatsApp ajanı için talimat yazmak

Claude Agent SDK, uzun ve ayrıntılı yanıtların hoş karşılandığı kodlama alanında büyüdü. WhatsApp ise bunun tam tersidir. Birkaç kural büyük fark yaratır:

• Yanıtları kısa tutun. Mesaj başına iki üç cümle, her seferinde bir soru. Müşteriler telefonda okur.
• Harekete geçmeden önce onay alın. Para harcatan veya geri alınamayan her şeyden önce “4821 numaralı siparişi iptal edip €39 iade edebilirim. Devam edeyim mi?”
• Devir kuralını açıkça belirtin. Örneğin: “Personel hakkındaki şikâyetlerde, hukuki tehditlerde, €100’un üzerindeki iadelerde veya müşteri bir insan istediğinde bir kişiye devret.”
• İşletmenizin sınırları içinde kalın. 15 Ocak 2026’dan beri WhatsApp’ın koşulları genel amaçlı yapay zekâ asistanlarını platformun dışında tutuyor. Kendi müşterilerinize hizmet veren bir ajan sorun değil; her konuda makale yazan bir ajan sorun. WhatsApp yapay zekâ chatbot politikası rehberimiz kuralı açıklıyor.
• 24 saatlik pencereye saygı gösterin. Serbest biçimli yanıtlara müşterinin son mesajından sonraki 24 saat içinde izin verilir. Sonrasında bir mesaj için onaylı bir şablon gerekir.

Devir: güveni kazandıran ya da kaybettiren kısım

Müşteriler “Bir meslektaşımı çağırayım” diyen bir ajanı affeder. Döngüye giren bir ajanı affetmez. MonoChat’te ajan konuşmayı ortak gelen kutusunda tüm geçmişiyle ekibinize devreder: müşterinin ne sorduğu, ajanın neyi sorguladığı ve neyi zaten denediği. Konuşmayı devralan kişinin müşteriden baştan başlamasını istemesi gerekmez.

Araçlarınızı planlamadan önce devir kurallarınızı planlayın. Ajanın hangi vakaları asla tek başına ele almaması gerektiğine, bunların kime gideceğine ve ajanın beklerken müşteriye ne söyleyeceğine karar verin.

Maliyetler ve kontrol

Bir ajanla, MonoChat planınızın üzerinde iki maliyet kalemi vardır: yapay zekâ modeli kullanımı ve Meta’nın WhatsApp ücretleri. 1 Ekim 2026’dan itibaren Meta, her işletme numarası için aylık ilk 1.000’den sonraki hizmet yanıtlarını ücretlendiriyor; ayrıntılar WhatsApp API fiyatlandırma rehberimizde.

Yapay zekâ tarafında, kendi sağlayıcı anahtarlarınızı kullandığınızda MonoChat ek ücret almaz. Çalıştırma başına bir bütçe sınırı, makul bir yedek model ve arka plan işleri için hızlı bir model, hacim büyüdükçe kullanımı öngörülebilir tutar.

Ne zaman farklı bir harness seçmeli?

Claude Agent SDK, birkaç adımda akıl yürütmesi gereken ajanlar için güçlü bir varsayılandır. Ancak Agent Harness, bir seçeneğe bağlı kalmayasınız diye tasarlandı. Ekibiniz zaten OpenAI Agents SDK, Pi, barındırılan bir OpenAI veya Anthropic ajanı ya da kendi çerçevesiyle çalışıyorsa, başka bir AI Harness ekleyip AI Agent düğümünü ona geçirebilirsiniz; kanallarınıza, araçlarınıza veya devrinize dokunmanız gerekmez. Tüm seçenekleri Agent Harness sayfasında görün.