BroadRouter
Başlayın

Alt ajan (subagent)

Güncellendi

Alt ajan (subagent), ana ajanın odaklı tek bir görevi yürütmek için başlattığı ayrı bir ajandır. Kendi bağlam penceresi, sistem istemi ve araç erişimiyle çalışır, işi yapar ve ana ajana yalnızca bir sonuç veya özet döndürür; böylece ana konuşma küçük kalır.

Diğer adları: alt ajan, alt-ajan, yardımcı ajan, subagent, sub-agent, child agent

Alt ajan, ajanlar için görev devridir: tek bir işi yeni bir çalışana verin ve yalnızca cevabı geri alın.

Nasıl çalışır

Ana ajan, bir görevin kendi başına yürütülebileceğine karar verir; örneğin “bu fonksiyonu çağıran her yeri bul” veya “test paketini çalıştır ve hataları raporla”. Bir görev açıklamasıyla bir alt ajan başlatır. Alt ajan kendi ajan döngüsünü çalıştırır ve bir sonuç döndürür.

Claude Code belgeleri bunu şöyle ifade eder: “Each subagent runs in its own context window with a custom system prompt, specific tool access, and independent permissions.” (çeviri: Her alt ajan, özel bir sistem istemi, belirli araç erişimi ve bağımsız izinlerle kendi bağlam penceresinde çalışır.) Bir alt ajan, YAML frontmatter’ı olan bir Markdown dosyası olarak tanımlanır; proje düzeyinde .claude/agents/ içinde durur:

---
name: code-reviewer
description: Reviews code for quality and best practices
tools: Read, Glob, Grep
model: sonnet
---

You are a code reviewer. When invoked, analyze the code and provide
specific, actionable feedback on quality, security, and best practices.

(Örnekteki tanım İngilizcedir: kodu kalite ve en iyi uygulamalar açısından inceleyen, kalite, güvenlik ve en iyi uygulamalar hakkında somut ve uygulanabilir geri bildirim veren bir kod inceleyicisi.) Sayılan faydalar arasında keşif çalışmasını ana konuşmanın dışında tutmak, bir alt ajanın kullanabileceği araçları sınırlamak ve görevleri daha düşük maliyetli modellere yönlendirmek vardır.

Başka framework’lerde de benzer fikirler bulunur. OpenAI Agents SDK, “Handoffs allow an agent to delegate tasks to another agent” (çeviri: handoff’lar bir ajanın görevleri başka bir ajana devretmesini sağlar) der ve her handoff’u modele bir araç olarak sunar.

Anthropic’in bağlam mühendisliği yazısı kalıbı bağlam tarafından anlatır: her alt ajan temiz bir bağlam penceresinde çalışır ve “returns only a condensed, distilled summary of its work” (çeviri: işinin yalnızca yoğunlaştırılmış, damıtılmış bir özetini döndürür); bu özet çoğu zaman 1.000 ila 2.000 token’dır.

Neden önemli

  • Bağlam. Bir test çalıştırması on binlerce token çıktı basabilir. Bir alt ajanda bu çıktı ana bağlam penceresinin dışında kalır; yalnızca özet geri gelir. Bu, temel bir bağlam mühendisliği aracıdır.
  • Maliyet. Toplam token genellikle artar, çünkü her alt ajan kendi istemini ve araçlarını yükler. Çoklu ajan maliyeti yazısı bu çarpanı tahmin eder.
  • Paralellik. Aynı anda çalışan alt ajanlar paralel isteklerdir. Kaç tanesinin aynı anda çalışacağını sağlayıcınızın eşzamanlılık limiti belirler.

BroadNet Inference’ta

BroadNet modelleri sunar; alt ajan mantığı ajan aracınızda yaşar. OpenAI uyumlu bir base URL kabul eden her araç, ana ajanını ve alt ajanlarını BroadNet’e yönlendirebilir ve her biri için farklı modeller kullanabilir.

Kullandıkça öde modelinde bir anahtar aynı anda 4 isteğe izin verir. DeepSeek V4.1 Flash için sabit fiyatlı planlarda her oturum aynı anda bir istek çalıştırır; bu yüzden aynı anda işlemde olabilecek model isteklerini sayın: aynı anda çalışan üç alt ajan üç oturum ister, onlar çalışırken orkestratör de modeli çağırıyorsa dört. Sabit fiyatlı bir API’de paralel kodlama ajanları çalıştırma yazısı oturum sayısını ayrıntılı olarak ele alır.

Sık sorulan sorular

Alt ajan token tasarrufu sağlar mı?

Toplam token'dan değil, ana konuşmadaki bağlamdan tasarruf sağlar. Alt ajanın kendi istekleri de token harcar. Claude Code belgeleri, alt ajan isteklerinin de kullanımınızdan düştüğünü not eder ve basit alt ajan görevleri için daha küçük bir model önerir.

Bir alt ajan kendi alt ajanlarını başlatabilir mi?

Araca bağlıdır. Claude Code belgelerine göre bir alt ajan varsayılan olarak kendi alt ajanlarını, ana konuşmanın en fazla üç katman altına kadar başlatabilir ve bu sınırlandırılabilir.

Alt ajan ile handoff arasındaki fark nedir?

Alt ajan bir görev üzerinde çalışır ve kendisini çağıran ajana rapor verir. OpenAI Agents SDK'da handoff, bir ajanın başka bir ajana görev devretmesini sağlar ve handoff() yardımcısı kontrolü o ajana aktarır.

Markdown olarak okuChatGPT asistanına sorClaude asistanına sorPerplexity asistanına sor