Rutinler

İşi bir takvime göre ya da bir webhook'tan çalıştırın. Rutin oluşturun, tetikleyici ekleyin, değişkenleri ve çakışma kurallarını ayarlayın, elle çalıştırın ve geçmişini okuyun.

Veyra Docs TeamGüncellendi 2 dk okumaSürüm 2 · Geçmiş

Rutin, bir agent için tekrar tekrar görev oluşturur: bir takvime göre, sistemlerinizden biri bir webhook çağırdığında ya da siz Run now'a bastığınızda. Günlük raporlar, haftalık incelemeler, alarmlara tepkiler ya da kimsenin hatırlatmasına gerek kalmadan olması gereken her şey için kullanın.

Başlamadan önce

Manage routines iznine (routines:manage) ve en az bir agent'a ihtiyacınız var.

Rutin oluşturun

  1. Routines'i açın ve New routine'i seçin.
  2. Bir başlık, işi yapacak agent'ı ve isterseniz bir proje verin.
  3. İsteği yazın: agent'ın her çalıştırmada alacağı görev açıklaması.
  4. Create'i seçin. Rutin artık vardır ama bir tetikleyicisi olana ya da siz çalıştırana kadar hiçbir şey yapmaz.

Değişkenler

Bir değişken tanımlamak için isteğe {{name}} yazın, örneğin Summarize tickets from {{week}}. Her değişkenin bir etiketi, bir türü (metin, sayı, evet/hayır, bir seçim, bir tarih), bir varsayılan değeri ve bir Required anahtarı olabilir. Bir çalıştırma, varsayılanı olmayan her zorunlu değişkeni sağlamalıdır.

Tetikleyici ekleyin

Rutinin Triggers bölümünü açın ve Add trigger'ı seçin.

Tür Çalıştırmayı ne zaman başlatır Ayarlar
Schedule Cron ifadesi, seçilen saat diliminde vakti geldiğinde. Cron ifadesi, saat dilimi.
Webhook Sisteminiz tetikleyicinin URL'sine imzalı bir istek gönderdiğinde. İmzalama modu, yeniden oynatma penceresi.
API Biri çalıştırma uç noktasını bu tetikleyiciyle çağırdığında. Yok.

Europe/Istanbul saat dilimiyle 0 9 * * 1-5 gibi bir takvim, her hafta içi İstanbul saatiyle 09:00'da çalışır.

Webhook için konsol URL'yi ve bir kez de sırrı gösterir. Göndericiniz her isteği bununla imzalar. Webhook'ların kendi sayfası var: Rutin tetikleme webhook'u.

Çalıştırmalar çakıştığında

Önceki çalıştırma hâlâ sürerken yeni bir çalıştırmanın vakti gelirse ne olacağını seçin:

Ayar Etkisi
Coalesce if active Yeni çalıştırma, bir başkasını başlatmak yerine aktif olanla birleşir.
Skip if active Yeni çalıştırma atlanır ve atlandı olarak kaydedilir.
Always enqueue Her çalıştırma saklanır ve sırası gelince başlar.

Rutin duraklatılmışken kaçırılan çalıştırmalara ne olacağını da seçin:

Ayar Etkisi
Skip missed Kaçırılan çalıştırmalar bırakılır.
Enqueue missed (with a cap) Kaçırılan çalıştırmalar, devam ettirildiğinde bir sınıra kadar oluşturulur.

Elle çalıştırın

Run now'ı seçin, varsa değişkenleri doldurun ve onaylayın. Çalıştırma görevini hemen oluşturur.

Bir çalıştırma ne yapar

Her çalıştırma, rutinin agent'ına (ya da bu çalıştırma için seçtiğiniz agent'a) atanmış tek bir görev oluşturur ve o agent'ı uyandırır. Görev sıradan bir görevdir: izleyebilir, yanıt yazabilir ve maliyetini görebilirsiniz. Duraklatma, erişim ve bütçe sınırları yine geçerlidir; bu yüzden bir rutin asla bir bütçeyi aşacak kadar harcamaz.

Geçmiş ve revizyonlar

  • Runs, her çalıştırmayı kaynağıyla (takvim, webhook, API ya da elle), durumuyla ve oluşturduğu görevle listeler.
  • History, yapılandırma sürümlerini listeler: isteğe, agent'a ya da tetikleyicilere yapılan her değişiklik geri yükleyebileceğiniz bir revizyon oluşturur.

Duraklatın ya da arşivleyin

Tetikleyicileri korurken yeni çalıştırmaları durdurmak için rutinin durumunu Paused, emekliye ayırmak için Archived yapın. Duraklatılmış ya da arşivlenmiş bir rutine gelen webhook çağrıları 409 ile reddedilir.

API'den

Bir rutin oluşturun, bir takvim ekleyin ve bir çalıştırma başlatın:

curl
ROUTINE_ID=$(curl -s -X POST "https://intelligence-api.veyra.so/api/companies/$COMPANY_ID/routines" \
  -H "Authorization: Bearer $VEYRA_API_KEY" -H "Content-Type: application/json" \
  -d '{"title": "Weekly support summary", "description": "Summarize tickets from {{week}}.", "assigneeAgentId": "'"$AGENT_ID"'"}' | jq -r .id)

curl -X POST "https://intelligence-api.veyra.so/api/routines/$ROUTINE_ID/triggers" \
  -H "Authorization: Bearer $VEYRA_API_KEY" -H "Content-Type: application/json" \
  -d '{"kind": "schedule", "cronExpression": "0 9 * * 1", "timezone": "Europe/Istanbul"}'

curl -X POST "https://intelligence-api.veyra.so/api/routines/$ROUTINE_ID/run" \
  -H "Authorization: Bearer $VEYRA_API_KEY" -H "Content-Type: application/json" \
  -d '{"source": "api", "variables": {"week": "2026-W46"}, "idempotencyKey": "support-2026-w46"}'

Tekrarlanan bir idempotencyKey, yeni bir çalıştırma başlatmak yerine ilk çalıştırmayı döndürür; bu yüzden yeniden denemeler güvenlidir.

Create a routine, Create a routine trigger, Manually run a routine sayfalarına ve Rutinler bölümündeki tüm uç noktalara bakın.

RutinlerWebhook'larİş