Workflow Çalıştırma
Bir workflow kurmak işin yalnızca yarısıdır — diğer yarısı onu çalıştırmak ve ne olduğunu izlemektir.
Bir çalışma (run), workflow'un tetikleyici block'undan son adımına kadar tek bir yürütmesidir. Siz hâlâ kurarken editörden kendiniz bir çalışma başlatabilirsiniz; ayrıca workflow'un bir zamanlama, bir webhook, bir sohbet konuşması veya dış bir istek üzerine kendi kendine başlamasını sağlayabilirsiniz.
Bu sayfa her ikisini de anlatır: workflow'u elle nasıl çalıştıracağınız ve kendi kendine başlama yollarını nasıl kuracağınız.
Kendiniz Çalıştırma
Bir workflow'u test etmenin en hızlı yolu onu editörden çalıştırmaktır.
- Workflow'u açın.
- Yan panel başlığındaki Run'a tıklayın — veya Ctrl/Cmd + Enter tuşlarına basın.
Run started — see it in the Logs tab. mesajını görürsünüz. Çalışma arka planda sürer; düzenlemeye devam edebilir, sekme değiştirebilir veya sayfadan tamamen ayrılabilirsiniz.
Run soluk göründüğünde
Run yalnızca birkaç koşul sağlandığında çalışır. Düğme soluksa üzerine gelin — ipucu hangi koşulun eksik olduğunu tam olarak söyler.
| İpucu | Ne yapmalısınız |
|---|---|
| Save your changes first | Kanvasta kaydedilmemiş değişiklikler var. Save'e tıklayın (veya Ctrl/Cmd + S), sonra çalıştırın. |
| Add at least one block first | Kanvas boş. Bir block ekleyin — bkz. Workflow Oluşturma. |
| Copilot is building — please wait | Copilot şu anda bu workflow'u düzenliyor. Bitirmesini bekleyin. |
Bir çalışma her zaman workflow'un kaydedilmiş sürümünü kullanır, ekranda o an görüneni değil. Run düğmesinin kaydedilmemiş değişikliklerde kapanmasının nedeni budur — böylece çalışan şey her zaman gördüğünüz şeydir.
Bir çalışma sürerken Run düğmesi Stop'a dönüşür (iptal ederken Stopping… gösterir).
Girdi Sağlama
Çoğu workflow'un bir başlangıç verisine ihtiyacı vardır — bir müşteri adı, bir rapor tarihi, işlenecek bir mesaj. Bu veri tetikleyici block'tan gelir ve sonraki tüm block'lar onu okuyabilir.
Start block'unda girdi tanımlama
Start block'u bir Input bölümü taşır. Bu bölüm, block'un yapılandırma görünümündeki Show additional fields altındadır (block'a çift tıklayın veya üzerine gelince çıkan tepsideki Open details'i kullanın).
İhtiyacınız olan her veri parçası için bir alan ekleyin:
| Alan | Ne işe yarar |
|---|---|
| Name | Sonraki block'ların bu değeri okumak için kullandığı ad (yer tutucu field_name). |
| Type | Değerin nasıl okunacağı: string, number, boolean, object veya array. |
| Value | Editörde Run'a tıkladığınızda kullanılan test değeri (yer tutucu Test value). |
Yeni alan eklemek için + düğmesini, bir alanı kaldırmak için çöp kutusu simgesini, işiniz biten bir alanı katlamak için ok simgesini kullanın.
Ayrı bir "çalıştırma" penceresi yoktur. Input bölümünün kendisi formdur — Run'a tıkladığınızda Value kutularına yazdığınız şey gönderilir. Name girilmemiş alanlar yok sayılır.
Girdileri sonraki block'larda okuma
Workflow'un herhangi bir yerinde bir tetikleyici girdisine adıyla başvurun:
<input.NAME>
Yani customerEmail adlı bir alan <input.customerEmail> olarak okunur. Aynı sözdizimi, çalışmanın nasıl başladığından bağımsız olarak geçerlidir — elle Run, bir webhook teslimi, bir zamanlama veya bir sohbet isteği hepsi aynı <input.*> yuvasını doldurur.
Değerler seçtiğiniz Type'a göre gelir: number seçerseniz 42 bir sayı olarak gelir; object veya array seçerseniz JSON metni yapılandırılmış veri olarak okunur.
Girdiler, bir block'un başvurabileceği üç şeyden yalnızca biridir. Ayrıca daha önceki bir block'un sonucunu <blockName.field> ile (örneğin <agent.content>) ve saklanmış bir workflow değişkenini <variable.NAME> ile okuyabilirsiniz — bkz. Değişkenler.
Bir Çalışmayı İzleme
Bir çalışma başlar başlamaz panel başlığının altında ince bir durum şeridi belirir ve çalışma bitene kadar kendini güncel tutar.
Şerit şunları gösterir:
- Renkli bir rozet olarak güncel durum.
- {n} steps recorded — şimdiye kadar kaç adımın tamamlandığı.
- Çalışma bittiğinde süre.
- Çalışma başarısız olduysa hata mesajı.
Çalışma durumları
| Durum | Anlamı |
|---|---|
| Queued | Kabul edildi, başlamayı bekliyor. |
| Running | Adımlar şu anda yürütülüyor. |
| Completed | Başarıyla tamamlandı. |
| Failed | Bir adım başarısız oldu — mesaj neyin ters gittiğini söyler. |
| Cancelled | Siz durdurdunuz. |
| Paused | Devam edebilmek için bir şey bekliyor. |
Çalışma denetimleri
| Denetim | Ne zaman görünür | Ne yapar |
|---|---|---|
| Resume | Yalnızca çalışma Paused iken | Çalışmayı kaldığı yerden sürdürür (Resuming… gösterir). |
| Stop | Queued, Running veya Paused iken | Çalışmayı iptal eder (Stopping… gösterir). |
| × (kapat) | Her zaman | Şeridi gizler. Çalışmayı durdurmaz. |
× yalnızca durum şeridini ekranınızdan gizler — çalışma arka planda sürmeye devam eder. Gerçekten iptal etmek istiyorsanız Stop'u kullanın.
Bir çalışma bağlantı için duraklarsa
Bir adımın ihtiyaç duyduğu bağlantı eksik, reddedilmiş veya süresi dolmuşsa, çalışma doğrudan başarısız olmak yerine duraklar ve durum şeridinin altında kehribar renkli bir bildirim belirir:
Credential required — {sağlayıcı}
Bundan sonra ne yapabileceğiniz bağlantı türüne bağlıdır:
| Durum | Bildirimin sunduğu |
|---|---|
| Yerinde düzeltilebilen bir API anahtarı bağlantısı | Update key düğmesi. Yeni anahtarı girin, sonra Resume'a tıklayın — çalışma kaldığı yerden devam eder. |
| Bağlantı block ile eşleştirilemiyor | Adı verilen block'ta bir bağlantı yeniden seçmeniz istenir (block adı, onu açan bir bağlantıdır); ardından yeniden çalıştırın. |
| Bir bağlı hesap (oturum açma tabanlı) | Buradan yeniden bağlanmanın henüz kullanılabilir olmadığı belirtilir — hesabı Connections altından yeniden bağlayın ve yeniden çalıştırın. |
Bağlantıların nasıl eklendiğini, test edildiğini ve onarıldığını görmek için bkz. Bağlantılar.
Tüm resmi görmek
Durum şeridi bir bakıştır, bir rapor değil. Herhangi bir çalışmanın adım adım detayı için — her block'un ne aldığı, ne döndürdüğü ve tam olarak hangi adımın başarısız olduğu — Logs sekmesini açın. Bkz. Loglar.
Aktif ve Duraklatılmış Workflow'lar
Editörden elle yapılan bir Run, workflow hangi durumda olursa olsun her zaman çalışır. Otomatik tetikleyiciler farklıdır: yalnızca workflow'un kendisi Active olduğunda ateşlenir.
Workflows sayfasında bir workflow kartının üzerine gelin ve anahtarı kullanın:
- Activate — o workflow'daki tüm otomatik tetikleyicileri devreye alır.
- Deactivate — onları devreden çıkarır. Zamanlamalar ateşlenmeyi bırakır, webhook teslimleri düşürülür ve workflow artık sohbetten başlatılamaz.
Bir workflow kurmuş olmak, onun kendi kendine çalışması için yeterli değildir. Siz etkinleştirene kadar bir zamanlama onu atlar ve bir webhook teslimi atılır — üstelik sessizce, çünkü gönderene hiçbir şey bildirilmez.
Bir Workflow'un Başlama Yolları
İstediğiniz tetikleyiciyi akışınızın ilk block'u olarak ekleyin. Bir workflow'un birden fazla giriş noktası olabilir.
| Tetikleyici | Nasıl başlar | Workflow'a ne verir |
|---|---|---|
| Start (manuel) | Editörde Run'a tıklarsınız | Input alanlarına yazdığınız test değerleri |
| Schedule | Belirli aralıklarla otomatik olarak — bkz. Zamanlamalar | Ek bir şey yok; workflow gözetimsiz çalışır |
| Webhook | Dış bir servis, block'un adresine istek gönderir | İsteğin gövdesi, başlıkları, yolu, geliş zamanı ve arayanın adresi |
| Chat Trigger | Siz onayladıktan sonra, bir AI asistanıyla sohbetten | Gönderdiğiniz mesaj ve etkinse yakın konuşma geçmişi |
| API Trigger | Dış bir istek workflow'u çağırır | İsteğin gövdesi, başlıkları ve sorgu değerleri |
| Telegram Trigger | Telegram botunuz bir mesaj alır | Mesaj, göndereni ve güncelleme detayları |
| Slack Trigger | Slack uygulamanız abone olduğunuz bir olayı alır | Mesaj, göndereni, kanalı ve olay detayları |
| WhatsApp Trigger | WhatsApp Business numaranız bir mesaj alır | Mesaj, göndereni ve mesajın geldiği numara |
| Gmail Trigger | Bağlı bir Gmail gelen kutusuna yeni e-posta gelir (periyodik olarak kontrol edilir) | Mesaj ve göndereni |
| Outlook Trigger | Bağlı bir Outlook / Microsoft 365 gelen kutusuna yeni e-posta gelir (periyodik olarak kontrol edilir) | Mesaj ve göndereni |
Her tetikleyici block'un neler sunduğu için bkz. Block'lar.
Webhook Tetikleyicileri
Bir Webhook block'u, dış bir servisin workflow'unuzu başlatmasını sağlar — bir form gönderimi, bir ödeme olayı, başka bir araçtan gelen bir uyarı.
İhtiyacınız olan her şeyi tek bir panelde bulmak için Webhook block'unun yapılandırmasını açın.
Adres
Webhook'un adresi, block'un panelini ilk açtığınızda otomatik olarak oluşturulur — hatırlamanız gereken bir "üret" düğmesi yoktur. Yanında bir kopyala düğmesi bulunan bir kutuda görünür. Gönderen servise yapıştırın.
İmzalama sırrı (signing secret)
Adresin yanında, bir isteğin gerçekten beklediğiniz servisten geldiğini kanıtlayan imzalama sırrı yer alır.
İmzalama sırrı yalnızca bir kez gösterilir — oluşturulduktan veya döndürüldükten hemen sonra:
Copy this secret now — it will not be shown again. Rotating invalidates the old secret immediately.
Ondan sonra panel yalnızca noktalar ve "The signing secret is shown only when created or rotated." notunu gösterir. Kaybederseniz yenisini almak için döndürün.
Rotate, sırrı değiştirir. Bilinçli olarak iki adımlıdır: Rotate'e tıklayın, sonra birkaç saniye içinde Confirm?'e tıklayın (bir × iptal eder ve uzaklaşırsanız onay kendiliğinden devreden çıkar). Onayladığınız anda eski sır çalışmayı bırakır — gönderen servisi hemen güncelleyin.
Bir teslimin kabul edilmesi için gerekenler
Gelen her istek, gönderen tarafından panelin altında yazan tarife göre imzalanmalıdır: bir zaman damgası başlığı ve imzalama sırrınızdan üretilen bir imza başlığı. İmzalanmamış veya 5 dakikadan eski istekler düşürülür.
Webhook verisi kuruluşunuzun dışından gelir. Her <input.*> değerine güvenilmez veri gibi davranın — özellikle bir AI istemine beslerken.
Bir webhook'u duraklatma
Panel, webhook'un kendi durumunu gösterir — Active (yeşil nokta) veya Paused (gri nokta) — yanında bir Pause / Resume düğmesiyle.
Duraklatılmış bir webhook aldığı her şeyi sessizce düşürür. Sürdürmek teslimleri yeniden kabul etmeye başlar ve reddedilen teslim sayacını sıfırlar.
Reddedilen teslimler
Bir teslim reddedildiğinde gönderene hiçbir şey bildirilmez; bu yüzden bunu öğrendiğiniz yer bu paneldir. İstekler reddediliyorsa kehribar renkli bir uyarı belirir:
{n} rejected deliveries since the last accepted one (last: …). Check the sender's signature, timestamp and IP.
Bu genellikle gönderenin yanlış sırla imzaladığı, saatinin kaydığı ya da izin verilmeyen bir adresten çağırdığı anlamına gelir.
Son teslimler
Recent deliveries altında, webhook ile başlamış son çalışmaları durumları ve saatleriyle görürsünüz — bir teslimin gerçekten ulaştığının ve bir şey yaptığının en hızlı kanıtı. "No webhook-triggered runs yet." şimdiye kadar adrese hiçbir şeyin ulaşmadığı anlamına gelir.
Slack Trigger
Bir Slack Trigger block'u, Slack uygulamanız abone olduğunuz bir olayı aldığında workflow'unuzu başlatır — yeni bir mesaj, bir bahsetme (mention), bir tepki ve daha fazlası.
Kurulum
api.slack.com/appsadresinde bir Slack uygulaması oluşturun ve Signing Secret'ını kopyalayın (Basic Information → App Credentials).- Block'ta, bu Signing Secret'ı tutan bir bağlantı seçin (veya ekleyin). Block ardından otomatik olarak bir Request URL gösterir — bir "üret" düğmesi yoktur.
- Slack uygulamanızda Event Subscriptions'ı açın, etkinleştirin ve Request URL'i yapıştırın. Slack bunu anında doğrular.
- Subscribe to bot events altında istediğiniz olayları ekleyin (örneğin
message.channels,app_mention,reaction_added), ardından Save Changes'e tıklayıp uygulamayı yeniden yükleyin.
Request URL oluştuğunda block Trigger ready yazısını gösterir — Slack'in kontrol edilecek sürekli bir "bağlı" durumu yoktur, bu yüzden onay bu kadarıyla sınırlıdır; bu noktadan sonra eşleşen olaylar workflow'u başlatır.
:::note Bir uygulama, bir workflow Her Slack uygulaması tek bir workflow'a bağlanır. Signing Secret değişirse, block Request URL'i yeniden oluşturmak için bir Reconnect düğmesi gösterir. :::
Slack olayları kuruluşunuzun dışından gelir. <input.message.text> değerini güvenilmez veri gibi ele alın — özellikle AI istemlerinde.
WhatsApp Trigger
Bir WhatsApp Trigger block'u, bağlı WhatsApp Business numaranıza bir mesaj geldiğinde workflow'unuzu başlatır.
Kurulum
- Block'ta, Meta uygulamanızın App ID'sini girin ve App Secret'ını tutan bir bağlantı seçin.
- Workflow'u etkinleştirin. Slack'ten farklı olarak, hiçbir yere URL yapıştırmazsınız — her iki değer ayarlandığında ve workflow etkin olduğunda block kendini Meta'ya otomatik olarak kaydeder.
- Block bir durum gösterir: Meta abonelik kaydını onayladığında Connected, veya onaylayamadıysa bir hata bildirimi.
App ID veya App Secret değişirse, aboneliği yeniden kaydetmek için block'tan yeniden bağlanın.
WhatsApp mesajları kuruluşunuzun dışından gelir. Tetikleyici verisini güvenilmez veri gibi ele alın — özellikle AI istemlerinde.
E-posta Tetikleyicileri (Gmail ve Outlook)
Bir Gmail Trigger veya Outlook Trigger block'u, bağlı bir gelen kutusuna yeni e-posta geldiğinde workflow'unuzu başlatır.
- Bağlantılar altında Google veya Microsoft hesabınızı bağlayın — bu, diğer Google/Microsoft block'larının kullandığı aynı oturum açma yöntemidir.
- Bu bağlantıyı tetikleyici block'ta seçin.
- İsteğe bağlı olarak, tam mesaj metnini almak için (varsayılan olarak kapalı) Include email body'yi açın ve workflow'u hangi e-postaların tetikleyeceğini daraltmak için bir arama filtresi ekleyin.
İkisi de anlık kontrol etmez — gelen kutusu yaklaşık dakikada bir kontrol edilir. Microsoft mümkün olduğunda erken haber verdiğinde Outlook bazen daha hızlı tepki verir.
Sohbetten Çalıştırma
Chat Trigger block'u olan bir workflow doğrudan bir konuşmadan başlatılabilir:
"Haftalık satış raporu workflow'unu çalıştır"
Asistan onu asla sessizce çalıştırmaz. Action Requires Approval başlıklı bir onay kartı gösterir; kartta "This will run one of your workflows on your behalf." notu, seçtiği Workflow ve geçirmek istediği Inputs yer alır. Siz Approve'a tıklamadan hiçbir şey olmaz — Cancel ise isteği reddeder.
İçeri ne aktarılır
Kendinizi tekrar etmeniz gerekmez. Az önce gönderdiğiniz mesaj workflow'a otomatik olarak verilir; Chat Trigger'da Include chat history açıksa yakın konuşma da onunla gider — ancak yalnızca workflow sizinse (veya yöneticiyseniz), böylece konuşmanız asla başkasının workflow'una gitmez. Asistanın geçirdiği ek her şey, tıpkı elle çalıştırmada olduğu gibi workflow'un içinde <input.NAME> olarak okunabilir.
Önce neyin doğru olması gerekir
| Gereksinim | Neden |
|---|---|
| Workflow bir Chat Trigger block'u içerir | Bu, workflow'u kuranın onayıdır — o olmadan workflow sohbetten erişilemez. |
| Workflow Active | Sohbet otomatik bir tetikleyicidir. Aktif olmayan bir workflow reddedilir ve size onu Workflows sayfasından etkinleştirmeniz söylenir. |
| Yöneticiniz asistan için workflow çalıştırmayı açmış olmalı | Workflow çalıştırma, yönetici denetimindeki bir asistan yeteneğidir. |
| O workflow'u çalıştırma izniniz var | Yalnızca başlatmanıza izin verilen workflow'ları görürsünüz. |
| Kartı onaylarsınız | Son onay her zaman sizindir. |
Asistanın genel olarak nasıl onay istediği için bkz. Araçları Kullanma.
Çalışmadan Sonra
Her çalışma — elle, zamanlamayla, webhook ile veya sohbetten — kaydedilir. İncelemek için Logs sekmesini açın:
- İstediğiniz çalışmayı bulmak için workflow, durum veya tetikleyiciye göre filtreleyin.
- Her adımın girdisini ve çıktısını görmek ve doğrudan başarısız olan adıma atlamak için bir çalışmayı açın.
- Aynı başlangıç verisiyle yeniden çalıştırmak için Re-run'ı kullanın.
Tam anlatım için bkz. Loglar.
Başarısız çalışmaların çoğu bozuk block'lardan değil, veri sorunlarından kaynaklanır. <input.email> veya <agent.content> gibi bir başvuru, orada olmayan bir şeyi göstermiştir. Değerin tam olarak nerede kaybolduğunu görmenin en hızlı yolu, çalışma detayındaki adım adım girdi ve çıktıdır.
İpuçları
- Önce Run düğmesiyle test edin. Bir zamanlama eklemeden veya adresi dış bir servise vermeden önce temiz bir elle çalışma alın.
- Test değerlerini doldurun. Value'su olmayan bir Start block girdisi, test çalışmanızın hiçbir şeyle başlaması ve sonraki başvuruların boş kalması demektir.
- Etkinleştirmeyi unutmayın. Editörden kusursuz çalışan bir workflow, Active olana kadar kendi kendine ateşlenmez.
- Block'larınıza net isimler verin. Block adları çalışma detayında okuduğunuz — ve
<blockName.field>başvurularında yazdığınız — şeydir. - Webhook sırrını hemen kopyalayın. Bir kez gösterilir. Döndürmek kolaydır ama gönderen servisi de güncellemeniz gerekir.
- Her çalışmadan sonra Logs sekmesine bakın — workflow'un yalnızca bittiğini değil, beklediğinizi yaptığını doğrulayın.
İlgili Sayfalar
- Workflow Oluşturma — çalıştıracağınız akışı kurun
- Block'lar — her tetikleyici ve adımın ne yaptığı
- Değişkenler — bir çalışma boyunca değerleri saklayın ve yeniden kullanın
- Bağlantılar — bir çalışmanın ihtiyaç duyduğu bağlantıları kurun ve onarın
- Zamanlamalar — bir workflow'u gözetimsiz, belirli aralıklarla çalıştırın
- Loglar — her çalışmayı adım adım inceleyin