Zamanlayıcı

Minimum kurulumla basit zaman tabanlı yürütme

Genel Bakış#

Astreus zamanlayıcısı (scheduler), sezgisel zamanlama dizeleri kullanarak görevler ve graph'lar için basit zaman tabanlı yürütme sağlar. Karmaşık bir yapılandırmaya gerek yok - sadece bir schedule alanı ekleyin, hepsi bu kadar!

Temel Görev Zamanlama#

Basit bir sözdizimiyle bireysel görevleri zamanlayın:

typescript
import { Agent } from '@astreus-ai/astreus';

const agent = await Agent.create({
  name: 'SchedulerAgent',
  model: 'gpt-6-astra'
});

// Create a scheduled task - scheduler starts automatically when needed
const scheduledTask = await agent.createTask({
  prompt: 'Generate monthly report for December',
  schedule: 'once@2024-12-25@09:00'
});

// Create a recurring task
const dailyTask = await agent.createTask({
  prompt: 'Daily health check and status report',
  schedule: 'daily@08:00'
});

// Execute the task - scheduler will handle the scheduling automatically
await agent.executeTask(scheduledTask.id);

Zamanlama Yapılandırması#

Kolay yapılandırma için basit zamanlama dizeleri kullanın:

typescript
// Supported schedule formats:
'daily@07:00'                    // Daily at 7 AM
'weekly@monday@09:00'            // Weekly on Monday at 9 AM
'monthly@1@10:00'                // Monthly on 1st day at 10 AM
'hourly'                         // Every hour (default time)
'@15:30'                         // Once today at 3:30 PM
'once@2024-12-25@10:00'          // Once on specific date and time

// Delay-based schedules:
'after:5s'                       // Run after 5 seconds
'after:30m'                      // Run after 30 minutes
'after:2h'                       // Run after 2 hours

// Examples:
await agent.createTask({
  prompt: 'Morning briefing',
  schedule: 'daily@08:00'
});

await agent.createTask({
  prompt: 'Weekly report',
  schedule: 'weekly@friday@17:00'
});

Bağımlılıklarla Graph Zamanlama#

Akıllı bağımlılık çözümlemesiyle graph'ları zamanlayın:

typescript
import { Graph } from '@astreus-ai/astreus';

const graph = new Graph({
  name: 'Morning Workflow',
  defaultAgentId: agent.id
}, agent);

// Node A: Data collection at 6 AM
const nodeA = graph.addTaskNode({
  name: 'Data Collection',
  prompt: 'Collect overnight data from all sources',
  schedule: 'once@2024-12-20@06:00'
});

// Node B: Processing (depends on A completing first)
const nodeB = graph.addTaskNode({
  name: 'Data Processing',
  prompt: 'Process collected data and generate insights',
  schedule: 'once@2024-12-20@07:00',
  dependsOn: ['Data Collection'] // Must wait for A
});

// Node C: Report generation at 8 AM
const nodeC = graph.addTaskNode({
  name: 'Report Generation',
  prompt: 'Generate morning executive report',
  schedule: 'once@2024-12-20@08:00',
  dependsOn: ['Data Processing']
});

// Execute - scheduler starts automatically for scheduled nodes
await graph.run();

// Result: A runs at 06:00, B waits and runs after A (~06:05), C runs at 08:00

Yinelenen Desenler#

Sofistike yinelenen zamanlamalar oluşturun:

Günlük Zamanlamalar#

typescript
// Every day at 8 AM
{
  type: 'recurring',
  executeAt: new Date('2024-12-20T08:00:00Z'),
  recurrence: {
    pattern: 'daily',
    interval: 1,
    maxExecutions: 365 // Stop after 1 year
  }
}

// Every 3 days
{
  type: 'recurring',
  executeAt: new Date('2024-12-20T08:00:00Z'),
  recurrence: {
    pattern: 'daily',
    interval: 3
  }
}

Haftalık Zamanlamalar#

typescript
// Every Monday at 9 AM
{
  type: 'recurring',
  executeAt: new Date('2024-12-23T09:00:00Z'), // Monday
  recurrence: {
    pattern: 'weekly',
    interval: 1,
    daysOfWeek: [1] // Monday
  }
}

// Every Monday and Friday
{
  type: 'recurring',
  executeAt: new Date('2024-12-23T09:00:00Z'),
  recurrence: {
    pattern: 'weekly',
    interval: 1,
    daysOfWeek: [1, 5] // Monday and Friday
  }
}

Aylık ve Yıllık#

typescript
// 15th of every month
{
  type: 'recurring',
  executeAt: new Date('2024-12-15T10:00:00Z'),
  recurrence: {
    pattern: 'monthly',
    interval: 1,
    dayOfMonth: 15
  }
}

// Every January 1st
{
  type: 'recurring',
  executeAt: new Date('2025-01-01T00:00:00Z'),
  recurrence: {
    pattern: 'yearly',
    interval: 1,
    monthOfYear: 1
  }
}

Bağımlılık Çözümleme Mantığı#

Zamanlayıcı, zamanlamalar ve bağımlılıklar arasındaki çakışmaları akıllıca çözer:

SenaryoDavranış
Düğüm, bağımlılıktan önce zamanlanmışBağımlılığın tamamlanmasını bekler
Düğüm, bağımlılıktan sonra zamanlanmışZamanlanan saatte çalışır
Birden fazla bağımlılıkTÜM bağımlılıkları bekler
Döngüsel bağımlılıklarDoğrulama sırasında hata fırlatılır
Karma zamanlanmış/anlık düğümlerSorunsuz biçimde birlikte çalışır

Zamanlayıcı, bağımlılıklara saygı gösteren ve ihtiyaçlarınıza göre ölçeklenen otomatik, zaman tabanlı AI iş akışları oluşturmak için sağlam bir temel sunar.