Ana içeriğe geç
Version: Peki

Automations

Otomasyon, agent'ınızın bir müşteri yazmadan kendi başına yaptığı iştir. Bir değeri izleyip sizi uyarabilir, her sabah özet gönderebilir, bir Knowledge kaynağını güncel tutabilir ya da veriyi başka bir sisteme aktarabilir. Bir şeyin bir mesaja yanıt olarak değil, belli bir zamanda ya da bir sinyalle olması gerekiyorsa otomasyon kullanın.

Bu sayfa zamanlamayla çalışan otomasyonları anlatır. Aynı otomasyon bir webhook isteğiyle ya da bir Peki olayıyla da başlayabilir: Tetikleyiciler sayfasına bakın.

Bir otomasyon nasıl çalışır​

Her çalışma aynı adımlardan geçer. Tetikleyici dışındaki her adım isteğe bağlıdır ve çalışma erken durabilir.

Otomasyonları ucuz tutan kural: önce kodla kontrol edin, modeli yalnızca bir şey olduğunda kullanın. Kontrol, agent'ınızın Fonksiyonlarından birini modelsiz çalıştırır; maliyeti neredeyse sıfırdır ve dakikada bir çalışabilir. Model yalnızca görevde ve yalnızca kontrol sonucu değiştiğinde ya da bir koşul sağlandığında çalışır.

Nerede bulunur​

Bir agent açın ve kenar çubuğunda Automations'a tıklayın. Sayfa agent'ın otomasyonlarını şu sütunlarla listeler:

SütunNe gösterir
Ad ve tetikleyiciAd ve tek satırlık özet, örneğin "5 dakikada bir · get_crypto_price kontrolü · Koşul sağlandığında".
Son çalışmaEn son ne zaman çalıştığı ve sonucu: Gönderildi, Değişiklik yok, Koşul sağlanmadı, Başarısız gibi.
SonrakiZamanlamanın bir sonraki çalışması ("5 dk içinde", "Bugün 21:00", "Yarın 09:00"), otomasyonun saat diliminde. Duraklatılmışken "—".
Bugünkü maliyetBugünkü çalışmaların model maliyeti, otomasyonun saat dilimine göre. Günlük limite ulaşınca kırmızı olur.
DurumAçma/kapama düğmesi.

Açmak için bir satıra tıklayın. Açık bir otomasyonun üç sekmesi vardır: Kurulum, Çalışmalar ve Bir kez çalıştır. İzleyiciler listeyi, kurulumu ve çalışmaları görür. Editör ve üstü roller otomasyon oluşturabilir, değiştirebilir, çalıştırabilir ve silebilir.

Otomasyonlar işletim ayarlarıdır

Otomasyonlar agent'ın taslağına ve sürümlerine dahil değildir. Kanal ayarları gibi değişiklikler kaydedince hemen uygulanır. Otomasyonun kendisi için yayınlanacak bir şey yoktur.

Otomasyon oluşturun​

  1. Automations sayfasında listenin altındaki Yeni automation'a tıklayın.
  2. Bir Ad verin (en fazla 100 karakter), örneğin "BTC aşırı satım uyarısı".
  3. Ne zaman altında Zamanlama'yı bırakın ve aralığı ya da haftalık saatleri ayarlayın.
  4. İsterseniz bir Kontrol Fonksiyonu seçin ve Ne zaman devam etsin'i ayarlayın.
  5. İsterseniz bir Eylem seçin, bir Görev yazın, İzinli eylemler ve Bildir sohbetleri ekleyin.
  6. Limitler'i gözden geçirin.
  7. Kaydedince aç'ı şimdilik kapalı bırakın ve Automation oluştur'a tıklayın.
  8. Bir kez çalıştır sekmesini açın ve bir deneme çalışması yapın. Sonuç doğru görünüyorsa otomasyonu satırındaki düğmeyle açın.

Kaydedince aç'ı açmazsanız yeni otomasyon duraklatılmış başlar. Açmak için agent'ın yayında olması gerekir: açık bir otomasyon her zaman agent'ın yayındaki sürümünü çalıştırır.

Copilot kursun

Ne istediğinizi Copilot'a anlatın ("5 dakikada bir BTC'nin RSI'ını kontrol et, 30'un altına düşünce bana Telegram'dan yaz"). Fonksiyonu, otomasyonu ve bir deneme çalışmasını hazırlar; oluşturmadan önce onayınızı ister. Copilot ile çalışmak sayfasına bakın.

Zamanlama​

Ne zaman → Zamanlama altında iki türden birini seçersiniz.

Her​

Sabit aralıklarla çalışır. Bir sayı yazın ve dakika, saat ya da gün seçin.

LimitDeğer
En kısa aralık1 dakika
En uzun aralık7 gün (10.080 dakika)
Görev her seferinde çalışıyorsa en kısa aralık15 dakika

Aralıklı zamanlama kurduğunuz andan itibaren sayılır: ilk çalışma kaydettikten bir aralık sonradır, hemen değil. Diğer alanları düzenlemek bunu kaydırmaz.

Haftalık​

Seçtiğiniz günlerde belirli saatlerde çalışır.

  • Günler: gün düğmelerine tıklayın (Pzt–Paz). En az birini seçin.
  • Saatler: saati SS:DD olarak yazın (00:00–23:59) ve Saat ekle'ye tıklayın ya da Enter'a basın. En fazla 24 saat ekleyebilirsiniz.

Haftalık saatler otomasyonun saat dilimindeki duvar saatidir. Yaz saati geçişinde o gün var olmayan bir saat (örneğin ileri alınan gecede 02:30) cron'daki gibi bir sonraki geçerli saatte çalışır.

Görev her seferinde çalışıyorsa (Ne zaman devam etsin → Her zaman) haftalık saatler arasında en az 15 dakika olmalı; seçili iki gün arasında gece yarısını geçerken de.

Saat dilimi​

Saat dilimi zamanlamanın, sessiz saatlerin ve günlük limitlerin nasıl okunacağını belirler. Yeni bir otomasyon çalışma alanının saat dilimini kullanır. Europe/Istanbul gibi bir IANA bölgesi ya da UTC seçebilirsiniz.

Zamanlama çevresinde neler olur​

  • Aynı anda tek çalışma. Bir sonraki çalışma zamanı geldiğinde önceki hâlâ sürüyorsa yenisi atlanır ve Atlandı — önceki çalışma sürüyor olarak kaydedilir.
  • Kaçırılan çalışmalar tekrar edilmez. Hizmet kısa bir süre kullanılamadıysa bir sonraki çalışma, bir sonraki planlı zamanda olur.
  • Duraklatılmış, hiçbir şey çalışmaz demektir. Duraklatılmış bir otomasyon planlı çalışma kaydetmez.

Kontrol​

Kontrol agent'ınızın Fonksiyonlarından birini modelsiz çalıştırır. Çalışmanın geri kalanı bu Fonksiyonun JSON sonucuyla ilerler.

  • Listeden Fonksiyonu seçin ya da Kontrol yok deyin.
  • Girdi: Fonksiyona girdi olarak verilen JSON nesnesi, örneğin {"sembol": "BTCUSDT"}. Bir JSON nesnesi olmalı.

Kontrol Fonksiyonu için kurallar:

  • Açık bir otomasyonda agent'ın yayındaki sürümünde bulunmalı ve açık olmalı.
  • Onay gerekir açık olamaz: kontrol her tetiklenmede gözetimsiz çalışır.
  • Deneme çalışmasında yalnızca GET ve HEAD istekleri yapabilir.
  • Sonuç, çalışma kaydı ve bir sonraki karşılaştırma için 16 KB'a kadar saklanır. Daha uzun sonuç kesilir ve "Kısaltıldı: sonuç tamamı saklanamayacak kadar uzundu." olarak işaretlenir.

Kontrol başarısız olursa (hata, zaman aşımı) çalışma Fonksiyonun hatasıyla başarısız olarak kaydedilir.

Fonksiyon yazmak için Fonksiyonlar sayfasına bakın.

Çalışmalar arası hafıza​

Otomasyon çalışmalarında Fonksiyonlar ctx.store'u kullanabilir; otomasyon başına tutulan küçük bir anahtar-değer hafızası:

export default async (input, ctx) => {
const son = await ctx.store.get('sonUyariFiyati');
// ...
await ctx.store.set('sonUyariFiyati', fiyat);
return { fiyat, son };
};
LimitDeğer
Otomasyon başına anahtar50
Toplam boyut (anahtarlar + JSON değerler)8 KB
Anahtar adları1–64 harf, rakam, _, . ya da -

ctx.store yalnızca otomasyon çalışmalarında vardır: kontrolde, eylemde ve görevin çağırdığı Fonksiyonlarda. Bir uyarının yalnızca yeni olanı bildirmesi için kullanın. Çalışmanın gizli anahtarlarından birini içeren bir değer reddedilir. Deneme çalışmasında yazılanlar yalnızca o çalışmanın gördüğü geçici bir kopyaya gider; otomasyonun gerçek hafızası hiç değişmez.

Ne zaman devam etsin​

Ne zaman devam etsin, çalışmanın kontrolden sonra sürüp sürmeyeceğine karar verir. Kontrol yoksa yalnızca Her zaman seçilebilir.

SeçenekNe yapar
Her zamanGörevi her seferinde çalıştırır.
Sonuç değiştiğindeYalnızca kontrol sonucu son gerçek çalışmanın sonucundan farklıysa devam eder. JSON'daki anahtar sırası önemli değildir.
Bir koşul sağlandığındaYalnızca kontrol sonucundaki tüm kuralların sağlandığı durumda devam eder.

"Son sonuç", yayındaki sürümün son gerçek çalışmasının sonucudur. Deneme ve taslak çalışmaları onu hiç değiştirmez; yani test etmek, zamanlamanın neyle karşılaştıracağını etkilemez.

Kurallar​

Her kuralın bir Alan, bir Operatör ve bir Değer'i vardır. En fazla 10 kural ekleyebilirsiniz. Tüm kurallar sağlanmalı.

  • Alan, kontrol sonucunda noktalı bir yoldur: rsi, veri.rsi, kalemler.0.fiyat.
  • Eksik ya da null bir alan kuralı başarısız kılar ("not found in the check result").
OperatörAnlamıDeğer
< <= > >=Sayısal karşılaştırma. Metin hâlindeki sayılar ("29.5") sayı sayılır.Bir sayı
eşittir / eşit değilEşit ya da değil. Sayılar sayı olarak, geri kalan her şey metin olarak karşılaştırılır.Sayı, true, false ya da metin
içerirMetin değeri içerir ya da listede ona eşit bir öğe vardır.Metin
değişim % > / değişim % <Son gerçek çalışmadan bu yana yüzde değişim: (şimdi − önceki) ÷ |önceki| × 100. %2'lik bir düşüş değişim % < -2 olur.Bir sayı

Henüz önceki bir değer yoksa (ilk çalışma) ya da önceki değer 0 ise değişim % kuralı başarısız olur.

Bir çalışma bir kuralda durduğunda Çalışmalar sekmesi Sağlanmayan kural'ı gösterir, örneğin rsi < 30 (was 41.2).

Eylem​

Eylem, agent'ınızın Fonksiyonlarından birini koşuldan sonra yazma izniyle ve modelsiz çalıştırır. Veriyi başka bir sisteme göndermek için kullanın; örneğin bir potansiyel müşteriyi CRM'inize aktarmak.

  • Fonksiyonu seçin ve Girdi'sini bir JSON nesnesi olarak verin.
  • Yazma işlemleri kaydettiğinizde onaylanır: "Yazma işlemleri her seferinde sormadan çalışır."
  • Fonksiyonda Onay gerekir açıksa eylem çalışmaz: bunun yerine aynı girdiyle bir onay isteği oluşur ve çalışma Eylem onay bekliyor gösterir. Onaylar sayfasına bakın.
  • Görev yoksa eylemin sonucu bildirimin kendisi olabilir: { "message": "..." } döndürün, o metin Telegram sohbetlerine gider.
  • Deneme çalışmasında eylemin yazma istekleri sistem tarafından yanıtlanır ve hiç gönderilmez. Çalışma bunları "POST host yapardı" gibi gösterir.

Eylem en çok webhook'lar ve olaylarla işe yarar: Tetikleyiciler sayfasına bakın.

Görev​

Görev (isteğe bağlı), agent'ın bu çalışmada yapacağı iştir; kendi cümlelerinizle, en fazla 4.000 karakter:

2 cümlelik olgusal bir uyarı yaz: güncel RSI, fiyat ve 24 saatlik değişim. Al/sat tavsiyesi yok.

Agent kendi talimatları, Knowledge'ı ve modeliyle, yalnızca aşağıdaki İzinli eylemler ile çalışır. Girdisi sizin göreviniz, kontrol sonucu, Sonuç değiştiğinde kullanıyorsanız önceki sonuç ve yalnızca olguları söylemesini, asla al/sat tavsiyesi vermemesini isteyen sabit bir kuraldır.

Bilmeniz gerekenler:

  • Her otomasyonun, kendi saat diliminde günde bir gizli konuşması olur. Bu konuşma Inbox'ta görünmez ve Analiz'de sayılmaz.
  • Görev bir kişiye devredemez (insana devretme yok).
  • Bir guardrail yanıtı engellerse ya da model başarısız olursa çalışma bu nedenle başarısız olur.
  • Görev yoksa hiç model çalışmaz.

İzinli eylemler​

İzinli eylemler, görevin çağırabileceği araçlardır. Ekle'ye tıklayın ve şunlardan seçin:

  • yerleşik araçlar,
  • agent'ın HTTP araçları,
  • agent'ın Fonksiyonları,
  • save_leads, find_leads gibi kayıt araçları (Records sayfasına bakın).

yazar işaretli öğeler dışarıda bir şeyi değiştirir: GET dışındaki her HTTP aracı, her Fonksiyon ve her save_ kayıt aracı. Yazan eylemler kaydettiğinizde bir kez, editör ya da üstü bir rolü olan biri tarafından onaylanır; sonra her seferinde sormadan çalışır.

Knowledge'a ekle, görevin notlarını Knowledge kaynağı olarak kaydedebilmesini sağlar (başlıklı bir metin kaynağı ekleyen bir araç). Bu da yazan bir eylem sayılır.

Yazmaya başlayan bir araç otomasyonu duraklatır

Salt okuyan bir araç yeni yayınlanan bir sürümde yazan bir araca dönüşürse (örneğin bir GET aracı POST olursa) ya da kontrol başka bir Fonksiyona geçerse, otomasyon kendini "Tools … now write; re-approve the automation (save it again with the publish role) before it runs" mesajıyla duraklatır. Otomasyonu açın, kurulumu kontrol edin ve yeniden kaydedin.

Bildir​

Bildir, sonucu agent'ınızın kendi botuyla Telegram'a gönderir. Mesaj görevin yanıtıdır; görev yoksa eylemin message'ı.

  1. Önce Channels altında agent'a Telegram bağlayın. Bot yoksa "Mesaj göndermek için önce Telegram'ı bağlayın." görürsünüz.
  2. Sohbet ekle'ye tıklayın ve botla konuşmuş sohbetlerden seçin. En fazla 20 sohbet ekleyebilirsiniz.
  3. Yeni birini eklemek için /start bağlantısını kopyala'ya tıklayın ve ona gönderin. Bağlantıyı açıp Başlat'a bastığında sohbeti listede görünür.

Her mesajı gönderilmeden önce onayla, her mesajın Inbox'taki Onaylar sekmesinde beklemesini sağlar. Onaylamak mesajı gösterildiği gibi gönderir; o anda sessiz saatler uygulanmaz.

Göndermenin, Telegram'ın hız limiti beklemeleri dahil, çalışma başına 30 saniyelik bir süresi vardır. Bu sürede ulaşılamayan sohbetler başarısız işaretlenir. Hiç mesaj gönderilemezse çalışma başarısız olur.

Botu kurmak için Telegram sayfasına bakın.

Limitler​

AyarNe yaparVarsayılan
Günlük çalışmaGünlük en fazla planlı çalışma (1–10.000). Aşılınca otomasyon kendini duraklatır.1.500
Günlük model maliyetiGörevlerin günlük en fazla model maliyeti, dolar cinsinden (0–1.000). Ulaşılınca otomasyon duraklar.$1
Sessiz saatlerMesaj gitmeyen bir zaman aralığı, örneğin 23:00–07:00. Çalışmalar yine kaydedilir.Kapalı

Günler otomasyonun saat dilimine göre sayılır.

Sessiz saatler mesajları bekletir: sonra da gönderilmezler; çalışma Bekletildi — sessiz saatler olarak kaydedilir. Görevin tek etkisi mesajsa (izinli eylem yok, Knowledge'a ekle kapalı), görev sessiz saatlerde hiç çalışmaz; böylece düşecek bir mesaj için ödeme yapmazsınız. Aralık gece yarısını geçebilir. "Geceleri mesaj gelmesin" için sessiz saatleri kullanın; Fonksiyona ya da koşullara saat kuralı koymayın.

Krediler

Otomasyon görevleri, her model çağrısı gibi çalışma alanının kredisini kullanır. Her planlı, webhook ya da olay çalışmasından önce Peki çalışma alanında kredi kalıp kalmadığına bakar. Kalmadıysa otomasyon kendini "Paused: the workspace is out of credits. Add credits in Settings → Plan & credits, then resume." mesajıyla duraklatır. Kredi ekleyin, sonra Devam ettir'e tıklayın. Planlar ve krediler sayfasına bakın.

Duraklatma ve otomatik duraklatma​

Otomasyonu satırındaki düğmeyle kapatın ya da açın. Açarken kurulum yeniden kontrol edilir: duraklatılmışken agent, Fonksiyonları ya da Telegram botu değişmiş olabilir.

Otomasyon şu durumlarda kendini duraklatır:

  • Günlük çalışma ya da Günlük model maliyeti limitine ulaştığında,
  • çalışma alanının kredisi bittiğinde,
  • art arda 5 planlı çalışma başarısız olduğunda ("Paused after 5 failed runs in a row. Last error: …"),
  • bir yazma eylemi onaylanmadığında (yukarıdaki uyarıya bakın).

Satırının altındaki şeritte Otomatik duraklatıldı: ve nedeni görünür; yanında Limiti artır (kurulumu açar) ve Devam ettir vardır. Devam ettirmek başarısızlık sayacını sıfırlar. Kendini duraklatmış bir otomasyonu düzenlemek onu siz devam ettirene kadar duraklatılmış bırakır.

Bir kez çalıştır​

Bir kez çalıştır sekmesi otomasyonu hemen çalıştırır, böylece ne yapacağını görürsünüz.

SeçenekNe yapar
Deneme çalışmasıVarsayılan olarak açık. "Hiçbir şey gönderilmez ya da yazılmaz." Kontroller ve okumalar gerçekten çalışır; yazma işlemleri, mesajlar ve Knowledge eklemeleri yalnızca gösterilir.
SürümYayında ya da Taslak. "Taslak yalnızca deneme olarak çalışabilir."

Çalıştır'a tıklayın. Sonuç düğmenin altında aşamaları ve ayrıntılarıyla görünür. Sayfa 2 dakikaya kadar bekler; daha uzun süren bir çalışma "2 dakikadır çalışıyor; bitince Çalışmalar'da görünecek." gösterir.

  • Bir kez çalıştır, Günlük çalışma'ya ve 5 başarısızlık duraklatmasına sayılmaz.
  • Otomasyon başına aynı anda yalnızca bir elle başlatılmış çalışma olabilir; bitene kadar yenisi reddedilir.
  • Yayındaki sürümün gerçek çalışması (deneme kapalı) mesaj gönderir ve yazar. Gerçek çalışmalar her zaman yayındaki agent'ı kullanır.
  • Bir kez çalıştır duraklatılmış bir otomasyonda da çalışır.

Çalışmalar​

Çalışmalar sekmesi son 50 çalışmayı, en yeni en üstte gösterir. Çalışma kayıtları 30 gün saklanır. Tümü, Görev çalıştı ya da Başarısız ile filtreleyin.

Her satırda Zaman, çalışmanın geçtiği Aşamalar, Süre ve Maliyet görünür. Deneme çalışmalarında Deneme etiketi vardır. Ne yaptığını görmek için satıra tıklayın: kontrol sonucu, sağlanan ya da sağlanmayan kural, eylem ve istekleri, araç çağrıları, agent'ın yanıtı ve her mesajın durumu (İletildi, Bekletildi — sessiz saatler, Başarısız, Gönderilmedi, Onay bekliyor).

AşamaAnlamı
Çalışıyor…Çalışma sürüyor.
Kontrol edildiKontrol çalıştı; yapılacak başka bir şey yoktu.
Değişiklik yokDurdu: kontrol sonucu öncekiyle aynıydı.
Koşul sağlanmadıDurdu: bir kural sağlanmadı.
Eylem çalıştıEylem Fonksiyonu çalıştı (görev yok).
Eylem onay bekliyorEylem bir onay isteğine dönüştü.
Görev çalıştıGörev çalıştı (bildirilecek sohbet yoktu ya da bir şey gönderilmedi).
N sohbete gönderildi / N sohbete gönderilecektiMesajlar gönderildi ya da deneme çalışmasında gönderilecekti.
Bekletildi — sessiz saatlerSessiz saatler mesajları bekletti.
Onay bekliyorMesaj Onaylar'da bekliyor.
Atlandı — önceki çalışma sürüyorBaşka bir çalışma sürdüğü için başlamadı.
Başarısız: …Bir şey ters gitti; nedeni yanında yazar.

10 dakika içinde hiçbir işleyicinin bitirmediği bir çalışma başarısız gösterilir ("Not picked up").

Kaydederken sık görülen hatalar​

Kaydettiğinizde kurulum agent'a göre kontrol edilir. Mesaj neyi düzeltmeniz gerektiğini söyler:

Mesaj (kısaltılmış)Ne yapmalısınız
Publish the agent first: an enabled automation runs the published versionAgent'ı yayınlayın ya da otomasyonu kapalı kaydedin.
Function … is only in the draft; publish the agent firstKontrol, eylem ya da bir araç yalnızca taslakta var. Yayınlayın ya da otomasyon kapalıyken taslağı deneme olarak çalıştırın.
Choose a Function to check firstSonuç değiştiğinde ve Bir koşul sağlandığında bir kontrol gerektirir.
Add at least one ruleBir koşul sağlandığında en az bir kural gerektirir.
A task that runs every time needs at least 15 minutes between runsAralığı uzatın ya da bir koşul kullanın.
Automations can't ask for a person (request_human)O aracı İzinli eylemler'den çıkarın.
Connect Telegram first (or turn the Telegram channel on)Telegram kanalını bağlayın ya da açın.
Chat … is not a Telegram chat of this agentO kişinin önce bota mesaj atması gerekir.
The automation changed while you were savingBu arada kendini duraklatmış olabilir. Sayfayı yenileyin ve tekrar deneyin.

Örnek: günlük satış özeti​

Bir e-ticaret mağazası her hafta içi sabah dünkü siparişlerin kısa bir özetini istiyor.

AyarDeğer
Ne zamanZamanlama → Haftalık, Pzt–Cum, 08:30, Europe/Istanbul
Kontroldunku_siparisler (mağaza API'nizi çağıran bir Fonksiyon), girdi {}
Ne zaman devam etsinHer zaman
Görev"Dünkü siparişleri 3 kısa satırda özetle: sipariş sayısı, ciro (₺), en çok satan ürün. Yalnızca olgular."
BildirMağaza sahibi Ayşe Hanım'ın Telegram sohbeti

Burada her seferinde çalışan bir görevle haftalık saatler sorun değildir: çalışmalar arasında bir gün vardır.

Örnek: fiyat uyarısı​

Bitcoin'in 1 saatlik RSI'ı 30'un altına düşünce, her düşüşte en fazla bir kez uyar.

AyarDeğer
Ne zamanZamanlama → Her 5 dakika
Kontrolget_crypto_price, girdi {"symbol": "BTCUSDT"}, sonuç { "price": 61250, "rsi14_1h": 28.4 }
Ne zaman devam etsinBir koşul sağlandığında: rsi14_1h < 30
Görev"Fiyat ve RSI ile iki cümlelik olgusal bir not yaz. Tavsiye yok."
BildirSizin Telegram sohbetiniz
LimitlerSessiz saatler 23:00–07:00

Her düşüşü yalnızca bir kez bildirmek için Fonksiyonun bunu ctx.store'da hatırlamasını ve "yeniDusus": true gibi bir işaret döndürmesini sağlayın; sonra yeniDusus eşittir true kuralını ekleyin.

Yalnızca olgular

Uyarılar olguları söyler: değerler, değişimler, aşılan bir eşik. Görev kuralı ve Copilot al/sat sinyallerini ve yatırım tavsiyesini reddeder.

İlgili sayfalar​