Zamanlayıcı / Planlama Ajanı

Çok adımlı bir süreci sıralı alt görevlere bölen, her birini zamanlayan ve tam zamanı geldiğinde doğru ajanı tetikleyen backend ajanı.

Zamanlayıcı / Planlama Ajanı Nedir?

Zamanlayıcı / Planlama Ajanı, TotalApp'in Temel Ajanlarından biridir. Uzun, çok adımlı bir süreci — bir projenin onay zincirini, çok aşamalı bir işe alım akışını — sıralı alt görevlere böler, her birini zamanlar ve o adımın tam zamanı geldiğinde SSE veya webhook aracılığıyla doğru ajanı tetikler.

Çok adımlı bir süreç, tek bir adım olarak çalıştırılamayacak kadar uzun ve dış zamanlamaya bağımlıdır. Zamanlayıcı / Planlama Ajanı, adımlar arasındaki devirleri sahiplenir: her iş akışı yazarının kendi geçici zamanlama mantığını inşa etmesi yerine, planı ayrıştırır, bağımlılıkları takip eder ve her alt görevin tetikleyicisini doğru anda ateşler.

Tek cümlede

Zamanlayıcı / Planlama Ajanı'na çok adımlı bir hedef verin — onu bağımlılık farkında, sıralı alt görevlere ayrıştırır ve her biri için doğru ajanı, ister tek seferlik ister tekrarlayan bir programda olsun, tam zamanı geldiğinde tetikler.

Nasıl Çalışır — Planla, Zamanla, Tetikle

1. Görev Ayrıştırma → 2. Bağımlılık Zamanlaması → 3. Zamanlanmış Tetikleme

Aşama	Ne olur
1. Görev Ayrıştırma	Çok adımlı bir süreç, açık bağımlılıkları olan alt görevlere ayrıştırılır. Tam plan, yürütmeye başlamadan önce görünür ve düzenlenebilirdir.
2. Bağımlılık Zamanlaması	Ajan hem sıralı adımları hem de paralel çalışabilecek adımları işler ve önceki bir adımın sonucu bir sonrakini değiştirirse otomatik olarak yeniden planlar.
3. Zamanlanmış Tetikleme	Her adım SSE veya webhook aracılığıyla ateşlenir — hiçbir tarafta yoklama (polling) döngüsü gerekmez. Beklenen tamamlanma penceresini geçen adımlar sıkışmış olarak işaretlenir.

Tek seferlik planları ve tekrarlayan programları aynı şekilde işler

Aynı ayrıştırma ve tetikleme mekanizması hem tek bir çok adımlı planı (belirli bir projenin onay zinciri) hem de tekrarlayan zamanlanmış bir iş akışını (aylık bir kapanış süreci) besler — ikisi için ayrı bir sistem yoktur.

Temel Yetenekler

Otomatik Ayrıştırma

Uzun bir süreci, yürütme başlamadan önce görünür ve düzenlenebilir, bağımlılıkları olan net, ayrı ayrı zamanlanabilir alt görevlere böler.

SSE & Webhook Tetikleyicileri

Bir adımın tam zamanı geldiğinde doğru ajanı ateşler — yoklama gerekmez, gereksiz ek yük olmadan sistemi duyarlı tutar.

Tekrarlayan & Tek Seferlik

Aynı temel mekanizmayla hem tek bir çok adımlı planı hem de tekrarlayan zamanlanmış bir iş akışını işler.

Tam Yürütme Zaman Çizelgesi

Sistemde çalışan herhangi bir plan için her adımın geçmiş ve devam eden durumunu görün — bir plan yürütülmeye başladıktan sonra hiçbir şey opak değildir.

Çıktı — Geriye Ne Döner

Alan	Anlamı
`plan`	Yürütme başlamadan önce görünür olan, bağımlılıklarıyla birlikte ayrıştırılmış alt görev listesi.
`step_status`	Adım başına durum — beklemede, devam ediyor, tamamlandı veya sıkıştı — tam yürütme zaman çizelgesi için.
`next_trigger`	Bir sonraki bekleyen adımın ne zaman ve nasıl (SSE veya webhook) ateşleneceği.

Sıkışan adımlar sonsuza kadar sessizce yeniden denenmez, işaretlenir

Beklenen tamamlanma penceresini bitmeden geçen bir adım, sonsuza kadar sessizce yeniden denenmek yerine açıkça sıkışmış olarak işaretlenir — bu, bozuk devirleri maskelemek yerine gün yüzüne çıkarır.

Sıkça Sorulan Sorular

Planı çalışmaya başlamadan önce görebilir miyim?

Evet — adım sırası ve bağımlılıkları dahil tam ayrıştırılmış plan, yürütme başlamadan önce görünür ve düzenlenebilir.

Önceki bir adım bir sonraki adımda olması gerekeni değiştirirse ne olur?

Ajan otomatik olarak yeniden planlar — kalan alt görevler ve zamanlamaları, katı, önceden belirlenmiş bir sırayı takip etmek yerine az önce tamamlanan adımın gerçek sonucuna göre ayarlanır.

Adım tamamlanmasını yoklar mı?

Hayır — tetikleme, bir yoklama döngüsü değil olay tabanlıdır (SSE veya webhook aracılığıyla); bu, çok sayıda adımı olan veya aralarında uzun gecikmeler bulunan planlar için bile ek yükü düşük tutar.

Sıkışan bir adım nasıl gün yüzüne çıkarılır?

Beklenen tamamlanma penceresini geçtiğinde yürütme zaman çizelgesinde işaretlenir ve bu, doğru kişilerin daha sonra keşfetmek yerine hemen bilgilendirilmesi için Bildirim / Uyarı Ajanı'na bağlanabilir.