Teknik rehber
Yapay zekâ ajanı mimarisi: güvenilir iş akışlarının bileşenleri

yapay zekâ ajanı mimarisi, bir modelin etrafındaki yazılım sistemidir: durum, erişim, araçlar, orkestrasyon, güvenlik ve değerlendirme. İyi bir mimari belirsizliği ve hataları konuşma arayüzünün arkasına saklamak yerine görünür kılar.
Araştırma ve şeffaflık: Mimari öneriler şu kuruluşların resmi belgelerine dayanır: OpenAI, Anthropic, LangChain, NISTBelgeler 2 Eylül 2026 tarihinde incelendi.
Referans katmanları
| Katman | Sorumluluk | Tasarım sorusu |
|---|---|---|
| Arayüz | Hedefleri alır ve durumu gösterir | Kullanıcı neyi onaylamalı? |
| Orkestratör | Adımları, tekrarları ve durmayı yönetir | Her geçiş kaydedilebilir mi? |
| Model | Bağlamı yorumlar ve eylem önerir | Hangi çıktı şeması gerekli? |
| Bağlam | Dosya, bellek ve durumu alır | Erişim izinleri alma işleminden önce uygulanıyor mu? |
| Araçlar | Dış eylemleri yürütür | Çağrılar sınırlı ve idempotent mi? |
| Değerlendirme | Kalite ve güvenliği ölçer | Hangi hatalar yayını engeller? |
Durum ve bellek
Bir çalıştırmanın geçici durumunu kalıcı proje belleğinden ayırın. Alınan gerçeklerle birlikte kaynak ve zaman damgasını saklayın. Kaynak ve inceleme politikası olmadan önceki model yanıtını yetkili bellek saymayın.
Mimari ile iş akışını ayırmak için [ajan tabanlı iş akışı rehberine](https://ottermind.ai/blog/what-is-an-agentic-iş akışı) bakın: mimari sistem sınırlarını, iş akışı ise sistemin yaptığı düzenli işi açıklar.
Araç sınırları
Sınırsız kimlik bilgileri yerine dar kapsamlı işlevler sunun. Argümanları doğrulayın, zaman aşımı belirleyin ve gönderme, silme, satın alma veya izin değiştirme işlemlerinde onay isteyin. Tekrarların yan etkileri çoğaltmaması için idempotency anahtarları kullanın.
Retrieval ve grounding
Yalnızca kullanıcının erişebildiği içeriği alın. Kaynak kimliklerini bağlama ekleyin ve çıktıda alıntı veya kanıt alanları isteyin. Alma boş ya da çelişkiliyse boşluğu doldurmak yerine eskalasyon durumu döndürün.
Geri alınabilir bir parçayla başlayın
Yazma erişimi vermeden önce salt okuma görevini prototipleyin. Kaynaklara dayalı bir özet veya sınıflandırma sonucu, geri döndürülemez risk almadan yararlı izler sağlar. Her seferinde bir araç ekleyin ve izin sınırını kaydedin.
İstek ve yanıt sözleşmeleri
Katmanlar arasında sözleşme tanımlayın. İstek hedefi, kimliği, izin verilen kaynakları ve bütçeyi; yanıt ise durumu, yapılandırılmış çıktıyı, alıntıları, araç çağrılarını ve inceleme bekleyen öğeleri içermelidir.
{
"status": "needs_review",
"claims": [],
"sources": [],
"open_questions": ["Onaylı veri kümesinde en son çeyrek bulunmuyor."]
}Açık bir durum, eksik kaynağı gizleyen akıcı bir paragraftan daha güvenlidir.
Değerlendirme ve operasyon
Normal, eksik, kötü niyetli ve çok dilli test örnekleri oluşturun. Araç hatalarını, eskalasyon oranını, gecikmeyi, maliyeti ve inceleme düzeltmelerini izleyin. Promptları, araçları, model ayarlarını ve politikaları birlikte sürümleyin.
Üretim kontrol listesi
- Her çağrı ve model sürümü için yeniden oynatılabilir izler
- Test ve üretim için ayrı kimlik bilgileri ve veriler
- İdempotent yazmalar ve belgelenmiş geri dönüş yolu
- Her istem veya model değişikliğinden önce değerlendirme
- Eskalasyon ve olaylardan sorumlu bir kişi
Eşzamanlı, eşzamansız ve insan kontrol noktaları
Kısa sınıflandırmalar eşzamanlı çalışabilir. Uzun erişim veya belge üretimi ilerleme ve iptal desteğiyle eşzamansız olmalıdır. Geri alınamaz işlemlerden önce ve güven, izin veya politika kontrolü başarısız olduğunda insan onayı ekleyin. Yeniden denemede bağlamın korunması için kararı çalışma durumunda saklayın.
Maliyet ve gecikme bütçeleri
Model turları, araç çağrıları, token ve toplam süre için üst sınır belirleyin. Basit çıkarımda küçük model kullanın, pahalı akıl yürütmeyi belirsiz durumlara ayırın. Bütçe hem operasyon kontrolüdür hem de akışın ne zaman durup yardım isteyeceğini gösterir.
SSS
Çok ajanlı mimariye ihtiyacım var mı?
Hayır. Bir ajan ve açık araçlarla başlayın. Rolleri, izinleri veya değerlendirme ölçütleri gerçekten farklıysa başka ajanlar ekleyin.
Güvenlik nereye yerleştirilmeli?
Her katmana: kimlik, retrieval, araç izinleri, sırlar, günlükler ve insan onayı. Güvenlik sonradan eklenen bir madde değildir.
Halüsinasyonları nasıl azaltırım?
Kaynakları iyileştirin, çıktıyı sınırlayın, kanıt isteyin ve belirsizliği inceleme eylemine dönüştürün. Tek başına istem yeterli değildir.
İlk olarak neyi prototiplemeliyim?
Belirli bir inceleyeni olan, sınırlı ve geri alınabilir bir iş akışı. Daha fazla araç eklemeden önce kontrol yolunu doğrulayın.
