# Ajanlar

## Ajanlar Nedir?

Ajanlar, sorunları akıl yürüterek çözen, görevleri yürüten ve birden fazla platform üzerinde iletişim kuran yalıtılmış yapay zeka asistanlarıdır. Her ajanın kendi çalışma alanı, oturum geçmişi, model yapılandırması ve kanal bağlamaları vardır.

## Ajan Yalıtımı

Her ajan şunları alır:

- **Çalışma Alanı**, Dosyalar, notlar ve ajana özgü veriler için ayrılmış bir dizin
- **Oturumlar**, Bağımsız konuşma geçmişi ve dökümleri
- **Yapılandırma**, Model seçimi, araç izinleri, harcama limitleri
- **Kimlik**, Ajanın `AGENTS.md` dosyasında tanımlanan benzersiz bir kişilik
- **Kimlik Doğrulama Profilleri**, Ajan başına API anahtarı ve kimlik doğrulama yapılandırmaları

## Ajan Kişilikleri

Her ajanın çalışma alanı, kişiliği, talimatları ve davranış kurallarını tanımlayan bir `AGENTS.md` dosyası içerir. Bu kalıcı sistem istemi, ajanın nasıl yanıt verdiğini şekillendirir, ton, alan uzmanlığı, biçimlendirme, araç kullanımı ve güvenlik politikaları.

## Çok Ajanlı Yönlendirme

Birden fazla ajan çalıştırırken, gelen mesajlar **bağlamalara** göre otomatik olarak yönlendirilir:

- **Kanal bağlama**, Bir platformdan gelen tüm mesajları yönlendirin (ör. tüm Telegram → `kişisel` ajan)
- **Sunucu/çalışma alanı bağlama**, Belirli bir Discord sunucusunu veya Slack çalışma alanını ayrılmış bir ajana yönlendirin
- **Sohbet türü bağlama**, Özel mesajları bir ajana, grup mesajlarını başka bir ajana yönlendirin
- **İletişim/eş bağlama**, Belirli kişilerden gelen mesajları belirli ajanlara yönlendirin

Bağlamalar öncelik sırasına göre değerlendirilir. İlk eşleşen kazanır. Eşleşmeyen mesajlar varsayılan ajana gider.

## Alt Ajanlar ve Delege Etme

Ajanlar, özel görevler için alt ajanlar oluşturabilir:

- **Görev delegasyonu**, Karmaşık görevleri parçalara ayırın ve uzman alt ajanlara devredy edin
- **Yalıtılmış yürütme**, Alt ajanlar kendi oturum bağlamlarında çalışır
- **Ping-pong konuşmaları**, Ajanlar iş birliği yapmak için ileri geri alışveriş yapabilir (en fazla 5 tur)
- **Sonuç duyurusu**, Alt ajan sonuçları orijinal kanala geri gönderilebilir

## Ekipler ve Düzenleme

Çok ajanlı ekipler, koordineli iş akışlarını mümkün kılar:

- **Paralel yürütme**, Bir görevin farklı yönleri üzerinde birden fazla ajanı eşzamanlı olarak çalıştırın
- **Sıralı işlem hatları**, Her birinin bir öncekinin çıktısı üzerine inşa ettiği ajanları zincirleyin
- **Karma mod**, Paralel ve sıralı yürütmeyi birleştirin
- **Görev takibi**, Her ajanın çalışmasının durumunu izleyin (kuyrukta, çalışıyor, tamamlandı, hata, iptal edildi)

## Araç Profilleri

Her ajanın neler yapabileceğini kontrol edin:

| Profil | Kullanılabilir Araçlar |
|---------|----------------|
| **minimal** | Yalnızca oturum durumu |
| **coding** | Dosya G/Ç, yürütme, oturumlar, bellek, görüntüler |
| **messaging** | Mesaj gönderme, oturum geçmişi |
| **full** | Tüm araçlar (varsayılan) |

Özel izin verme/reddetme listeleri, ajan başına ve model sağlayıcısı başına ayarlanabilir.

## Güvenli Mod

Güvenli Mod, bir yürütme sanal alanı sağlar:

- **Ana geçiş**, Genel olarak etkinleştirin veya devre dışı bırakın
- **Ajan başına kontroller**, Güvenilen ajanlar için devre dışı bırakın, diğerleri için açık tutun
- **Yürütme onayı**, Hassas işlemler açık kullanıcı onayı gerektirir
- **Politika senkronizasyonu**, Ayarlar, gerçek zamanlı olarak tüm bağlı istemcilerde senkronize edilir

## Ajan Belleği

Her ajanın bir bellek sistemine erişimi vardır:

- **MEMORY.md**, Oturumlar arası kalıcı notlar ve önemli bilgiler
- **Bellek dosyaları**, `memory/` dizinindeki ek yapılandırılmış bilgiler
- **Vektör arama**, Doğal dil sorgularını kullanarak bellekte arama yapın

Ayrıntılar için [Oturumlar ve Bellek](sessions-memory.md) bölümüne bakın.