> tpl_air_037
Planlayıcı-Yürütücü (Planner-Executor) Sözleşmesi
Ayrıştırılmış çok adımlı ajan sistemlerini yöneten, görev ayrıştırma DAG şemalarını, adım önkoşul doğrulamasını, ara durum karalama defterlerini, araç hatalarında dinamik yeniden planlama tetikleyicilerini ve deterministik döngü sonlandırma sınırlarını kurallara bağlayan resmi arayüz ve durum makinesi sözleşmesi.
Görev ayrıştırma DAG'larını, karalama defterlerini, yeniden planlama tetikleyicilerini ve döngü sınırlarını kurallara bağlayan ajan sözleşmesi.
Önemli Teknik Doküman Şablonu ve Hukuki Uyarı
TinyCTO.tv Teknik Doküman Şablon Bildirimi: Bu şablon genel eğitim ve operasyon amaçlı bir başlangıç materyalidir. Hukuki, vergisel, muhasebesel, yatırım, satın alma, mevzuat, güvenlik veya sertifikasyon danışmanlığı değildir. Gereklilikler ülkeye, kuruma, sözleşmeye ve riske göre değişir. Kullanmadan önce yetkin uzmanlarla gözden geçirip uyarlayın.
Çözülen Üretim Problemi
Monolitik tek istemli ajanlar akıl yürütme ve araç çalıştırmayı aynı anda yapmaya çalışır; bu da kaotik halüsinasyonlara, unutulan ara adımlara, ele alınmayan API hata döngülerine ve felaket düzeyinde deterministik olmayan sistem çöküşlerine yol açar.
Ne Zaman Kullanılmalı?
- •Ayrı planlama, araç çalıştırma ve yansıtma (reflection) aşamaları gerektiren karmaşık otonom iş akışları tasarlarken
- •Bir ajanın büyük bir hedefi yönlendirilmiş görev grafiğine (DAG) bölmesi gereken LangGraph veya Temporal durum makineleri kurarken
- •Araçlar hata verdiğinde deterministik hata yönetimi ve dinamik yeniden planlama mekanizmaları oluştururken
Ne Zaman Kullanılmamalı?
- •Çok adımlı araç bağımlılığı olmayan basit tek adımlı sohbet botlarında
- •Tekil API uç noktalarını ve parametre şemalarını kaydederken (TPL-AIR-035 kullanın)
5 Şablon Bölümü ve Yapısal İskelet
Yüksek akıl yürütücü Planlayıcı (DAG üreten) ile hızlı Yürütücünün (araç çağıran) birbirinden ayrılması. Bağlam kirliliğini ve araç halüsinasyonlarını önleme.
Görev ayrıştırması için resmi Pydantic şeması: Adım ID, sıralı bağımlılıklar, hedef araç, zorunlu parametreler, beklenen çıktı şeması ve zaman aşımı.
Merkezi durum tahtası (LangGraph State / Postgres): Tamamlanan adımların çıktılarını, notları, ham yanıtları ve token tüketimini saklama.
Sürtünme yönetimi: Bir araç hata verdiğinde durum makinesinin "Yeniden Planla" olayını tetiklemesi ve planlayıcıya alternatif bir alt plan ürettirmesi.
Güvenli sonlandırma: Kesin tavan sınırları (En fazla 10 adım, 50.000 token, 120 saniye süre). Deterministik çıkış durumları: BAŞARILI, KISMİ, TÜKENDİ, ZAMAN_AŞIMI.
Doldurma ve Uygulama Yönergeleri
Bağımsız İnceleme ve Onay Kontrol Listesi
- Tüm zorunlu bölümler dolduruldu
- Gizli anahtar veya parola içermiyor
- Yönetici sponsor onayı alındı
Planlayıcı-Yürütücü (Planner-Executor) Sözleşmesi - Örnek Vaka Analizi
Örnek Organizasyon: Küresel Tedarikçi Faturalarını Denetleyen Çok Adımlı Otonom Finansal Uyum Ajanı
Küresel Tedarikçi Faturalarını Denetleyen Çok Adımlı Otonom Finansal Uyum Ajanı için eksiksiz operasyonel uygulamayı gösteren gerçek dünya vaka analizi.
- •Karmaşık 8 adımlı denetim hedefini açık bağımlılık kapıları olan doğrulanmış bir DAG grafiğine ayrıştırdı
- •ERP API hız sınırı hatasını önbelleğe alınmış ikincil uç noktayı kullanan dinamik yeniden planlama ile çözdü
- •Katı 10 adım tavanı uygulayarak kontrolsüz ajan döngülerini ve bütçe aşımını tamamen engelledi
Sıkça Sorulan Sorular
Ajan iş akışlarında Planlayıcı ile Yürütücüyü birbirinden ayırmak neden zorunludur?
Tek bir istem aynı anda hem strateji geliştirmeye hem de araç parametrelerini çalıştırmaya kalktığında, bağlam penceresi araç çıktılarıyla dolar; bu da modelin ana hedefi unutmasına veya sahte parametreler uydurmasına yol açar. Çift beyinli mimari planlamayı yüksek akıl yürütücü modele, yürütmeyi ise hızlı bir araç çağırma döngüsüne devreder.
Ara adımlardan birinde araç çağrısı hata verdiğinde dinamik yeniden planlama nasıl işler?
Bir araç çağrısı kurtarılamaz bir hata aldığında (ör. API 500 veya kaynak bulunamadı) yürütücü körü körüne denemez. Hata imzasını kaydeder, o dalı duraklatır ve Planlayıcıya bir istisna olayı gönderir. Planlayıcı durumu inceleyip tıkalı dalı iptal eder ve hedefe ulaşmak için alternatif bir alt DAG grafiği üretir.
Planlayıcı-Yürütücü mimarisinin sonsuz döngülerle binlerce dolar harcaması nasıl önlenir?
Üretim standartlarındaki ajan sözleşmeleri katı deterministik sınırlar koyar: 1. Azami adım bütçesi (ör. 10 adım), 2. Kesin token harcama tavanı (ör. 50 bin token), 3. Zaman aşımı süresi (ör. 120 saniye) ve 4. Azami 2 yeniden planlama hakkı. Bu sınırlardan herhangi biri aşıldığında sistem derhal durur.
Teknik Doküman Şablon Paketi
Giriş GerekliTüm boş şablonları, işlenmiş senaryoları ve doğrulama manifestolarını tek bir arşivde indirin.
Yetkili Standartlar ve Kaynaklar
- ReAct: Synergizing Reasoning and Acting in Language ModelsYao et al. / Princeton University & Google Research • OFFICIAL REQUIREMENT
- Plan-and-Solve Prompting: Improving Zero-Shot Chain-of-Thought ReasoningWang et al. / ACL 2023 • OFFICIAL REQUIREMENT
- LangGraph: Multi-Agent State Machine and Cyclic Graph ArchitectureLangChain AI • OFFICIAL REQUIREMENT