Bloklar
Blok, bir iş akışındaki tek bir adımdır. Her blok tek bir iş yapar — çalıştırmayı başlatır, bir AI ajanına soru sorar, bir koşulu kontrol eder, bilgi bankanızda arama yapar, bir tabloya satır yazar, Slack mesajı gönderir. Blokları oklarla birbirine bağlarsınız ve sırayı oklar belirler.
Bu sayfa başvuru kataloğudur: paletteki her blok, ne işe yaradığı ve yapılandırırken önemli olan ayarlar.
:::tip Yeni başlıyorsanız buradan başlayın Henüz bir iş akışı kurmadıysanız önce İş Akışı Oluşturma sayfasını okuyun — tuvali, blok eklemeyi ve bağlamayı orası anlatır. Belirli bir bloğun ne yaptığını öğrenmek istediğinizde buraya dönün. :::
Bir Bloğun Üstlenebileceği Roller
Her blok belirli bir rolü üstlenir. Akışı rollerle düşünmek tasarımı çok kolaylaştırır — neredeyse her zaman bir tetikleyiciye, birkaç iş bloğuna ve bunları bir arada tutan birkaç akış bloğuna ihtiyacınız olur.
| Rol | Bu bloklar ne yapar | Palette nerede bulunur |
|---|---|---|
| Tetikleyici | Çalıştırmayı başlatır ve ilk veriyi akışa verir | Tetikleyiciler |
| İş | Asıl işi yapar — üretir, karar verir, arar, sorgular, hesaplar, dışarıya çağrı yapar | AI, Veri, Arketic, Entegrasyonlar |
| Akış | Çalıştırmayı yönlendirir — dallandırır, tekrarlar, böler, bekletir, bir kişiye sorar | Mantık |
| Biçimlendirme | Akıştan geçen verinin biçimini, zamanlamasını veya saklanmasını değiştirir | Veri (Yanıt, Değişkenler), Mantık (Bekle) |
| Entegrasyon | Ekibinizin zaten kullandığı bir servisin içinde işlem yapar | Entegrasyonlar |
| Açıklama | Akışı ekip arkadaşlarınıza anlatır. Çalıştırmaya katılmaz | Notlar |
Palette blok bulma
Palet, yan paneldeki Araç Çubuğu sekmesidir. Üstte Tetikleyiciler, altında Bloklar bölümü bulunur; birine daha çok yer açmak için aralarındaki çizgiyi sürükleyin.
| Ne yapmak istiyorsunuz | Nasıl |
|---|---|
| Kategoriye göre gezinmek | Bloklar bölümü AI, Mantık, Veri, Arketic, Entegrasyonlar ve Notlar olarak gruplanır. Her başlık içindeki blok sayısını gösterir; grubu daraltmak veya genişletmek için başlığa tıklayın |
| Bir servisi açmak | Entegrasyonlar altında her servis, blok sayısını gösteren tek bir karttır. O servisin bloklarını görmek için karta tıklayın |
| Servisten geri dönmek | Listenin başındaki, geri oku ve servis adı bulunan satıra tıklayın (Tüm bloklara dön) |
| Aramak | Araç Çubuğu başlığındaki büyütece tıklayıp yazın. Arama blok adlarına ve açıklamalarına bakar ve eşleşenleri tek bir düz liste olarak gösterir — tetikleyiciler ve bloklar, servis kartları olmadan. Eşleşme yoksa "Tetikleyici yok" veya "Blok yok" yazısını görürsünüz |
| Blok eklemek | Tuvale sürükleyin, üzerine tıklayın veya sağ tıklayıp Tuvale ekle'yi seçin |
:::note Göremeyebileceğiniz bloklar Paylaşımlı Klasör ve Paylaşımlı Klasör Tetikleyici yalnızca kurumunuzda bir paylaşımlı klasör kuruluysa ve rolünüz onu kullanmanıza izin veriyorsa görünür. Bkz. Paylaşımlı Klasör. :::
Her Blokta Bulunanlar
| Öğe | Neden önemli |
|---|---|
| Bir ad | Bloğu yapılandırma görünümünde yeniden adlandırırsınız. Sonucunu daha sonra bu adla okursunuz, bu yüzden kısa ve anlamlı tutun. İki blok aynı adı taşıyamaz; loop, parallel, variable, input ve form sözcükleri de blok adı olarak kullanılamaz |
| Ayarlar | Doldurduğunuz alanlar. Tam ekran yapılandırma görünümünü açmak için bloğa çift tıklayın veya üzerine gelince çıkan araç çubuğundaki Ayrıntıları aç'ı kullanın |
| Ek alanlar | Daha az kullanılan ayarlar Ek alanları göster düğmesinin arkasındadır |
| Girdi ve Çıktı | Yapılandırma görünümü solda gelen veriyi, sağda çıkan sonucu gösterir |
| Açık/kapalı durumu | Bir bloğu silmeden kapatmak için Devre dışı bırak'ı kullanabilirsiniz. Devre dışı bloklar tuvalde soluk görünür |
Üzerine gelince çıkan araç çubuğunun tamamı, sağ tık menüleri ve klavye kısayolları için Araç Çubuğu sayfasına bakın.
Bloklar Veriyi Birbirine Nasıl Aktarır
Bir blok neredeyse hiçbir zaman tek başına çalışmaz — daha önceki bir adımın ürettiği bir şeyi okur. Bunu bir alana yazdığınız referansla yaparsınız.
| Referans | Neyi gösterir |
|---|---|
<input.NAME> | Çalıştırmanın başladığı verideki bir alan |
<blockName.field> | Daha önceki bir bloğun çıktısı — örneğin <agent.content> |
<variable.NAME> | Kendi tanımladığınız bir iş akışı değişkeni |
<loop.index>, <loop.currentItem> | Bir döngünün içinde: geçerli turun numarası ve Her Öğe İçin bloğunda geçerli öğe |
<form.submitter.name> | Bir form çalıştırmasında: formu gönderen kişi (ayrıca .id ve .email) |
Blok adı kısmında büyük-küçük harf ve boşluklar önemli değildir: Arketic Parse File adlı bir blok <arketicparsefile.data> olarak okunur.
Referansı elle yazmanız nadiren gerekir — seçmek için alana @ yazın veya alanı Yukarı akış görünümünden sürükleyin. İkisini de, bir referansın çağırabileceği fonksiyonlarla birlikte Değişkenler sayfası anlatır.
Adımlar arasında dosya aktarma
Bazı bloklar sonraki adıma metin yerine bir dosya verir:
| Dosya üretir | Önceki adımdan dosya alır |
|---|---|
| Paylaşımlı Klasör (Dosyayı oku), Arketic Dosya Ayrıştır (metin olarak okuyamadığı dosyalarda) | Arketic Dosya Ayrıştır, Arketic OCR, Arketic Belgelere Kaydet, Paylaşımlı Klasör (Dosya yaz), SMTP (Eklerle gönder) |
Bir çalıştırmanın dosyaları geçicidir: çalıştırma bitince silinir. Birini saklamak için Arketic Belgelere Kaydet ile kaydedin veya paylaşımlı klasöre yazın.
Çalıştırma sorunlarının çoğu bozuk adımlar değil, veri sorunlarıdır — genellikle var olmayan bir değeri gösteren bir referans. Bunları Kayıtlar bölümündeki adım bazlı Girdi ve Çıktı görünümünde bulursunuz.
Tetikleyiciler
Tetikleyici giriş noktasıdır: çalıştırmanın nasıl başlayacağını ve hangi veriyle başlayacağını belirler. Her iş akışının en az bir tetikleyiciye ihtiyacı vardır.
| Blok | Ne yapar | Önemli ayarlar | Size ne verir |
|---|---|---|---|
| Başlat | Elle tetikleyici. İş akışını editörden istediğiniz an çalıştırmak için ekleyin | Girdi (ek alanların altında) — her biri Ad ve Tür içeren alanların listesi | input — çalıştırmanın başladığı veri. Bir alanı <input.NAME> ile okursunuz |
| API Tetikleyici | Başka bir sistemin, adresini çağırarak iş akışını başlatmasını sağlar | API uç noktası — adres, bir anahtar ve tetikleyicinin durumu (aşağıya bakın) — ve zorunlu bir Girdi şeması | body, headers, query |
| Webhook | Herhangi bir servisten veya API'den webhook alır | Webhook uç noktası — sizin için oluşturulan adres ve imzalama anahtarı ile Duraklat ve Devam ettir düğmeli Aktif / Duraklatıldı durumu | body, headers, path, receivedAt, clientIp |
| Hata Tetikleyicisi | Bu iş akışını hata iş akışı olarak seçen başka bir iş akışı başarısız olduğunda bu iş akışını başlatır | Blokta ayar yoktur. Diğer iş akışında İş akışı ayarları'nı açın ve Hata iş akışı altında bunu seçin | workflow, execution, error |
| Sohbet Tetikleyici | Sohbet giriş noktası — iş akışını bir konuşmadan başlatır | Sistem promptu, Sohbet geçmişini dahil et (varsayılan olarak açık) | message, history |
| Form Tetikleyici | Bir kişi formu doldurup gönderdiğinde iş akışını başlatır | Form başlığı, Açıklama, Alanlar, Gönder düğmesi metni, Gönderimden sonraki mesaj ve formun Bağlantı'sı | Her form alanı için bir çıktı, ayrıca submittedAt ve formId |
| Telegram Tetikleyici | Telegram botunuza bir mesaj geldiğinde iş akışını başlatır | Bir Bot token bağlantısı. Bağlantı canlı durumu gösterir | message, sender, updateId, updateType |
| WhatsApp Tetikleyici | WhatsApp Business numaranıza bir mesaj geldiğinde iş akışını başlatır | Meta uygulamanızın Meta App ID ve Meta App Secret değerleri (secret bir bağlantı olarak saklanır) — ikisi de girildiğinde ve iş akışı aktifken tetikleyici kendini Meta'ya kaydeder | message, sender, phoneNumberId, changeType |
| Slack Tetikleyici | Slack uygulamanız bir olay aldığında iş akışını başlatır — bir mesaj, bir bahsetme, bir tepki ve daha fazlası | Bir Slack Signing Secret bağlantısı. Bloğu açtığınızda, Slack'in kendi Event Subscriptions sayfasına yapıştıracağınız bir İstek adresi alırsınız | message, sender, channel, eventType, teamId, eventId, reaction |
| Gmail Tetikleyici | Bağlı bir Gmail gelen kutusuna yeni e-posta geldiğinde iş akışını başlatır | Google hesabı, E-posta gövdesini dahil et (varsayılan olarak kapalı), Filtre (isteğe bağlı) | message, sender, to, raw, provider |
| Outlook Tetikleyici | Bağlı bir Outlook / Microsoft 365 gelen kutusuna yeni e-posta geldiğinde iş akışını başlatır | Microsoft hesabı, E-posta gövdesini dahil et (varsayılan olarak kapalı), Filtre (isteğe bağlı) | message, sender, to, raw, provider |
| IMAP Tetikleyici | Bir IMAP sunucusundaki posta kutusuna yeni e-posta geldiğinde iş akışını başlatır | IMAP sunucusu, Port (993 (TLS) veya 143 (STARTTLS)), Klasör, bir Posta kutusu hesabı bağlantısı (kullanıcı adı ve parola), E-posta gövdesini ekle (varsayılan olarak kapalı) | message, sender, to, raw, provider |
| Paylaşımlı Klasör Tetikleyici | Kurumunuzun paylaşımlı klasöründeki bir klasöre gelen her dosya için bir çalıştırma başlatır | Klasör, Ad filtresi (örneğin *.pdf), Çalıştırma başlatan dosyalar — Yeni dosyalar veya Yeni ya da değişen dosyalar | file (name, path, size, modifiedAt, extension ile), folder, kind |
Bir iş akışı tekrar eden bir zamanlamayla da başlatılabilir — bu bir blokla değil, Zamanlamalar sekmesinden kurulur.
API Tetikleyici
Bir API Tetikleyici bloğunu açtığınızda adresi oluşturulur. API uç noktası paneli şunları gösterir:
| Bölüm | Ne işe yarar |
|---|---|
| Adres | Diğer sistemin çağrısını gönderdiği yer. Yanındaki düğmeyle kopyalayın |
| Anahtar | Her çağrı bunu taşımalıdır. Yalnızca bir kez, oluşturulduğu anda gösterilir: "Bu anahtarı şimdi kopyalayın, bir daha gösterilmeyecek." Kaybederseniz Yeni anahtar'ı kullanıp onaylayın — eski anahtar hemen geçersiz olur |
| Çağrı kabul ediyor / Duraklatıldı | Çağrıların çalıştırma başlatıp başlatmadığı. Duraklat ve Sürdür ile değiştirin |
| Son çağrılar | Bu tetikleyicinin başlattığı son çalıştırmalar ve durumları |
Güvenmeden önce bilmeniz gereken iki kural:
- Girdi şeması zorunludur. Her çağrının gövdesi bu şemaya göre kontrol edilir ve geçerli bir şema olmadan iş akışı yayımlanamaz.
- Her çağrı iş akışının yayımlanan sürümünü, onu yayımlayan kişi olarak ve onun bağlı hesaplarıyla çalıştırır.
Formlar, onaylar ve paylaşımlı klasör
Bu blokların kendi sayfaları vardır:
| Bloklar | Sayfa |
|---|---|
| Form Tetikleyici, Form Sayfası | Formlar — formu kurma, kimlerin doldurabileceği, cevapları kullanma |
| Onay | Onaylar — kişilerden onay isteme veya form doldurmalarını isteme ve onaylayanın gördükleri |
| Paylaşımlı Klasör, Paylaşımlı Klasör Tetikleyici | Paylaşımlı Klasör — kurumunuzun sunucusundaki dosyaları okuma ve yazma |
:::info Anlık tetikleyiciler ve belirli aralıklarla kontrol edilenler Gmail Tetikleyici, Outlook Tetikleyici, IMAP Tetikleyici ve Paylaşımlı Klasör Tetikleyici bir şey gelir gelmez tepki vermez — gelen kutusu veya klasör yaklaşık dakikada bir kontrol edilir. Outlook Tetikleyici ayrıca mümkün olduğunda Microsoft'tan erken haber alır, bu yüzden bazen daha hızlı tepki verir. :::
:::note Bir iş akışını sohbetten başlatma Sohbet Tetikleyici içeren bir iş akışı, bir AI asistanıyla yaptığınız konuşmadan başlatılabilir. Asistan önce iş akışının adını ve girdilerini gösteren bir onay kartı sunar — siz onaylamadan hiçbir şey çalışmaz. Bu yalnızca iş akışı başlatmasına izin verilmiş bir asistanla ve yalnızca çalıştırma izniniz olan iş akışları için çalışır. Tetikleyiciye yazdığınız Sistem promptu kendi başına bir şey yapmaz: kullanmak için bir AI bloğuna aktarın. :::
:::caution Gelen veriyi güvenilmez kabul edin
Webhook, API Tetikleyici, Telegram Tetikleyici, WhatsApp Tetikleyici, Slack Tetikleyici, bir e-posta tetikleyicisi veya herkese açık bir form üzerinden gelen veri kurumunuzun dışından gelir. <input.…> değerlerini kontrol etmeden doğrudan bir AI promptuna aktarırken dikkatli olun.
:::
Webhook adresleri, imzalama anahtarları ve Slack, WhatsApp, Gmail ve Outlook tetikleyicilerinin kurulum adımları için İş Akışı Çalıştırma sayfasına bakın.
AI Blokları
Bunlar yapay zekâ ile içerik üreten, değerlendiren, arayan veya dönüştüren bloklardır.
:::info Modeller ve bağlantılar Ajan, Yönlendirici ve Değerlendirici bloklarında Arketic AI ile başlayan bir Model açılır listesi vardır — bu seçenek hiçbir kurulum gerektirmez. Harici bir sağlayıcının modelini kullanmak için önce Sağlayıcı kimlik bilgisi alanından o sağlayıcının bağlantısını seçin; modelleri bunun ardından Model listesinde görünür. Diğer AI bloklarının çoğu dışarıdaki bir servise ulaşır ve her zaman bir bağlantıya ihtiyaç duyar. Bkz. Bağlantılar. :::
Akıl yürütme ve karar verme
| Blok | Ne yapar | Önemli ayarlar | Size ne verir |
|---|---|---|---|
| Ajan | Yazan, sınıflandıran, özetleyen veya bilgi çıkaran ve yapılandırılmış çıktı döndürebilen bir AI adımı. Çoğu iş akışının asıl iş gücü | Prompt — ya Mesajlar ya da bir Sistem promptu ile bir Kullanıcı promptu (aşağıya bakın) — Model, Sağlayıcı kimlik bilgisi ve ek alanların altında Sıcaklık (0–1, varsayılan 0,7), Maksimum çıktı token’ı (varsayılan 2048) ve Yanıt biçimi (JSON Şeması) | content, model, tokens, toolCalls, iterations, reasoning, executionTime, memoryStatus, memoryError. Yanıt biçimi varsa: structuredResponse — bir alanı <agent.structuredResponse.FIELD> ile okursunuz |
| Yönlendirici | Durumu yapay zekâ ile okuyarak birkaç yoldan birini seçer | Model, Sağlayıcı kimlik bilgisi, Yönlendirme promptu, Rotalar | selectedRoute, selectedPath, content, model, tokens |
| Değerlendirici | Bir sonucu bir ölçüte göre puanlar — bir sonuca göre hareket etmeden önce kalite kontrolü olarak kullanışlıdır | Model, Sağlayıcı kimlik bilgisi, Değerlendirme ölçütü (her satıra bir kural), Hedef alan (örneğin <agent.content>) | quality — 0 ile 10 arasında bir puan — ayrıca content, model, executionTime, tokens |
| Bilgi | Kurumunuzun bilgi bankasında bir soruya en uygun bölümleri arar | Sorgu, En iyi K sonuç (kaç sonuç getirileceği, 1–50, varsayılan 5), Kapsam — Kurum geneli veya Yalnız departman | results, query, total, scope |
Bir Ajan promptunu iki biçimden birinde tutar ve yalnızca kullandığını gösterir: Mesajlar — Sistem, Kullanıcı ve Asistan sıralarından oluşan bir liste — veya bir Sistem promptu ile bir Kullanıcı promptu. Yeni bir Ajan bloğu Mesajlar ile başlar.
Bu iş akışı için bilgi
Web Sitesi Tarayıcı ve Belge, diğer tüm AI bloklarından farklı çalışır: sonraki bir adımda okuduğunuz bir çıktı üretmezler. Bunun yerine, birini bir Ajan veya Arketic Assistant bloğuna, o bloğun ikinci ve ayrı bağlantı noktasından bağlarsınız — normal girdisinin yanındaki turkuaz renkli Bilgi portundan (üzerine gelince şu ipucu çıkar: "Bilgi — bir Website Scraper ya da Document bloğu bağlayın"). Bu turkuaz bağlantıya Bilgi kablosu denir. Veri taşımaz — yalnızca bloğa "bundan yararlanarak cevap verebilirsin" der.
| Blok | Ne yapar | Önemli ayarlar |
|---|---|---|
| Web Sitesi Tarayıcı | Bir web sitesini yalnızca bu iş akışına ait bir bilgi bankasına tarar | Web sitesi adresi, Yenileme sıklığı — Günlük (varsayılan), Saatlik veya Yalnız elle. İş akışı aktif olur olmaz ilk tarama başlar. Kaynak tarama durumunu gösterir ve Şimdi yeniden tara düğmesini içerir |
| Belge | Belgeleri yalnızca bu iş akışına ait bir bilgi bankasına yükler | Belgeler — PDF, Word (.doc/.docx), Markdown veya düz metin dosyası eklemek için Belge yükle'yi kullanın |
Bu iki bloğun tuvalde normal bir girdisi veya çıktısı yoktur — kabul ettikleri tek bağlantı, bloktan bir Bilgi portuna sürüklenen Bilgi kablosudur. Bu, kurumunuzun Bilgi Bankası'ndan ayrıdır: burada eklediğiniz yalnızca bu tek iş akışına özeldir.
Görsel, video ve konuşma
Bu bloklar dışarıdaki bir sağlayıcıyı kullanır ve bir Kimlik bilgisi ister. Arketic kategorisinde konuşma ve görsel bloklarının bağlantı gerektirmeyen sürümleri vardır — bkz. Arketic Blokları.
| Blok | Ne yapar | Önemli ayarlar | Size ne verir |
|---|---|---|---|
| Görsel Üretici | Yazılı bir açıklamayı görsele dönüştürür | Kimlik bilgisi, Sağlayıcı (OpenAI DALL-E 3 veya GPT Image 1), Prompt, Boyut, Adet (1–4) | images, imageUrl, imageBase64, revisedPrompt, model |
| Video Üretici | Yazılı bir açıklamayı videoya dönüştürür. Arka planda çalışır ve zaman alabilir | Kimlik bilgisi, Sağlayıcı (Runway, Google Veo, Luma, MiniMax veya Fal.ai), Prompt ve ek alanların altında Model, Süre (saniye), En-boy oranı, Çözünürlük, Prompt iyileştirici | videoUrl, jobId, duration, tokens |
| Görüntü Analizi | Bir görsele bakar, onu açıklar veya hakkında sorulan soruları yanıtlar | Kimlik bilgisi, Model (OpenAI GPT-4o (çok modlu) veya Claude Sonnet 4.6), Görsel adresi, Prompt | content, provider, model, finishReason, tokens |
| Konuşmadan Metne | Bir ses dosyasını metne çevirir | Kimlik bilgisi, Ses adresi, Dil (Otomatik algıla, Türkçe veya English) | text, language, duration, segments, words |
| Metinden Konuşmaya | Metni sesli olarak okur ve ses dosyası üretir | Kimlik bilgisi, Metin, Ses (Alloy, Echo veya Nova), Hız | audioBase64, contentType, byteLength, voice |
| ElevenLabs | ElevenLabs'in yapay zekâ sesleriyle metinden konuşma üretir | Kimlik bilgisi, Metin, Ses kimliği, Model | audioBase64, contentType, byteLength, voiceId, modelId |
Arama ve belge yapay zekâsı
| Blok | Ne yapar | Önemli ayarlar | Size ne verir |
|---|---|---|---|
| Serper | Serper üzerinden Google araması — web, haber, mekan veya görsel | Kimlik bilgisi, Sorgu, Arama türü, Sonuç sayısı | searchResults, searchType, raw |
| Perplexity Sohbet | Arama destekli sohbet: güncel web sonuçlarından yazılmış bir yanıt | Kimlik bilgisi, Model (Sonar, Sonar Pro, Sonar Deep Research veya Sonar Reasoning Pro), Prompt | content, model, tokens, finishReason |
| Perplexity Arama | Perplexity dizininden sıralanmış web arama sonuçları | Kimlik bilgisi, Sorgu ve ek alanların altındaki filtreler | results, tokens |
| Linkup | Kaynak gösteren yanıtlar döndüren web araması | Kimlik bilgisi, Sorgu, Derinlik (Standart veya Derin), Çıktı türü (Kaynaklı yanıt veya Arama sonuçları) | data, query, depth, outputType |
| Mistral Ayrıştırma | Bir belgeyi okur ve kullanılabilir metne dönüştürür | Kimlik bilgisi, ayrıca Barındırılan dosya adresi, Yükleme adresi veya Dosya (base64) alanlarından biri ve bir Sonuç türü (Markdown, Metin veya JSON) | content, pages, pagesProcessed, model, resultType |
| HuggingFace | HuggingFace Inference Router üzerinden sohbet tamamlama | Kimlik bilgisi, Sağlayıcı, Model, Prompt | provider, model, content, tokens, finishReason |
Mantık Blokları
Mantık blokları içerik üretmez — çalıştırmanın nereye gideceğine, bir şeyin kaç kez olacağına ve devam etmeden önce bir kişinin ne zaman yanıt vermesi gerektiğine karar verir.
| Blok | Ne yapar | Önemli ayarlar | Size ne verir |
|---|---|---|---|
| Koşul | Çalıştırmayı doğru/yanlış bir kontrole göre dallandırır; if, else-if ve else yolları vardır | Koşullar — her dal için ifade | conditionResult, selectedOption. Seçilen dal devam eder, diğerleri durur |
| Fonksiyon | Hiçbir blok tam olarak ihtiyacınızı karşılamadığında kendi küçük kodunuzu çalıştırır | Dil (JavaScript), Kod, Zaman aşımı (ms) (varsayılan 5000, en çok 300.000 — beş dakika). Gelen veriye değişken olarak erişilir; döndürdüğünüz değer çıktı olur. Ek bir kod kütüphanesi mi gerekiyor (örneğin belirli bir dosya biçimini okumak veya bir web tarayıcısını yönetmek için)? Bkz. Paketler | result — kodunuzun döndürdüğü değer — ve stdout, kodun yazdırdıkları |
| Bekle | Çalıştırmayı belirli bir süre duraklatır | Süre (ms) (0–3.600.000 — bir saate kadar) | waitedMs, waitStatus. Süre sonunda çalıştırma devam eder |
| Form Sayfası | Bir formun sonraki sayfası: çalıştırma, formu dolduran kişi bu sayfayı gönderene kadar bekler. Yalnızca bir Form Tetikleyici'den sonra çalışır | Sayfa başlığı, Açıklama, Alanlar, Gönder düğmesi metni | Her alan için bir çıktı, ayrıca submittedAt. Bkz. Formlar |
| Onay | Kurumunuzdaki kişilerden onaylamalarını veya reddetmelerini ya da bir form doldurmalarını ister. Çalıştırma yanıtlarını bekler ve Onaylandı veya Reddedildi dalından devam eder | İstek, Ayrıntılar, Onaylayanlar, Karar (Bir onaylayan yeterli veya Herkes onaylamalı), Onaylayanlar reddedebilir (varsayılan olarak açık; kapatıldığında blok, birine gönderilen ve tek bir Gönderildi dalı olan bir forma dönüşür), Doldurulacak alanlar, Yanıt süresi (saat) (20–167, varsayılan 72 — süre dolunca çalıştırma iptal edilir) | approved, decision, reason, decidedAt, decidedBy, fields, responses. Bkz. Onaylar |
| For Döngüsü | İçindeki adımları sabit sayıda tekrarlar | Tur sayısı (1–1000) | results |
| While Döngüsü | Bir koşul doğru kaldığı sürece tekrarlar | Koşul, Maksimum tur (güvenlik sınırı) (varsayılan 100) | results |
| Her Öğe İçin | İçindeki adımları bir listedeki her öğe için bir kez tekrarlar | Öğeler, Maksimum tur (güvenlik sınırı) (varsayılan 1000) | results |
| Do-While Döngüsü | İçindeki adımları bir kez çalıştırır, ardından koşul sağlandığı sürece tekrarlar | Koşul, Maksimum tur (güvenlik sınırı) (varsayılan 100) | results. En az bir kez çalışır |
| Paralel | Birkaç dalı aynı anda çalıştırır ve sonuçları toplar | Kip — Sayı (N dal) veya Koleksiyon (öğe başına) — Maksimum eşzamanlılık (1–20, varsayılan 5) ve ek alanların altında koleksiyon ile İlk hatada dur | results, terminalResults |
Bir döngünün içindeki adımlar geçerli turu <loop.index> ile, Her Öğe İçin bloğunda geçerli öğeyi <loop.currentItem> ile okur. Koleksiyon kipindeki bir Paralel bloğunun içinde aynı değerler <parallel.index> ve <parallel.currentItem> olur. Bunlar döngü bloğunun kendi çıktıları değildir: döngüden sonra bloğun tek çıktısı results olur.
:::caution Döngülerinize her zaman sınır koyun While Döngüsü ve Do-While Döngüsü bir koşula dayanır ve hiçbir zaman yanlış olmayan bir koşul çalıştırmayı süresiz olarak sürdürür — Maksimum tur (güvenlik sınırı) ayarı bunun sınırıdır. Her Öğe İçin bloğunda da aynı ayar bulunur; orada beklenmedik ölçüde büyük bir listeye karşı koruma sağlar. :::
Veri Blokları
Veri blokları bilgiyi iş akışına alır, dışarı çıkarır ve adımlar arasında saklar.
| Blok | Ne yapar | Önemli ayarlar | Size ne verir |
|---|---|---|---|
| API | Dışarıdaki bir servise istek gönderir | Metot (GET, POST, PUT, PATCH, DELETE), URL, isteğe bağlı Kimlik doğrulama bağlantısı ve ek alanların altında Sorgu parametreleri, Başlıklar, Gövde, Zaman aşımı (ms) | status, data, headers |
| Yanıt | Çıkış noktası — sonucu iş akışını çağırana (bir API veya sohbet tetikleyicisine) döndürür | Yanıt verisi kipi (Oluşturucu veya JSON (ham)), Alanlar ya da Gövde (JSON), bir HTTP durumu ve Başlıklar | Çalıştırmanın o yolunu bitirir ve sonucu geri verir |
| Değişkenler | Bir iş akışı değişkenini okur veya yazar; böylece bir değer adımlar arasında yaşamaya devam eder | İşlem (Oku veya Yaz), Değişken adı, Değer (yalnız yazmada) | value |
| Paylaşımlı Klasör | Kurumunuzun paylaşımlı klasöründeki dosyalarla çalışır | İşlem — Dosyaları listele, Bilgi al, Dosyayı oku, Dosya yaz, Taşı ya da yeniden adlandır, Kopyala, Sil veya Klasör oluştur — ve işlemin uygulanacağı Yol (ya da Kaynak ve Hedef) | İşleme göre değişir — örneğin bir listeleme için items, okunan bir dosya için file. Bkz. Paylaşımlı Klasör |
Tablo blokları
Bunlar kendi tablolarınızı okur ve yazar — iş akışlarınızın çalıştırmalar arasında sakladığı yapılandırılmış veriyi. Her birinde tabloyu bir kimlik yazarak değil, bir Tablo açılır listesinden seçersiniz.
| Blok | Ne yapar | Önemli ayarlar | Size ne verir |
|---|---|---|---|
| Tablo — Satır Ekle | Yeni bir satır ekler | Tablo, { columnName: value } biçiminde Satır verisi | row |
| Tablo — Satır Sorgula | Bir filtreye uyan satırları bulur | Tablo ve ek alanların altında Filtre, Sıralama, Sınır (1–1000, varsayılan 100), Atlama | rows, total |
| Tablo — Satır Getir | Belirli bir satırı getirir | Tablo, Satır kimliği | row |
| Tablo — Satır Güncelle | Var olan bir satırı değiştirir | Tablo, Satır kimliği, Satır verisi | row |
Değerler sütunun türüyle uyuşmalıdır ve arama anlam tabanlı değil, birebir filtre tabanlıdır. Tablo oluşturma, sütun türleri ve filtre seçeneklerinin tamamı için Tablolar sayfasına bakın.
İş akışı değişkenleri, panel başlığından veya tuvale sağ tıklayarak açılan Değişkenler panelinde oluşturulur ve düzenlenir. Değişkenler bloğu ise çalışan bir iş akışının bu değişkenleri okuma ve yazma yoludur.
Arketic Blokları
Bunlar zaten Arketic içinde bulunan şeyler üzerinde işlem yapar. Hiçbir bağlantı kurulumu gerektirmezler — doğrudan çalışırlar.
Asistanlar ve yapay zekâ
| Blok | Ne yapar | Önemli ayarlar | Size ne verir |
|---|---|---|---|
| Arketic Assistant | Kayıtlı asistanlarınızdan birini bir adım olarak çalıştırır — kendi talimatları, modeli, araçları ve bilgisiyle | Assistant (liste, kullanabildiğiniz asistanları gösterir), Task, Knowledge base (Assistant's own documents, This workflow's uploads veya Both), Answer language (Türkçe, English veya The assistant's own rule). In a workflow, asistanın araçlarından hangilerinin burada çalışabildiğini gösterir | content, structuredResponse, sources, assistantName, model, tokens, toolCalls |
| Arketic LLM Sohbet | Bir ajan kurmadan doğrudan Arketic'in kendi yapay zekâsına soru sorar | Sistem promptu, Kullanıcı promptu, Sıcaklık | content, model, tokens, finishReason |
:::info Arketic Assistant bloğu, iş akışını çalıştıran kişi olarak çalışır Blok sizin değil, iş akışını çalıştıran kişinin erişimini kullanır. Asistan kısıtlıysa ve o kişi asistanı kullanamıyorsa bu adım o kişi için hata verir. :::
Arama ve bilgi
| Blok | Ne yapar | Önemli ayarlar | Size ne verir |
|---|---|---|---|
| Arketic Bilgi Bankası Arama | Bir soruyu birebir kelimelerle değil anlamıyla eşleştirerek bilgi bankasındaki en uygun bölümleri bulur | Sorgu, En iyi K sonuç (1–50, varsayılan 5), sonuçların isteğe bağlı olarak yeniden sıralanması | results, query, total, scope |
| Arketic Belge Arama | Kurumunuzun belgelerinin metninde bir ifade arar | Arama sorgusu, Sınır (1–100, varsayılan 10) | documents, total, query |
| Arketic Web Arama | Arketic üzerinden web'de arama yapar | Sorgu, Dil, Kategori (Genel, Haber, Bilim veya Görsel), Sınır (1–10, varsayılan 5) | results, query, total |
| Arketic Yeniden Sıralama | Bir sonuç listesini alır ve en ilgili olanları öne taşır | Sorgu, Belgeler, En iyi K | results, query, total |
| Arketic Gömme | Metni, arama adımlarının karşılaştırabileceği sayısal bir biçime dönüştürür — kendi eşleştirme mantığınızı kurarken kullanışlıdır | Metin | embedding, dimension |
Dosyalar, konuşma ve görseller
| Blok | Ne yapar | Önemli ayarlar | Size ne verir |
|---|---|---|---|
| Arketic Dosya Ayrıştır | Bir dosyayı okur ve içeriğini döndürür. Metin, JSON, CSV, HTML ve XML veri olarak döner; diğer dosyalar sonraki bir adım için dosya olarak döner | İşlem — Adresten ayrıştır, Base64 ayrıştır veya Önceki adımdaki dosyayı ayrıştır — ve buna karşılık gelen Dosya adresi, Dosya (base64) veya Dosya. Ek alanların altında: Dosya adı, İçerik türü, Metin kodlaması | data — filename, contentType, format, size, content ve önceki bir adımdan gelen PDF için text ile |
| Arketic OCR | Bir görseldeki metni çıkarır | Önceki adımdan dosya veya Görsel adresi — ikisinden biri yeterlidir | text, metadata, pagesProcessed, truncated |
| Arketic Belgelere Kaydet | Çalıştırmanın geçici dosyalarından birini belgelerinize kaydeder; böylece çalıştırma bittikten sonra da saklanır | Dosya, Farklı kaydet (isteğe bağlı) | documentId, savedName, savedSize |
| Arketic Metinden Konuşmaya | Metni sesli olarak okur ve ses dosyası üretir | Metin, Dil (Türkçe veya English) | audioBase64, contentType, byteLength |
| Arketic Konuşmadan Metne | Sesi metne çevirir. WAV, FLAC veya OGG gönderin — WebM okunamaz | Ses adresi veya Ses (base64), Dil (Otomatik algıla, Türkçe veya English) | text, language, duration |
| Arketic Görsel | Yeni bir görsel üretir veya var olan bir görseli değiştirir | İşlem — Üret (metinden görsel) veya Düzenle (görselden görsel) — Prompt ve düzenleme için Kaynak görsel kimliği (düzenleme) veya Kaynak görsel adresi (düzenleme) ile Etki gücü (düzenleme). Ayrıca Olumsuz prompt, Boyut, Tohum, Adım sayısı | imageUrl, imageId, size, seed, warning |
Görevler, bildirimler ve süreçler
| Blok | Ne yapar | Önemli ayarlar | Size ne verir |
|---|---|---|---|
| Arketic Görev Oluştur | Bir görev oluşturur | İşlem (Görev oluştur), Başlık ve ek alanların altında Açıklama, Durum, Öncelik, Departman kimliği, Son tarih, Üst görev kimliği ve Etiketler | taskId, task |
| Arketic Görev Güncelle | Var olan bir görevi günceller | İşlem (Görevi güncelle), Görev kimliği ve değiştirilecek en az bir alan | taskId, task |
| Arketic Bildirim Gönder | Kurumunuzdaki birine uygulama içi bildirim gönderir | İşlem (Bildirim gönder), Alıcı kullanıcı kimliği, Tür, Başlık ve ek alanların altında Gövde | notificationId, notification |
| Arketic Süreç Şablonu Başlat | İş akışından bir süreç şablonunu — bir insan sürecini — başlatır | Süreç şablonu kimliği, Girdiler, Çalıştırma kipi (Gönder ve bekleme veya Tamamlanmayı bekle) | blueprintInstanceId, blueprintId ve beklediğinde finalStatus ile outputs |
:::info İş akışı kimin adına işlem yapar Bir yönetici tarafından çalıştırılmayan iş akışı, onu çalıştıran kişinin adına işlem yapar — bildirimleri yalnızca o kişiye gidebilir ve görevleri o kişinin adına oluşturulur. Yönetici tarafından çalıştırılan iş akışları başka kişileri hedefleyebilir. :::
Görevler ve Süreç Şablonları yalnızca kurumunuzun paketi bunları içeriyorsa vardır.
İlgili sayfalar: Bilgi Bankası, Belgeler, Görevler, Süreç Şablonları.
Entegrasyon Blokları
Entegrasyon blokları ekibinizin zaten kullandığı servislerin içinde işlem yapar — Slack mesajı göndermek, GitHub'da kayıt açmak, Google Sheets'e satır eklemek, Linear kaydı oluşturmak ve çok daha fazlası.
Hepsi aynı yapıyı izler:
| Alan | Ne işe yarar |
|---|---|
| İşlem | O serviste hangi işlemin yapılacağı. Örneğin Slack için: Mesaj gönder, Mesajları oku, Kanalları listele, Tepki ekle, Kanal bilgisini getir, Kullanıcıyı getir |
| Kimlik doğrulama | Bloğun oturum açmak için kullandığı kayıtlı bağlantı |
| İşleme özel alanlar | O işlemin ihtiyaç duyduğu her şey — bir kanal, bir alıcı, bir belge, bir gövde. İşlem'i değiştirdiğinizde bunlar da değişir |
Palette entegrasyonlar her servis için tek bir kartta toplanır — örneğin Google; Gmail, Google Sheets, Google Drive, Google Calendar ve diğer Google bloklarını, Email ise IMAP ile SMTP'yi içerir. O servisin bloklarını görmek için karta tıklayın.
Bloğu olan servisler, bağlayabildiğiniz servislerdir — tam liste Bağlantılar sayfasındadır.
:::tip Önce hesabı bağlayın Bağlantıyı bloğun Kimlik doğrulama alanından seçin. Orada henüz bir şey yoksa Bağlantılar sekmesinden ekleyin — bağlı hesap kullanan servisler için oturum açın, anahtar kullanan servisler için anahtarı yapıştırın. Eksik veya reddedilmiş bir bağlantıya denk gelen bir çalıştırma duraklar ve hangi servisi beklediğini size söyler. :::
Notlar
| Blok | Ne yapar |
|---|---|
| Not | Doğrudan tuvalin üzerine yazılı bir açıklama ekler |
Notlar, iş akışınızı okuyan insanlar içindir. Markdown biçimlendirmesini kabul ederler ve yapıştırdığınız bir YouTube, Vimeo veya Spotify bağlantısı gömülü bir oynatıcıya dönüşür. Bir notun çalıştırılacak ayarı, girdisi ve çıktısı yoktur — hiçbir zaman çalıştırmaya katılmaz.
Notları akışın açık olmayan kısımlarını anlatmak için kullanın: bir koşulun neden öyle yazıldığı, dışarıdaki bir servisin ne beklediği veya bir adım hata vermeye başladığında kime sorulacağı.
Doğru Bloğu Seçmek
| Şunu yapmak istiyorsanız… | Şunu kullanın |
|---|---|
| Kurarken iş akışını kendiniz çalıştırmak | Başlat |
| Başka bir sistemin başlatmasını sağlamak | Webhook veya API Tetikleyici |
| Birinin doldurduğu bir formla başlamak | Form Tetikleyici, sonraki sayfalar için Form Sayfası |
| Bir e-posta veya dosya geldiğinde başlamak | Gmail Tetikleyici, Outlook Tetikleyici, IMAP Tetikleyici veya Paylaşımlı Klasör Tetikleyici |
| Yapay zekânın bir şey yazması, sınıflandırması veya özetlemesi | Ajan |
| Zaten kurduğunuz bir asistanı yeniden kullanmak | Arketic Assistant |
| Çalıştırmayı birkaç yoldan birine yönlendirmek | Koşul (evet/hayır) veya Yönlendirici (yapay zekânın seçtiği çok yollu) |
| Çalıştırma devam etmeden önce bir kişinin onaylaması | Onay |
| Bir listedeki her öğe için bir şey yapmak | Her Öğe İçin veya hepsini aynı anda yapmak için Koleksiyon kipinde Paralel |
| Kendi kurumsal bilginizden yanıt vermek | Bilgi veya Arketic Bilgi Bankası Arama |
| Bir AI adımının tek bir web sitesinden veya belgeden yanıt vermesini sağlamak | Web Sitesi Tarayıcı veya Belge, bir Ajan ya da Arketic Assistant bloğunun Bilgi portuna bağlı |
| Bir dosyanın veya taranmış bir belgenin metnini okumak | Arketic Dosya Ayrıştır veya Arketic OCR |
| Bir dosyayı çalıştırmadan sonra saklamak | Arketic Belgelere Kaydet |
| Bir değeri çalıştırmanın ilerisi için saklamak | Değişkenler |
| Çalıştırmadan sonra da kalacak bir şey saklamak | Bir Tablo bloğu |
| Sonucu çağırana geri döndürmek | Yanıt |
| Bir yapay zekâ sonucuna göre hareket etmeden kalitesini kontrol etmek | Değerlendirici |
| Başka bir iş akışı başarısız olduğunda haberdar olmak | Hata Tetikleyicisi |