OpenAI Agents SDK ile WhatsApp ajanı nasıl geliştirilir

OpenAI Agents SDK, OpenAI’ın ajan geliştirmek için sunduğu açık kaynaklı çerçevedir: talimatları olan bir model, çağırabileceği araçlar, diğer ajanlara devirler ve girdileri ile çıktıları çevreleyen güvenlik kontrolleri; hepsi görev tamamlanana kadar bir döngüde çalışır. Ajan geliştirmenin harika bir yoludur. Ancak tek başına size bir WhatsApp numarası, bir ekip gelen kutusu, şablon mesajlar veya bir kişinin devralması için bir yol sunmaz. MonoChat’in Agent Harness yapısıyla OpenAI Agents SDK’yı bir AI Harness olarak seçersiniz, bir akışa AI Agent düğümü yerleştirirsiniz, WhatsApp’ı bağlayıp test edersiniz; gerisini MonoChat halleder.

Bu rehber SDK’nın size ne sunduğunu, MonoChat’te OpenAI ajanlarını kullanmanın üç yolunu, adım adım kurulumu ve müşterilerin ajana güvenip güvenmeyeceğini belirleyen WhatsApp’a özgü ayrıntıları kapsıyor.

OpenAI Agents SDK size neler sunar?

SDK, küçük bir fikir kümesi etrafında kuruludur:

• Ajanlar: bir model artı işini anlatan talimatlar.
• Araçlar: ajanın çağırabileceği fonksiyonlar, örneğin “bir siparişi sorgula” veya “bir zaman aralığını kontrol et”, ayrıca MCP sunucuları.
• Devirler: bir ajanın görevi, örneğin genel bir destek ajanından bir iade ajanına, konusunda uzmanlaşmış bir başka ajana aktarması.
• Güvenlik kontrolleri: istemediğiniz girdileri veya çıktıları durdurmak için ajanla birlikte çalışan kontroller.
• Oturumlar ve izleme: turlar arasında bellek ve ajanın adım adım ne yaptığının kaydı.

Hepsi bir araya geldiğinde bu bir agent harness’tir: modelin bir kez yanıtlamak yerine harekete geçmesini, işini kontrol etmesini ve devam etmesini sağlayan döngü. Müşteri mesajlaşmasında bu, iade politikanızı açıklamakla iadeyi gerçekten oluşturmak arasındaki farktır.

WhatsApp probleme ne ekler?

Ajanı geliştirmek işin yarısıdır. Onu WhatsApp’ta müşterilerin karşısına çıkarmak şunları ele almayı gerektirir:

• WhatsApp Business Platform. Resmi bir API bağlantısı, doğrulanmış bir işletme ve onaylı bir numara.
• 24 saatlik pencere. Serbest biçimli yanıtlara müşterinin son mesajından sonraki 24 saat içinde izin verilir; sonrasında onaylı bir şablon gerekir.
• Politika. 15 Ocak 2026’dan beri WhatsApp genel amaçlı yapay zekâ asistanlarını platformun dışında tutuyor. Kendi müşterilerinize hizmet veren bir ajana izin veriliyor ve yanıtlar otomatik olduğunda bir insana net bir yol bekleniyor.
• İnsanlar. Bazı konuşmalar, geçmişi bozulmadan, ekibinizin zaten kullandığı araç içinde bir kişiye gitmelidir.
• Diğer kanallar. Instagram’da, Messenger’da veya web sitenizde yazan müşteriler aynı yanıtları bekler.

MonoChat bunları ajanın çevresinde yönetir; böylece sizin işiniz ajanın kendisinde kalır.

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

Seçenek	Nerede çalışır	Neye ihtiyacınız var
OpenAI Agents SDK	MonoChat içinde	Ek bir şey gerekmez; yapay zekâ modellerinizi kullanır
OpenAI Agents API (OpenAI tarafından barındırılır)	OpenAI’ın bulutu	OpenAI API anahtarınız
Özel (kendi Agents SDK hizmetiniz)	Kendi sunucunuz	Bir uç nokta URL’si ve paylaşılan bir gizli anahtar

Hiçbir şey dağıtmadan OpenAI tarzı bir ajan istiyorsanız OpenAI Agents SDK harness’i ile başlayın. Ajanlarınız zaten OpenAI’ın barındırılan platformunda yaşıyorsa OpenAI Agents API’yi seçin. Geliştiricileriniz SDK ile kendi araçları, devirleri ve testleriyle kendi ajanlarını yazdıysa ve o kodu çalıştırmaya devam etmek istiyorsa Özel’i seçin; bkz. kendi yapay zekâ ajanınızı WhatsApp’a nasıl bağlarsınız.

Adım adım: WhatsApp’ta bir OpenAI Agents SDK ajanı

1. Bir AI Harness ekleyin

MonoChat’te bir AI Harness ekleyin ve sağlayıcı olarak OpenAI Agents SDK’yı seçin. MonoChat içinde çalışır ve zaten kurduğunuz yapay zekâ modellerini kullanır; dolayısıyla bu adım için ek anahtar veya sunucu gerekmez.

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

WhatsApp konuşmalarınızı karşılayan akışa bir AI Agent düğümü ekleyin ve harness’i seçin. Ajanın talimatlarını yazın: kime hizmet ettiği, neler yapabileceği, asla neler yapmaması gerektiği ve ne zaman devredeceği.

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 ve yanıtları yazar.
• Yedek model esnek bir sınırdan veya bir arızadan sonra devralır.
• Hızlı model arka plan işlerini üstlenir.

Sıra dışı tek bir konuşmanın büyük bir fatura çıkarmaması için çalıştırma başına bir bütçe sınırı ekleyin. Yedeği nasıl seçeceğinizden emin değil misiniz? Müşteriyle konuşan yapay zekâ ajanınızın neden yedek modele ihtiyacı olduğunu okuyun.

4. Araçlarınızı bağlayın

Ajana en sık gelen taleplerinize uygun araçları verin:

• Kendi API’lerinize yapılandırılmış girdilerle yapılan çağrılar için AI fonksiyon araçları.
• MCP uyumlu sistemlerden araçlar için MCP entegrasyonu.
• Belgelerinize ve politikalarınıza dayanan yanıtlar için yapay zekâ bilgi bankası.
• Konuşmanın içinde çalışan mantık için özel fonksiyonlar.

Üç iyi araç, on beş yarım test edilmiş araçtan iyidir. Gerçek konuşmaları gördükten sonra daha fazlasını ekleyin.

5. WhatsApp’ı (ve geri kalan her şeyi) bağlayın

WhatsApp Business numaranızı resmi bir Meta Business Partner olan MonoChat üzerinden bağlayın. Aynı akış Instagram’da, Messenger’da, TikTok’ta, Telegram’da, web sohbetinde, SMS’te ve sesli kanalda çalışabilir; böylece tek bir ajan her kanalı kapsar.

6. Gerçek mesajlarla test edin

Geçen ayın konuşmalarını test seti olarak kullanın. Zor olanları da ekleyin: kızgın müşteriler, belirsiz sorular, tek mesajda birkaç talep, hemen bir kişi isteyen bir müşteri. Araç çağrılarını, üslubu ve devri kontrol edin. Ardından yayına alın.

WhatsApp’ta iyi çalışan kalıplar

Mesaj başına bir soru. Web’de sohbet için geliştirilen ajanlar uzun listelerle yanıt verme eğilimindedir. Telefonda kısa mesajlar ve her seferinde net bir soru, müşterilerden daha iyi yanıt alır.

Geri alınamaz eylemlerden önce onay alın. Bir iptal, iade veya rezervasyon değişikliğinden önce ajan önersin, müşteri onaylasın.

Uzmanlar devirlerle, insanlar gelen kutusuyla. SDK’nın devirleri ajanlar arasında (satış, destek, iadeler) yönlendirme için harikadır. Bir kişiye devir, konuşmanın tüm geçmişiyle ulaştığı MonoChat’in ortak ekip gelen kutusuna aittir.

Sınırları adıyla belirten talimatlar. “€50’ye kadar iadeleri onaylayabilirsin; üzerindekileri faturalama ekibine devret.” Açık rakamlar belirsiz kurallardan iyidir.

İşletmenizle ilgili kalın. Müşterilerinize yardım eden bir ajana WhatsApp’ta izin verilir. Her şeyi yanıtlayan bir ajan WhatsApp’ın 2026 kurallarını ihlal etme riski taşır; WhatsApp yapay zekâ chatbot politikası rehberimiz sınırın nerede olduğunu açıklıyor.

Maliyetler

Üç şey toplanır: MonoChat planınız, yapay zekâ modeli kullanımı ve Meta’nın WhatsApp mesaj ü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; bkz. WhatsApp API fiyatlandırma rehberimiz.

Yapay zekâ tarafında, kendi sağlayıcı anahtarlarınızı kullandığınızda MonoChat ek ücret almaz. Çalıştırma başına bütçeler, arka plan işleri için daha ucuz bir hızlı model ve güvenilir bir yedek, faturayı öngörülebilir tutar.

Kilitlenmezsiniz

Agent Harness yalnızca modeli değil, çerçeveyi de seçmenize izin verir. Daha sonra Claude Agent SDK, Pi, Claude Managed Agents veya kendi çerçevenizi denemek isterseniz, başka bir AI Harness ekleyin ve AI Agent düğümünü ona yönlendirin. Kanallarınız, araçlarınız ve devriniz olduğu gibi kalır. Tüm sağlayıcıları Agent Harness sayfasında karşılaştırın.