Claude Yönetilen Agent'lar ve Agent SDK (2026): Hangisini Seçmeli?

Claude üzerinde bir üretim yapay zeka aracısı yayınlamaya karar verdiniz. Şimdi yolun ilk gerçek ayrımına geldiniz: aracının döngüsünü ve sanal alanını Claude Yönetilen Aracılar ile Anthropic'in sizin için çalıştırmasına izin mi vereceksiniz, yoksa döngüyü Claude Aracı SDK'sı ile kendi sürecinizde mi tutacaksınız? İki seçenek bir demodan benzer görünse de, mimarinizi, maliyet modelinizi ve nöbet rotasyonunuzu farklı yönlere çekerler. Bu rehber, bir ödeme-iade aracısı ve bir destek bileti aracısı örneklerini kullanarak, bu ödünleşimleri beyaz tahtada gerçekte nasıl değerlendireceğinizi ele alıyor.

TL;DR

Anthropic'in aracı döngüsünü, sanal alanı ve oturum durumunu uzun süreli veya eşzamansız işler için barındırmasını istiyorsanız ve bu altyapıyı çalıştırmak yerine bir çalışma süresi ücreti ödemeyi tercih ediyorsanız Claude Yönetilen Aracılar'ı seçin. Döngünün kendi sürecinizde olmasını, araçlar üzerinde tam kontrolü, veri yerleşimi ve maliyeti istediğinizde Claude Aracı SDK'sını seçin. Her ikisi de MCP ve Claude modellerini destekler.

Giriş

2026'da, “bir yapay zeka aracısı oluşturmak” ifadesi “bir sohbet tamamlama etrafında bir while döngüsü kurmak” anlamına gelmekten çıktı. Anthropic artık bir aracıyı üretimde çalıştırmak için size iki farklı yol sunuyor ve bu seçim koddan daha fazlasını şekillendiriyor. Müşteri verilerinin nerede durduğuna, bir araç çağrısı takıldığında sabah 2'de kimin aranacağına ve finans ekibinizin harcamaları nasıl tahmin edeceğine karar veriyor.

Claude Aracı SDK'sı bir kütüphanedir: onu bir Python veya TypeScript hizmetine aktarırsınız ve aracı döngüsü, bağlam yönetimi ve yerleşik araçlar kendi sürecinizde ve altyapınızda çalışır. Claude Yönetilen Aracılar ise tam tersi bir yapıdadır: Anthropic'in döngüyü ve oturum başına sanal alanı çalıştırdığı barındırılan bir REST API'sidir ve uygulamanız olayları gönderir ve sonuçları geri akışla alır. Altta aynı modeller olsa da, operasyonel sözleşmeleri çok farklıdır.

Çoğu üretim aracı, API'leri çağırarak gerçek iş yapar: bir kartı şarj etme, bir Zendesk bileti oluşturma, bir envanter hizmetini sorgulama, dahili bir fiyatlandırma uç noktasına erişme. Bu, aracınızın güvenilirliğinin çoğunlukla çağırdığı API'lerin ve araçların güvenilirliği olduğu anlamına gelir. Bir barındırma modeli seçmeden önce, bu uç noktaları aracı şekilli trafik altında tasarlamak, taklit etmek ve test etmek için bir yola ihtiyacınız var. İşte Apidog gibi bir platformun devreye girdiği yer burası: aracınızın kullandığı bağımlılıkları taklit edebilir, bunlara karşı sözleşme testleri çalıştırabilir ve bir MCP sunucusunu aracının yapacağı şekilde kullanabilirsiniz. Buna daha sonra geri döneceğiz. İlk olarak, her iki seçeneği de netleştirelim, çünkü yanlış olanı seçmek geri dönülmesi pahalıdır. Özellikle barındırılan taraf hakkında daha derinlemesine bir giriş isterseniz, Claude Yönetilen Aracılar rehberimize bakın.

Claude Yönetilen Aracılar Gerçekte Nedir?

Claude Yönetilen Aracılar, Anthropic tarafından yönetilen altyapıda çalışan, önceden oluşturulmuş, yapılandırılabilir bir aracı donanımıdır. Kendi aracı döngünüzü, sanal alanınızı ve araç yürütme katmanınızı yazmak yerine, bir aracı tanımlarsınız ve Anthropic'in onu çalıştırmasına izin verirsiniz. Nisan 2026'da genel beta olarak piyasaya sürüldü ve şu anda her istekte SDK'nın sizin için ayarladığı managed-agents-2026-04-01 beta başlığını gerektiriyor.

Ürün dört kavram etrafında inşa edilmiştir ve bunlar bir iş yürütücüsü hakkında nasıl düşüneceğinize net bir şekilde uyar:

• Aracı: model, sistem istemi, araçlar, MCP sunucuları ve beceriler. Bir kez oluşturup birçok oturumda kimliğiyle referans alırsınız.
• Ortam: önceden yüklenmiş paketler (Python, Node.js, Go ve diğerleri) ve ağ erişim kuralları içeren yapılandırılmış bir kapsayıcı şablonu.
• Oturum: bir ortam içinde çalışan, tek bir görevi yerine getiren ve çıktılar üreten bir aracı örneği. Kalıcı bir dosya sistemi ve sohbet geçmişi vardır.
• Olaylar: uygulamanız ile aracı arasında akan mesajlar (kullanıcı dönüşleri, araç sonuçları, durum güncellemeleri), sunucu tarafından gönderilen olaylar üzerinden geri akışla alınan ve sunucu tarafında kalıcı hale getirilen mesajlar.

Akış şöyledir: bir aracı oluşturun, bir ortam yapılandırın, bir oturum başlatın, kullanıcı mesajlarını olay olarak gönderin ve yanıtları akışla alın. Çalışma sırasında daha fazla olay göndererek aracıyı yönlendirebilir veya yön değiştirmek için durdurabilirsiniz. Olay geçmişi Anthropic tarafında saklanır ve denetim ile hata ayıklama için önemli olan tam olarak alınabilir.

Yönetilen Aracılar, Claude'a kutudan çıkar çıkmaz bir dizi yerleşik araç sunar: Bash, dosya işlemleri (okuma, yazma, düzenleme, glob, grep), web araması ve getirme ve diğer her şey için MCP sunucu bağlantıları. Anthropic'in yaklaşımı, bu seçeneğin uzun süreli yürütme (dakikalar ila saatler, birçok araç çağrısı), ağ erişimi olan güvenli bulut kapsayıcıları, sizin tarafınızda minimum altyapı ve etkileşimler arasında kalıcı olan durum bilgisi olan oturumlar gerektiren iş yükleri için en iyisi olduğudur. Ayrıca, belirli bir bulutla sınırlıysanız kontrol etmeye değer olan, özellik kullanılabilirliği ve oturum davranışında bazı farklılıklarla AWS üzerindeki Claude Platformunda da mevcuttur.

Akılda tutulması gereken iki şey var. İlk olarak, özel araçlar burada farklı çalışır: Claude bir aracı çağırmaya karar verir, ancak uygulamanız onu yürütür ve sonucu olay akışı üzerinden döndürür. Yürütme hala sizin dünyanızda gerçekleşir; sadece döngü ve sanal alan barındırılır. İkinci olarak, belirli özellikler (çıktılar ve çoklu aracı) ayrı bir erişim isteğinin arkasında bir araştırma önizlemesi olarak kısıtlanmıştır, bu nedenle her yeteneğin onu açtığınız anda mevcut olduğunu varsaymayın. Tüm bunların arkasındaki daha geniş desen için, ajanik yapay zeka mimarisi hakkındaki yazımız, döngünün, araçların ve belleğin nasıl bir araya geldiğini kapsar.

Claude Aracı SDK'sı Gerçekte Nedir?

Claude Aracı SDK'sı, Claude Code'a güç veren araçları, aracı döngüsünü ve bağlam yönetimini Python ve TypeScript'te programlanabilir olarak size sunan bir kütüphanedir. Daha önce Claude Code SDK olarak adlandırılıyordu; yeniden adlandırma, kodlama görevlerinden daha geniş bir kapsamı işaret ediyordu. `pip install claude-agent-sdk` veya `npm install @anthropic-ai/claude-agent-sdk` komutlarını kullanarak onu bir API anahtarına yönlendirirsiniz ve döngü kendi sürecinizde çalışır.

Minimal bir aracı küçüktür. Python'da, bir istem ve aracının kullanabileceği araçları listeleyen bir seçenek nesnesiyle `query()` çağrısı yapar, ardından akışla gelen mesajları döngüye alırsınız. Claude, bir araç yürütme döngüsü uygulamanıza gerek kalmadan dosyaları okur, komutları çalıştırır ve kodu düzenler. Bu, `while response.stop_reason == "tool_use"` döngüsünü kendiniz yazdığınız ve her araç çağrısını elinizle yürüttüğünüz düz Client SDK'dan temel farkıdır.

SDK, aksi takdirde sizin inşa edeceğiniz mekanizmayı sunar:

• Yerleşik araçlar: Okuma, Yazma, Düzenleme, Bash, Glob, Grep, WebArama, WebAlma, arka plan betiklerini izlemek için bir İzleme aracı ve açıklayıcı sorular için bir KullanıcıyaSoruSorma aracı.
• Kancalar: yaşam döngüsü noktalarındaki geri çağrımlar (PreToolUse, PostToolUse, Stop, SessionStart, SessionEnd, UserPromptSubmit ve daha fazlası), böylece davranışı doğrulayabilir, günlüğe kaydedebilir, engelleyebilir veya dönüştürebilirsiniz. Her dosya veya API değişikliğinin denetim izini bu şekilde oluşturursunuz.
• Alt aracılar: odaklanmış alt görevler için özelleşmiş aracılar oluşturun; mesajlar, hangi alt aracının ne yaptığını izleyebilmeniz için bir parent_tool_use_id taşır.
• MCP: Veritabanlarını, tarayıcıları ve API'leri, Yönetilen Aracılar'ın kullandığı aynı standart olan Model Bağlam Protokolü üzerinden bağlayın.
• İzinler: güvenli araçları önceden onaylayın, tehlikeli olanları engelleyin veya hassas eylemler için onay isteyin. Salt okunur bir analiz aracı bir seçenek dizesidir.
• Oturumlar: bir oturum kimliği yakalayın, tam bağlamla daha sonra devam edin veya alternatifleri keşfetmek için çatallayın. Durum, dosya sisteminizdeki JSONL olduğundan, ona sahipsiniz.

Döngü kendi sürecinizde çalıştığı için SDK, Claude Code'un dosya sistemi yapılandırmasını da okur: .claude/skills/ içindeki beceriler, eğik çizgi komutları, proje bağlamı için bir CLAUDE.md ve eklentiler. Kimlik doğrulama, doğrudan Anthropic API'sinin yanı sıra Amazon Bedrock, AWS üzerindeki Claude Platformu, Google Vertex AI ve Azure AI Foundry'yi destekler, böylece çıkarımı mevcut bir bulut sözleşmesi içinde tutabilirsiniz. Uygulamalı bir yol isterseniz, Claude planıyla Claude Aracı SDK'sını kurma rehberimiz ve kendi Claude Kodunuzu oluşturma kılavuzumuz her ikisi de çalışan bir döngüden başlar.

Planlamanız gereken bir faturalandırma değişikliği: 15 Haziran 2026'dan itibaren, abonelik planlarındaki Aracı SDK'sı ve claude -p kullanımı, etkileşimli kullanım limitlerinden ayrı, ayrı bir aylık Aracı SDK kredisi havuzundan çekilecektir. Tahmininiz, SDK çağrılarının etkileşimli Claude kullanım havuzuyla aynı olduğunu varsaydıysa, bunu yeniden gözden geçirin. Anthropic'in güncel şartlarını, bu blog yazısı dahil olmak üzere, okuduğunuz bir sayıya güvenmek yerine doğrudan kontrol edin.

Karşılaştırma: Yönetilen Aracılar ve Aracı SDK'sı

İşte bir mimari incelemede genellikle karşımıza çıkan karşılaştırma. Maliyet satırını yönlendirici olarak ele alın; bir bütçeye taahhüt etmeden önce Anthropic'in fiyatlandırma sayfası ve Yönetilen Aracılar belgeleri üzerindeki canlı sayıları onaylayın.

Birkaç satır nüanslı bir cümle hak ediyor.

Maliyet. Şekiller farklıdır, model fiyatı değil. Yönetilen Aracılar, standart jeton oranlarına ek olarak aktif oturum süresi için bir çalışma ücreti alır, bu nedenle bir saat düşünen bir aracı, araç çağrıları arasında bile o saat için size maliyet çıkarır. SDK'nın saat başına Anthropic çalışma ücreti yoktur, ancak sunucuların, otomatik ölçeklendirmenin ve onları ayakta tutan mühendislerin parasını siz ödersiniz. Kağıt üzerinde daha ucuz olan, bir nöbet rotasyonuna fiyat biçtiğinizde daha ucuz değildir.

Operasyonel yük. Bu en net ayrımdır. Yönetilen Aracılar, sanal alanı, oturum deposunu ve ölçeklendirme mantığını sizin üzerinizden alır. SDK size üçü üzerinde de kontrol sağlar; bu, bir aracının özel bir veritabanının yanında bir VPC içinde çalışması gerektiğinde tam olarak istediğiniz şeydir ve iki kişilik bir ekibin sadece eşzamansız bir işçiye ihtiyacı olduğunda tam olarak istemediğiniz şeydir.

Veri yerleşimi. SDK ile araç yürütme ve oturum durumu altyapınızdan asla ayrılmaz; yalnızca model çıkarımı Claude'a gider. Yönetilen Aracılar ile sanal alan ve olay günlüğü Anthropic'in ortamında (veya AWS'de, bazı sınırlamalarla) yaşar. Düzenlenmiş veriler için bu satır genellikle tüm soruyu kendi başına çözer.

Gözlemlenebilirlik. Yönetilen Aracılar size ücretsiz olarak barındırılan, alınabilir bir olay günlüğü sunar. SDK size kancalar verir ve bunları izleme yığınıza bağlamanızı bekler. Farklı ergonomi, işi yaparsanız benzer son durum.

Aracılarınızın Çağırdığı API'leri Test Etme ve Hata Ayıklama

Hangi barındırma modelini seçerseniz seçin, aracınızın güvenilirliği çağırdığı araçlar ve API'ler tarafından belirlenir. Mükemmel düşünen ancak arızalı bir ödeme uç noktasını çağıran bir iade aracı, arızalı bir iade aracıdır. Bu nedenle, bağımlılıkları sonradan akla gelenler olarak değil, birinci sınıf test hedefleri olarak ele alın.

Yayınlamadan önce üç katmanı test etmeye değer.

API sözleşmeleri. Aracınızın çağırdığı her araç, bir şemaya sahip bir API'dir. Arka uçtaki bir değişikliğin üretimde aracıyı sessizce bozmaması için bu uç noktaları taklit edin ve istek ve yanıt şekillerini doğrulayın. Apidog ile ödeme veya biletleme hizmeti için bir taklit oluşturabilir, aracının beklediği kesin şemayı tanımlayabilir ve planlı olarak sözleşme testleri çalıştırabilirsiniz. Gerçek hizmet sapma gösterdiğinde, bir müşterinin iadesi gerçekleşmeden önce sözleşme testi başarısız olur. Buna yapılandırılmış bir yaklaşım için, API'leri çağıran yapay zeka aracılarını nasıl test edeceğinize dair rehberimiz, önemli hata modlarını ele almaktadır.

MCP sunucuları. Her iki seçenek de harici araçları MCP üzerinden yönlendirir. Bir MCP sunucusu, araçları, girişleri ve çıkışları olan bir hizmettir ve aracıların bozulduğu yaygın bir yerdir: bir araç biraz farklı bir yük döndürür, bir zaman aşımı işlenmez, bir hata yolu yapılandırılmış veri yerine düz metin döndürür. Canlı bir aracıya bağlamadan önce MCP sunucusunu doğrudan, aracının onu kullanacağı şekilde test edin. Apidog ile MCP sunucusu testi hakkındaki kılavuzumuz, bir sunucunun hangi araçları açığa çıkardığını listelemeyi ve her birini kullanmayı kapsar. Apidog ayrıca bir yapay zeka aracısı ve A2A hata ayıklayıcı da içerir, böylece bir aracının oluşturduğu istek ve yanıt trafiğini sadece tahmin etmek yerine izleyebilirsiniz.

Aracının kendi istek davranışı. Aracılar API'leri insanların yapmadığı şekillerde çağırır: art arda yeniden denemeler, kısmi okumalar, model düşünürken aynı uç noktanın bir döngüde on kez çağrılması. Bu trafiği taklitlerinize karşı tekrar oynatın ve aracının aslında ne gönderdiğini izleyin. Canlı aracı ve A2A trafiğini yakalayan bir hata ayıklayıcının kendini gösterdiği yer burasıdır; bir kapalı bir deneme fırtınasını olay köprüsünde değil, hazırlık ortamında bulursunuz.

Mesele kendi başına araçlar değildir. Barındırma kararı ve test stratejisi bağlantılıdır. Yönetilen Aracılar döngüyü gizler, bu nedenle hatalara ilişkin görünürlüğünüz olay günlüğü ve kendi API düzeyindeki testleriniz aracılığıyla gelir. SDK döngüyü açığa çıkarır, bu nedenle onu kancalarla donatırsınız, ancak yine de aynı API düzeyindeki testlere ihtiyacınız vardır. Her iki durumda da, Apidog'u indirin ve aracı gerçek bir müşteriye yaklaşmadan önce bağımlılıklarını test edin.

Bir Karar Çerçevesi

Özellik bazında eziyeti atlayın ve bunları sırasıyla yanıtlayın. İlk güçlü evet sizi bir seçeneğe yönlendirir.

Aşağıdaki durumlarda Claude Yönetilen Aracılar'ı seçin:

• Aracınız uzun veya eşzamansız (dakikalar ila saatler, birçok araç çağrısı) çalışıyorsa ve bir iş yürütücüsü, sanal alan ve oturum deposu işletmek istemiyorsanız.
• Küçük bir ekipseniz ve operasyonel personel sayısı kısıtlayıcı faktörse, kontrol değil.
• Sıfırdan gözlemlenebilirlik oluşturmadan barındırılan, alınabilir bir olay günlüğü istiyorsanız.
• Veri ve uyumluluk duruşunuz, sanal alanın ve oturum durumunun Anthropic'in (veya AWS'nin) ortamında bulunmasına izin veriyorsa.
• Bazı özelliklerin bir araştırma önizleme isteğinin arkasında kısıtlandığı bir beta aşamasında olmaktan memnunsanız.

Aşağıdaki durumlarda Claude Aracı SDK'sını seçin:

• Aracı, özel bir veritabanı veya dahili hizmetin yanında, oturum durumunu tutan üçüncü bir taraf olmadan, VPC'nizin içinde çalışmak zorundaysa.
• Döngünün ince taneli kontrolüne ihtiyacınız varsa: özel izinler, denetim ve politika için kancalar, süreç içi araç mantığı.
• Veri yerleşimi veya düzenleyici kısıtlamalar, barındırılan bir sanal alanı dışlıyorsa.
• Döngüyü şirket içinde tutarken çıkarımın mevcut bir Bedrock, Vertex veya Azure sözleşmesi üzerinden faturalandırılmasını istiyorsanız.
• Yerel olarak prototipleme yapıyorsanız ve aracının bugün doğrudan dosya sisteminizde çalışmasını istiyorsanız.

Yaygın bir yol: Döngü hemen orada olduğu ve yineleme döngüsü sıkı olduğu için Aracı SDK'sı ile yerel olarak prototipleme yapın, ardından operasyonel tasarruflar kontrol kaybından daha ağır basarsa üretim için Yönetilen Aracılar'a geçin. Bu geçiş gerçek bir iştir, bir yapılandırma değişikliği değil, bu yüzden varsayılan olarak değil, bilinçli bir karar verin. Eğer bununla birlikte modelleri veya kodlama aracılarını da değerlendiriyorsanız, 2026 için Claude ve Codex karşılaştırmamız faydalı bir tamamlayıcı okumadır.

Gerçek Dünya Kullanım Durumları

Bir Ödeme İade Aracısı

Bir fintech destek ekibi, iade taleplerini uçtan uca işleyen bir aracı istiyor: bileti okuma, işlemi arama, iade politikasını kontrol etme, iadeyi gerçekleştirmek için ödeme API'sini çağırma ve bilete bir özet yazma. Bu aracı paraya dokunduğu için her API çağrısının test edilmiş bir sözleşmeye ve net bir denetim izine ihtiyacı var.

SDK burada doğal bir uyum sağlar. Aracının ödeme hizmetinin yanında VPC içinde çalışması, oturum durumunun şirketin altyapısından çıkmaması ve PreToolUse kancalarının belirli bir eşiğin üzerindeki her iadenin insan onayı gerektirdiğine dair katı bir kuralı uygulayabilmesi gerekir. Lansmandan önce ekip, Apidog'da ödeme ve defter uç noktalarını taklit eder, iade ve arama çağrıları için sözleşme testleri yazar ve aracının tam olarak ne gönderdiğini görmek için bir haftalık geçmiş biletleri taklitlere karşı tekrar oynatır. Buldukları yeniden deneme fırtınası hatası (aracının aslında başarılı olan bir 504 hatasından sonra bir iade çağrısını yeniden başlatması), bu test katmanının var olmasının tüm nedenidir.

Eşzamansız Bir Destek Bileti Ön Ayıklama Aracısı

Bir SaaS şirketi günde binlerce destek bileti alıyor ve bunları ön ayıklamak için bir aracı istiyor: sınıflandırma, ilgili günlükleri çekme, bir yanıt taslağı hazırlama ve ya çözme ya da üst kademeye iletme. Biletler günün her saati geliyor, her biri birkaç dakikalık araç çağrısı gerektiriyor ve ilgili veriler düşük hassasiyetli.

Yönetilen Aracılar bu yapıya iyi uyuyor. İş uzun süreli ve eşzamansız, ekip küçük ve otomatik ölçeklenen bir işçi filosu çalıştırmak istemiyor ve barındırılan olay günlüğü onlara bilet başına ücretsiz bir izleme sağlıyor. Yine de bağımlılıkları test ediyorlar: günlükleme API'si ve bilet sistemi MCP sunucusu Apidog'da taklit ediliyor ve sözleşme testi yapılıyor, böylece günlük hizmetindeki bir şema değişikliği ön ayıklama kalitesini sessizce düşürmez. Barındırma yönetiliyor; API doğruluğu hala onların işi.

Güvenlik Duvarı Arkasında Dahili Bir Veri Operasyonları Aracısı

Bir platform ekibi, dahili bir iş API'sini sorgulayarak, bir düzeltme betiği çalıştırarak ve durumu raporlayarak “dün başarısız olan ETL bölümlerini doldur” gibi dahili isteklere yanıt veren bir aracı istiyor. Dahili API'ler genel internette değil ve veriler hassas.

SDK varsayılan olarak kazanır. Aracı, özel hizmetlere ulaşabildiği yerde çalışmalı ve oturum durumu hakkında hiçbir şey üçüncü taraf bir sanal alanda bulunmamalıdır. Ekip, dahili hizmetleri MCP sunucuları olarak bağlar, her bir MCP aracını önce ayrı ayrı test eder ve aracının çalıştırdığı her komutu mevcut denetim hattına kaydetmek için SDK kancalarını kullanır. Bu, SDK'nın “sizin sürecinizde çalışır” özelliğinin bir tercih olmadığı, bir gereklilik olduğu durumdur. Aracılar neden birincil API tüketicisi haline geliyorlar hakkında bilgi için, yapay zeka aracıları yeni API tüketicileri olarak adlı yazımıza bakın.

Sonuç

Yönetilen Aracılar ile Aracı SDK'sı kararı, bir API tasarımı kılığına bürünmüş operasyonel ve veri yönetişimi kararıdır. İşte akılda tutulması gerekenler:

• Yönetilen Aracılar döngüyü ve sanal alanı barındırır; SDK bunları sizin sürecinizde çalıştırır. Bu tek gerçek, ödünleşimlerin çoğunu belirler.
• Maliyet bir şekildir, bir sayı değil: Yönetilen Aracılar, oturum başına saatlik çalışma ücreti ekler; SDK bu maliyeti işlettiğiniz altyapı ve nöbetçi ekibine kaydırır.
• Veri yerleşimi genellikle karar verir: düzenlenmiş veya VPC'ye bağlı veriler SDK'yı işaret eder; düşük hassasiyetli eşzamansız işler Yönetilen Aracılar'ı işaret eder.
• Operasyonel personel sayısı diğer belirleyici faktördür: küçük ekipler, yönetilen bir çalışma zamanı ve barındırılan olay günlüğünden en çok faydalanır.
• Barındırmadan bağımsız olarak bağımlılıkları test edin: aracı, yalnızca çağırdığı API'ler ve MCP sunucuları kadar güvenilirdir.
• SDK üzerinde prototipleme yapın, Yönetilen Aracılar üzerinde üretime alın makul bir yoldur, ancak geçişi bir proje olarak ele alın.
• Taahhütte bulunmadan önce **fiyatlandırmayı ve beta durumunu kaynaktan doğrulayın**; her ikisi de 2026'da gelişiyor.

Sonraki adım: bir aracıyı bir müşteriye dokunan herhangi bir şeye bağlamadan önce, API ve MCP bağımlılıklarını test edin. Bu uç noktaları taklit etmek, sözleşme testleri çalıştırmak ve aracının gerçek istek trafiğinde hata ayıklamak için Apidog'u indirin, böylece seçtiğiniz barındırma modeli zaten kanıtladığınız bağımlılıklar üzerine inşa edilir.

Sıkça Sorulan Sorular

Claude Yönetilen Aracılar ile Claude Aracı SDK'sı arasındaki temel fark nedir?

Yönetilen Aracılar, Anthropic'in aracı döngüsünü ve oturum başına sanal alanı çalıştırdığı barındırılan bir REST API'sidir; siz olayları gönderir ve sonuçları geri akışla alırsınız. Aracı SDK'sı, aynı döngüyü kendi sürecinizde ve altyapınızda çalıştıran bir Python veya TypeScript kütüphanesidir. Aynı Claude modelleri, farklı operasyonel sahiplik.

Claude Aracı SDK'sı, eski Claude Code SDK ile aynı mı?

Evet. Claude Code SDK, kodlama görevlerinin ötesinde daha geniş bir kapsamı yansıtmak için Claude Aracı SDK olarak yeniden adlandırıldı. Açığa çıkardığı aracı döngüsü, yerleşik araçlar ve bağlam yönetimi, Claude Code'a güç veren aynı mekanizmadır ve şimdi genel amaçlı bir aracı kütüphanesi olarak paketlenmiştir.

Hangi seçenek daha ucuz?

Bu, iş yükü şekline bağlıdır. Yönetilen Aracılar, standart Claude jeton oranlarına ek olarak aktif oturum süresi için bir çalışma ücreti alır, bu nedenle uzun süre düşünen aracılar çalışma maliyeti biriktirir. SDK'nın saat başına Anthropic çalışma ücreti yoktur, ancak hesaplama kaynaklarının parasını öder ve işletirsiniz. Güncel oranları Anthropic'in fiyatlandırma sayfasından doğrulayın; bir blog yazısındaki bir sayıdan bütçe yapmayın.

Her ikisiyle de MCP sunucularını kullanabilir miyim?

Evet. Her ikisi de harici araçları Model Bağlam Protokolü üzerinden yönlendirir. Bu nedenle, MCP sunucularınızı herhangi bir seçeneğe bağlamadan önce test etmek önemlidir; Apidog ile MCP sunucusu testi rehberimiz, bir sunucunun açığa çıkardığı her aracı bir aracının onu kullanacağı şekilde çalıştırmayı ele alır.

Müşteri verilerini Anthropic'in altyapısından nasıl uzak tutarım?

Aracı SDK'sını kullanın ve döngüyü kendi ortamınızda çalıştırın. SDK ile araç yürütme ve oturum durumu altyapınızda kalır ve yalnızca model çıkarımı Claude'a gider. Yönetilen Aracılar ile sanal alan ve olay günlüğü Anthropic'in ortamında (bazı sınırlamalarla bir AWS seçeneği mevcuttur) yaşar, bu da katı yerleşim kurallarını karşılamayabilir.

Claude Yönetilen Aracılar üretim için hazır mı?

Nisan 2026'da genel beta olarak piyasaya sürüldü ve her istekte managed-agents-2026-04-01 beta başlığını gerektiriyor. Çekirdek oturum işlevselliği API hesapları için genel olarak kullanılabilirken, sonuçlar ve çoklu aracı gibi bazı özellikler ayrı bir araştırma önizleme isteğinin arkasında kısıtlanmıştır. Beta olarak ele alın ve güncel durum için belgeleri kontrol edin.

Gerçek API'lere dokunmadan önce bir aracıyı nasıl test ederim?

Aracının çağırdığı her API'yi ve MCP sunucusunu taklit edin, istek ve yanıt şemaları üzerinde sözleşme testleri yazın ve aracının gerçekte ne gönderdiğini görmek için taklitlere karşı gerçekçi trafiği tekrar oynatın. Apidog, canlı aracı trafiğini incelemek için bir yapay zeka aracısı ve A2A hata ayıklayıcı dahil olmak üzere üçünü de kapsar. API'leri çağıran yapay zeka aracılarını nasıl test edeceğinize dair rehberimiz, hata modlarını ayrıntılı olarak açıklar.

Birinden başlayıp daha sonra diğerine geçebilir miyim?

Yapabilirsiniz ve yaygın bir yol, yerel olarak Aracı SDK'sı üzerinde prototipleme yapıp daha sonra üretim için Yönetilen Aracılar'a geçmektir. Ancak bu bir yapılandırma değişikliği değildir: arayüzler farklıdır (kütüphane ve REST artı olaylar), özel araç yürütmesi farklı çalışır ve oturum durumu dosya sisteminizden barındırılan bir günlüğe taşınır. Bunu bir geçiş projesi olarak planlayın.