İçeriğe geç
ajan.io

Belgeler menüsü

Bu sayfada

Zamanlanmış tetikleyici

Esnek zamanlama seçenekleriyle iş akışlarını yinelenen bir zamanlamada otomatik çalıştırın.

Genel bakış

Zamanlanmış tetikleyici, iş akışınızı belirtilen zamanlarda veya aralıklarla otomatik çalıştırır. Günlük raporlar, saatlik veri senkronları veya aylık temizlik görevleri ihtiyacınız olsun, zamanlanmış iş akışları yinelenen otomasyonları güvenilir biçimde yönetir.

En uygun olduğu durum: Günlük raporlar, periyodik veri senkronları, yinelenen bakım görevleri, zamanlanmış analiz ve zamana dayalı otomasyonlar.

Zamanlanmış tetikleyiciyi ne zaman kullanmalı?

İdeal olduğu durumlar:

  • Günlük, haftalık veya aylık raporlar
  • Sistemler arasında periyodik veri senkronizasyonu
  • Zamanlanmış veri analizi ve içgörüler
  • Yinelenen bakım veya temizlik görevleri
  • Zamana dayalı izleme ve uyarılar

İdeal olmadığı durumlar:

  • Olay odaklı iş akışları (Webhook veya Entegrasyon tetikleyicisi kullanın)
  • Kullanıcı başlatmalı süreçler (Manuel veya Form tetikleyicisi kullanın)
  • Gerçek zamanlı veri işleme

Yapılandırma

Zamanlama seçenekleri

Hızlı zamanlamalar (Görsel oluşturucu)

  • Birkaç dakikada bir
  • Her saat
  • Belirli saatte her gün
  • Belirli günlerde her hafta
  • Belirli tarihte her ay
  • Özel zaman aralığı istemi

Cron ifadesi

Perde arkasında tüm zamanlamalar yinelenen zamanlamaları tanımlamak için standart bir biçim olan cron ifadeleri olarak saklanır. Arayüz kolaylık için hızlı zamanlama seçenekleri sunar; ancak alttaki veri 5 alanlı bir cron dizesidir.

Cron biçimi: minute hour day-of-month month day-of-week

Alanİzin verilen değerler
Dakika0-59
Saat0-23
Ayın günü1-31
Ay1-12
Haftanın günü0-6 (Pazar = 0)

Örnek cron ifadeleri:

ZamanlamaCron ifadesi
Her gün saat 09:000 9 * * *
Her saat0 * * * *
Her Pazartesi saat 08:000 8 * * 1
Her ayın 1’i gece yarısı0 0 1 * *
Her 15 dakikada*/15 * * * *

Cron ifadelerini elle yazmanız gerekmez—görsel oluşturucu bunu sizin için yapar. Ancak biçimi anlamak, zamanlama sorunlarını giderirken yardımcı olabilir.

Saat dilimi

Zamanlamanız için saat dilimini ayarlayın:

  • Hesap saat diliminize varsayılan olarak ayarlanır
  • Tüm standart saat dilimlerini destekler
  • Küresel dağıtılmış ekipler için kritiktir

Örnek kullanım senaryoları

Günlük satış raporu

text
Scheduled Trigger (Daily at 9 AM)
→ HTTP Request: Fetch yesterday's sales data
→ Code: Calculate metrics (total, growth, top products)
→ Agent: Generate executive summary
→ Notification: Email report to sales team

Saatlik veri senkronu

text
Scheduled Trigger (Every hour)
→ HTTP Request: Fetch new records from API
→ Loop: For each record
  → Code: Transform data format
  → HTTP Request: POST to destination system
→ Notification: Summary of records synced

Haftalık temizlik görevi

text
Scheduled Trigger (Weekly on sunday)
→ HTTP Request: Fetch records older than 90 days
→ Loop: For each old record
  → HTTP Request: Archive to cold storage
  → HTTP Request: Delete from active database
→ Notification: Cleanup summary

Aylık faturalama

text
Scheduled Trigger (1st of the month)
→ HTTP Request: Get all active subscriptions
→ Loop: For each subscription
  → Code: Calculate billing amount
  → HTTP Request: Create invoice
  → Action: Send invoice email
→ Notification: Billing run complete

Zamanlanmış iş akışlarını test etme

Manuel test çalıştırmaları

  1. Zamanlanmış tetikleyici düğümüne tıklayın
  2. Tek seferlik bir çalıştırma tetiklemek için "Test"e tıklayın
  3. Geçerli zaman damgasıyla yürütmeyi inceleyin
  4. Zamana dayalı mantığın doğru çalıştığını doğrulayın

En iyi uygulamalar

Kaynak yoğun iş akışlarını sistemlere etkiyi azaltmak için yoğun olmayan saatlere (geceler, hafta sonları) zamanlayın.

Zamanlanmış iş akışları için her zaman hata bildirimleri ekleyin. Çalıştıklarında izlemiyor olacaksınız.

Sisteminiz zamanlanmış bir çalıştırma sırasında kapalıysa, kaçırılan yürütmeyi telafi etmeniz mi yoksa atmanız mı gerektiğine karar verin.

Zamana dayalı mantığın doğru çalıştığından emin olmak için iş akışınızı farklı zaman damgalarıyla test edin (ör. ay sonu, artık yıllar).

Gerektiğinden daha sık zamanlamayın. Her 5 dakika aşırı olabilir—saatliğin işe yarayıp yaramayacağını düşünün.

Zamanlanmış iş akışlarınızın ne kadar sürdüğünü izleyin. Yürütme süresi aralığa yakınsa örtüşme riski vardır.

Sorun giderme

Kontrol edin:

  • İş akışı dağıtılmış (taslak değil)
  • İş akışı etkin
  • Zamanlama doğru yapılandırılmış
  • Aylık limite ulaşılmamış

Kontrol edin:

  • Saat dilimi ayarı beklentiyle eşleşiyor
  • Cron ifadesi doğru
  • Yaz saati değişiklikleri (kaçınmak için UTC kullanın)

Çözümler:

  • Daha küçük iş akışlarına bölün
  • Zamanlama aralığını artırın
  • Yavaş düğümleri optimize edin (yapay zeka çağrılarını toplulaştırın, paralel istekler)

Sonraki adımlar