ai-agent-book/chapter4/README.tr.md

Bölüm 4 · Araçlar

Araçlar bir Agent'ın elleridir. Araç sınıflandırması ve genel tasarım ilkelerini, MCP protokolünü ve araç seçimi zorluklarını, üç tür aracı (algı, yürütme, işbirliği) ve olay güdümlü asenkron Agent'ları ele alır.

← Ana README'ye dön · 📖 Bölüm metnini oku

Deneyler nasıl okunur

Metin, kontrol akışını açıklamak için kısa mekanizma skeleton'ları kullanır; deney dizininde tam SDK adaptörleri, günlükler, testler ve kabul kanıtı bulunur. Her dosyayı satır satır okumanız gerekmez.

• Starter: Hedef, en kısa komut ve kabul koşullarıyla başlayın; önce async-agent;
• Builder: Giriş noktasını, ana döngüyü, durum/mesaj şemasını, araçları ve doğrulayıcıyı izleyin.
• Maintainer: Son olarak testleri, kanıt manifestlerini, hata işlemeyi, rollback yollarını ve sağlayıcı adaptörlerini okuyun.

İlk okumada kimlik bilgisi yükleme, sunum katmanı ve sağlayıcı uyumluluğunu atlayıp sayıları yeniden üretirken dönün.

Eşlik Eden Projeler

Proje	Tür	Açıklama
perception-tools	✅	Web araması, çok modlu anlama, dosya sistemi işlemleri ve kamuya açık veri kaynaklarına erişim yetenekleri sunan kapsamlı bir algı aracı seti inşa eder. Çoğu özellik ücretsiz, açık API'lere dayanır (DuckDuckGo, Open-Meteo, Yahoo Finance, OpenStreetMap vb.) ve API anahtarı gerektirmez.
multimodal-agent	✅	Çok modlu işleme: yerel çok modlu, metne çıkarım ve araç tabanlı analizi karşılaştırır.
execution-tools	✅	Dosya işlemleri, bir kod yorumlayıcı, sanal terminal ve harici sistem entegrasyonu dahil, güvenlik mekanizmalarına sahip bir yürütme aracı seti uygular. İkincil bir LLM onay mekanizmasıyla tehlikeli işlemleri önler, karmaşık çıktıları otomatik özetler ve kod üzerinde sözdizimi doğrulaması yapar.
collaboration-tools	✅	Tarayıcı otomasyonu (browser-use çerçevesi), İnsan-Döngüde (Human-in-the-Loop), çok kanallı bildirimler (E-posta, Telegram, Slack, Discord) ve zamanlayıcı yönetimi dahil kapsamlı işbirliği yetenekleri sunar. Hassas işlemler için yönetici onayını ve zamanlanmış görev dağıtımını destekler.
active-tool-selection	✅	Agent'ın önceden tanımlanmış bir araç kümesini pasif olarak kabul etmek yerine, görev gereksinimlerine göre en uygun araç kombinasyonunu aktif olarak seçmesini sağlayan akıllı bir araç seçim mekanizması uygular.
active-tool-discovery	✅	İki paradigmayı karşılaştırır: "120+ araç şemasının tümünü enjekte etmek" ile "aktif, istendiğinde keşif." İkincisi, sistem isteminde yalnızca birkaç temel araç ve bir discover_tools meta-aracını tutar; bir araç kütüphanesinden en ilgili 3-5 uzman aracı getirmek için gömme benzerliğini kullanır. Bu, token tasarrufu sağlar ve modelin aşırı uzun bir listeden yanlış araç seçmesini veya yanlış kullanmasını önler.

Ayrıca, chapter4/docker-compose.yml ve chapter4/DOCKER_DEPLOYMENT.md, yukarıdaki MCP araç sunucularını konteynerleştirme ve dağıtma için bir referans çözüm sunar.

Proje Türleri

İkon	Tür	Anlamı
✅	Bağımsız	Bu depoda tam kod, API Key yapılandırıldıktan sonra çalışır
📖	Yeniden Üretim Rehberi	git clone ile harici depolara bağımlı ayrıntılı belge
🚧	Tasarım Belgesi	Yalnızca mimari/uygulama planı, çalıştırılabilir kod henüz hazır değil