Block'lar
Block, bir workflow'daki tek bir adımdır. Her block tek bir iş yapar — çalışmayı 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. Block'ları oklarla birbirine bağlarsınız ve sırayı oklar belirler.
Bu sayfa katalog referansıdır: her block ne işe yarar ve yapılandırırken hangi ayarlar önemlidir.
:::tip Yeni başlıyorsanız buradan başlayın Henüz bir workflow kurmadıysanız önce Workflow Oluşturma sayfasını okuyun — tuvali, block eklemeyi ve bağlamayı orası anlatır. Belirli bir block'un ne yaptığını öğrenmek istediğinizde buraya dönün. :::
Bir Block'un Üstlenebileceği Roller
Her block belirli bir rolü üstlenir. Akışı rollerle düşünmek tasarımı çok kolaylaştırır — neredeyse her zaman bir tetikleyiciye, birkaç iş block'una ve bunları bir arada tutan birkaç akış block'una ihtiyacınız olur.
| Rol | Bu block'lar ne yapar | Palette'te nerede bulunur |
|---|---|---|
| Tetikleyici | Çalışmayı başlatır ve ilk veriyi akışa verir | Triggers |
| İş | Asıl işi yapar — üretir, karar verir, arar, sorgular, hesaplar, dışarı çağrı atar | AI, Data, Arketic, Integrations |
| Akış | Çalışmayı yönlendirir — dallandırır, tekrarlar, böler, bekletir | Logic |
| Biçimlendirme | Akıştan geçen verinin biçimini, zamanlamasını veya saklanmasını değiştirir | Data (Response, Variables), Logic (Wait) |
| Entegrasyon | Ekibinizin zaten kullandığı bir servisin içinde işlem yapar | Integrations |
| Açıklama | Akışı ekip arkadaşlarınıza anlatır. Çalışmaya katılmaz | Notes |
Palet (yan paneldeki Toolbar sekmesi) bir Triggers bölümü ve bir Blocks bölümü olarak düzenlenmiştir. Blocks bölümü açılır kapanır bir akordeondur ve şu kategorileri içerir: AI, Logic, Data, Arketic, Integrations ve Notes. Entegrasyonlar her servis için tek bir kartta toplanır; kartı açtığınızda o servisin adımlarını görürsünüz.
Her Block'ta Bulunanlar
| Öğe | Neden önemli |
|---|---|
| Bir ad | Block'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 |
| Ayarlar | Doldurduğunuz alanlar. Tam ekran yapılandırma görünümünü açmak için block'a çift tıklayın veya üzerine gelince çıkan araç çubuğundan Open details'i kullanın |
| Ek alanlar | Daha az kullanılan ayarlar Show additional fields düğmesinin arkasındadır |
| Input ve Output | Yapılandırma görünümü solda gelen veriyi, sağda çıkan sonucu gösterir |
| Açık/kapalı durumu | Bir block'u silmeden kapatmak için Disable edebilirsiniz. Kapalı block'lar tuvalde soluk görünür |
Üzerine gelince çıkan araç çubuğunun tamamı, sağ tık menüleri ve klavye kısayolları için Toolbar sayfasına bakın.
Block'lar Veriyi Birbirine Nasıl Aktarır
Bir block 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ışmanın başladığı verideki bir alan |
<blockName.field> | Daha önceki bir block'un çıktısı — örneğin <agent.content> |
<variable.NAME> | Kendi tanımladığınız bir workflow değişkeni |
Çalışma 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ı Loglar bölümündeki adım bazlı Input ve Output görünümünde bulursunuz.
Tetikleyiciler (Triggers)
Tetikleyici giriş noktasıdır: çalışmanın nasıl başlayacağını ve hangi veriyle başlayacağını belirler. Her workflow'un en az bir tanesine ihtiyacı vardır.
| Block | Ne yapar | Önemli ayarlar | Size ne verir |
|---|---|---|---|
| Start | Manuel tetikleyici. Workflow'u editörden istediğiniz an çalıştırmak için ekleyin | Input tanımı — her biri Name ve Type içeren alanların listesi | input — çalışmanın başladığı veri. Bir alanı <input.NAME> ile okursunuz |
| API Trigger | Workflow'un dışarıdan gelen bir istekle başlamasını sağlar | Require authentication (varsayılan olarak açık) ve isteğe bağlı bir giriş şeması | body, headers, query |
| Webhook | Herhangi bir servisten veya API'den webhook alır | Sizin için oluşturulan URL ve imzalama gizli anahtarı, ayrıca bir Active / Paused anahtarı | body, headers, path, receivedAt, clientIp |
| Telegram Trigger | Telegram botunuza bir mesaj geldiğinde workflow'u başlatır | Bir Telegram bot bağlantısı. Block, bağlantı durumunu canlı olarak gösterir | message, sender, updateId, updateType |
| WhatsApp Trigger | WhatsApp Business numaranıza bir mesaj geldiğinde workflow'u başlatır | Meta uygulamanızın App ID'si ve App Secret'ı (bir bağlantı olarak) — ikisi de ayarlandığında ve workflow etkinken tetikleyici kendini Meta'ya kaydeder | message, sender, phoneNumberId, changeType |
| Slack Trigger | Slack uygulamanız bir olay aldığında workflow'u başlatır — bir mesaj, bir bahsetme (mention), bir tepki ve daha fazlası | Bir Slack Signing Secret bağlantısı. Block'u açmak, Slack'in kendi Event Subscriptions sayfasına yapıştıracağınız bir Request URL verir | message, sender, channel, eventType, teamId, eventId |
| Gmail Trigger | Bağlı bir Gmail gelen kutusuna yeni e-posta geldiğinde workflow'u başlatır | Bağlı bir Google hesabı, varsayılan olarak kapalı bir Include email body anahtarı ve isteğe bağlı bir arama filtresi | message, sender, provider |
| Outlook Trigger | Bağlı bir Outlook / Microsoft 365 gelen kutusuna yeni e-posta geldiğinde workflow'u başlatır | Bağlı bir Microsoft hesabı, varsayılan olarak kapalı bir Include email body anahtarı ve isteğe bağlı bir filtre | message, sender, provider |
| Chat Trigger | Sohbet giriş noktası — workflow'u bir konuşmadan başlatır | System prompt, Include chat history anahtarı | message, history |
Bir workflow tekrar eden bir zamanlamayla da başlatılabilir — bu bir block ile değil, Zamanlamalar sekmesinden kurulur.
:::info Anlık tetikleyiciler ve periyodik olarak kontrol edilenler Bu sayfadaki diğer tetikleyicilerin aksine, Gmail Trigger ve Outlook Trigger bir e-posta gelir gelmez tepki vermez — gelen kutusu yaklaşık dakikada bir kontrol edilir. Outlook Trigger ayrıca Microsoft'tan mümkün olduğunda erken haber alır, bu yüzden bazen daha hızlı tepki verir. :::
:::note Bir workflow'u sohbetten başlatma Chat Trigger içeren bir workflow, bir AI asistanıyla yaptığınız konuşmadan başlatılabilir. Asistan önce workflow adını ve girdilerini gösteren bir onay kartı sunar — siz onaylamadan hiçbir şey çalışmaz. Bunun için yönetici yetkisi gerekir. :::
:::caution Gelen veriyi güvenilmez kabul edin
Webhook, API Trigger, Telegram Trigger, WhatsApp Trigger, Slack Trigger, Gmail Trigger veya Outlook Trigger üzerinden gelen veri kuruluşunuzun dışından gelir. <input.…> değerlerini kontrol etmeden doğrudan bir AI istemine aktarırken dikkatli olun.
:::
Webhook URL'leri, imzalama gizli anahtarları ve Slack, WhatsApp, Gmail ve Outlook tetikleyicilerinin kurulum adımları için Workflow Çalıştırma sayfasına bakın.
AI Block'ları
Bunlar yapay zekâ ile içerik üreten, değerlendiren, arayan veya dönüştüren block'lardır.
:::info Modeller ve bağlantılar Agent, Router ve Evaluator block'larında varsayılanı Arketic AI olan bir Model açılır listesi vardır — bu seçenek hiçbir kurulum gerektirmez. Bunun yerine harici bir sağlayıcının modelini seçerseniz block sizden uygun bir bağlantı ister. Diğer AI block'ları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
| Block | Ne yapar | Önemli ayarlar | Size ne verir |
|---|---|---|---|
| Agent | Araç kullanabilen ve yapılandırılmış çıktı döndürebilen bir AI ajanı. Çoğu workflow'un asıl iş gücü | Messages, Model, bağlantı, Tools ve (ek alanların arkasında) Temperature (0–1, varsayılan 0,7), Max output tokens (varsayılan 2048) ve bir Response format şeması | content, model, tokens, toolCalls. Bir yanıt biçimi tanımlarsanız alanları <agent.field> ile okunur |
| Router | Durumu yapay zekâ ile okuyarak birkaç yoldan birini seçer | Model, bağlantı, Routing prompt, Routes | selectedRoute, rationale |
| Evaluator | Bir sonucu bir değerlendirme ölçütüne göre puanlar — bir sonuca göre hareket etmeden önce kalite kontrolü olarak kullanışlıdır | Model, bağlantı, Rubric, Target field (örneğin <agent.content>) | score, feedback |
| Knowledge | Kuruluşunuzun bilgi bankasında bir soruya en uygun bölümleri arar | Query, Top K (kaç sonuç getirileceği, 1–50, varsayılan 5), Scope — Organization-wide veya Department only | results, total |
Bu workflow için bilgi
Website Scraper ve Document, diğer tüm AI block'larından farklı çalışır: sonraki bir adımda okuduğunuz bir çıktı üretmezler. Bunun yerine, bir AI Agent block'unu, Agent'ın normal girdisinin yanındaki ikinci, ayrılmış bağlantı noktasına — teal renkli bir Knowledge portuna — bağlarsınız (ipucu için üzerine gelin: "Knowledge — connect a Website Scraper or a Document block"). Bu teal bağlantıya Knowledge cable (bilgi kablosu) denir. Veri taşımaz — yalnızca Agent'a "bundan yararlanarak cevap verebilirsin" der.
| Block | Ne yapar | Önemli ayarlar |
|---|---|---|
| Website Scraper | Bir web sitesini yalnızca bu workflow'a ait bir bilgi bankasına tarar | Website URL, Refresh — Daily (varsayılan), Hourly veya Manual only. Workflow etkinleştirildiği an ilk tarama başlar |
| Document | Bir dokümanı yalnızca bu workflow'a ait bir bilgi bankasına yükler | Yüklediğiniz dosya — PDF, Word (.doc/.docx), Markdown veya düz metin |
Bu iki block'un canvas'ta normal bir girdisi veya çıktısı yoktur — kabul ettikleri tek bağlantı, block'tan bir Agent'ın Knowledge portuna sürüklenen Knowledge cable'dır. Bu, kuruluşunuzun Bilgi Bankası'ndan farklıdır: burada eklediğiniz yalnızca bu tek workflow'a özeldir.
Görsel, video ve konuşma
| Block | Ne yapar | Önemli ayarlar | Size ne verir |
|---|---|---|---|
| Image Generator | Yazılı bir açıklamayı görsele dönüştürür | Bağlantı, Provider (OpenAI DALL·E 3 veya GPT Image 1), Prompt, Size, Count (1–4) | images, tokens |
| Video Generator | Yazılı bir açıklamayı videoya dönüştürür. Arka planda çalışır ve zaman alabilir | Bağlantı, Provider (Runway, Google Veo, Luma, MiniMax veya Fal.ai), Prompt ve isteğe bağlı Model, Duration, Aspect ratio, Resolution, Prompt optimizer | videoUrl, jobId, duration, tokens |
| Vision | Bir görsele bakar, onu açıklar veya hakkında sorulan soruları yanıtlar | Bağlantı, Model (OpenAI GPT-4o veya Claude Sonnet 4.6), Image URL, Prompt | description, tokens |
| Speech to Text | Bir ses dosyasını metne çevirir | Bağlantı, Audio URL, Language (Auto-detect, Türkçe veya English) | transcript, language |
| Text to Speech | Metni sesli olarak okur ve ses dosyası üretir | Bağlantı, Text, Voice (Alloy, Echo veya Nova), Speed | audioUrl, durationSeconds |
| ElevenLabs | ElevenLabs'in yapay zekâ sesleriyle metinden konuşma üretir | Bağlantı, Text, Voice ID, Model | Üretilen ses |
Arama ve belge yapay zekâsı
| Block | Ne yapar | Önemli ayarlar | Size ne verir |
|---|---|---|---|
| Serper | Serper üzerinden Google araması — web, haberler, yerler veya görseller | Bağlantı, Query, Search Type, Results | searchResults, searchType, raw |
| Perplexity Chat | Arama destekli sohbet: güncel web sonuçlarından yazılmış bir yanıt | Bağlantı, Model (Sonar, Sonar Pro, Sonar Deep Research veya Sonar Reasoning Pro), Prompt | content, model, tokens, citations |
| Perplexity Search | Perplexity dizininden sıralanmış web arama sonuçları | Bağlantı, Query ve filtreler | results, tokens |
| Linkup | Kaynak gösteren yanıtlar döndüren web araması | Bağlantı, Query, Depth (Standard veya Deep), Output Type (Sourced Answer veya Search Results) | data, query, depth, outputType |
| Mistral Parse | Bir belgeyi okur ve kullanılabilir metne dönüştürür | Bağlantı, ayrıca Hosted File URL, Upload URL veya bir File'dan biri ve bir Result Type (Markdown, Text veya JSON) | content, pages, pagesProcessed, model |
| HuggingFace | HuggingFace Inference Router üzerinden sohbet tamamlama | Bağlantı, Provider, Model, Prompt | provider, model, content, tokens, finishReason |
Logic Block'ları
Logic block'ları içerik üretmez — çalışmanın nereye gideceğine ve bir şeyin kaç kez olacağına karar verir.
| Block | Ne yapar | Önemli ayarlar | Size ne verir |
|---|---|---|---|
| Condition | Çalışmayı doğru/yanlış bir kontrole göre dallandırır; if, else-if ve else yolları vardır | Her dal için ifade | Seçilen dal devam eder, diğerleri durur |
| Function | Hiçbir block tam olarak ihtiyacınızı karşılamadığında kendi küçük kodunuzu çalıştırır | Language (JavaScript veya Python), Code, Timeout. Gelen veriye değişken olarak erişilir; döndürdüğünüz değer çıktı olur | Kodunuzun döndürdüğü değer |
| Wait | Çalışmayı belirli bir süre duraklatır | Milisaniye cinsinden Duration (0–3.600.000 — bir saate kadar) | Bir şey vermez; süre sonunda çalışma devam eder |
| For Loop | İçindeki adımları sabit sayıda tekrarlar | Iterations (1–1000) | index, results |
| While Loop | Bir koşul doğru kaldığı sürece tekrarlar | Condition, Max iterations (güvenlik sınırı) | Koşul yanlış olana veya sınıra ulaşılana kadar sürer |
| For Each | İçindeki adımları bir listedeki her öğe için bir kez tekrarlar | Items, Max iterations | item, index, results |
| Do-While Loop | Gövdeyi bir kez çalıştırır, ardından koşul sağlandığı sürece tekrarlar | Her turdan sonra kontrol edilen bir koşul | En az bir kez çalışır |
| Parallel | Birkaç dalı aynı anda çalıştırır ve sonuçları toplar | Mode — Count (N dal) veya Collection (öğe başına bir dal) — ayrıca Max concurrency (1–20) ve Fail fast | results, errors |
:::caution Döngülerinize her zaman sınır koyun While Loop ve Do-While Loop bir koşula dayanır ve hiçbir zaman yanlış olmayan bir koşul çalışmayı süresiz olarak sürdürür — Max iterations ayarı bu güvenlik sınırıdır. For Each block'unda da bir Max iterations ayarı bulunur; burada bu ayar beklenmedik ölçüde büyük bir listeye karşı koruma sağlar. :::
Data Block'ları
Data block'ları bilgiyi workflow'a alır, dışarı çıkarır ve adımlar arasında saklar.
| Block | Ne yapar | Önemli ayarlar | Size ne verir |
|---|---|---|---|
| API | Dışarıdaki bir servise istek gönderir | Method (GET, POST, PUT, PATCH, DELETE), URL, isteğe bağlı Authentication bağlantısı, Query params, Headers, Body, Timeout | status, body, headers |
| Response | Çıkış noktası — sonucu workflow'u çağırana (bir API veya sohbet tetikleyicisine) döndürür | Response data modu (Builder veya ham JSON), alanlar ya da gövde, bir HTTP status ve Headers | Çalışmanın o yolunu bitirir ve sonucu geri verir |
| Variables | Bir workflow değişkenini okur veya yazar; böylece bir değer adımlar arasında yaşamaya devam eder | Operation (Read veya Write), Variable name, Value | Okuduğunuz değer veya sakladığınız değer |
Tablo block'ları
Bunlar kendi tablolarınızı okur ve yazar — workflow'larınızın çalışmalar arasında sakladığı yapılandırılmış veriyi. Her birinde tabloyu bir kimlik yazarak değil, bir Table açılır listesinden seçersiniz.
| Block | Ne yapar | Önemli ayarlar |
|---|---|---|
| Table — Insert Row | Yeni bir satır ekler | Table, { columnName: value } biçiminde Row data |
| Table — Query Rows | Bir filtreye uyan satırları bulur | Table, Filter, Sort, Limit (1–1000, varsayılan 100), Offset |
| Table — Get Row | Belirli bir satırı getirir | Table, Row ID |
| Table — Update Row | Var olan bir satırı değiştirir | Table, Row ID, Row data |
Değerler sütunun tipiyle uyuşmalıdır ve arama anlam tabanlı değil, birebir filtre tabanlıdır. Tablo oluşturma, sütun tipleri ve filtre seçeneklerinin tamamı için Tablolar sayfasına bakın.
Workflow değişkenleri, panel başlığından veya tuvale sağ tıklayarak açılan Variables panelinde oluşturulur ve düzenlenir. Variables block'u ise çalışan bir workflow'un bu değişkenleri okuma ve yazma yoludur.
Arketic Block'ları
Bunlar zaten Arketic içinde bulunan şeyler üzerinde işlem yapar. Hiçbir bağlantı kurulumu gerektirmezler — doğrudan çalışırlar.
| Block | Ne yapar | Önemli ayarlar |
|---|---|---|
| Arketic LLM Chat | Bir ajan kurmadan doğrudan Arketic'in kendi yapay zekâsına soru sorar | Sistem istemi, kullanıcı istemi, sıcaklık |
| Arketic KB Search | Bir soruyu birebir kelimelerle değil anlamıyla eşleştirerek bilgi bankasındaki en uygun bölümleri bulur | Query, Top K, sonuçların isteğe bağlı olarak yeniden sıralanması |
| Arketic Document Search | Kuruluşunuzun belgelerinin metninde bir ifade arar | Query, Limit |
| Arketic Web Search | Arketic üzerinden web'de arama yapar | Query, Language, Category (General, News, Science veya Images), Limit |
| Arketic OCR | Bir görseldeki metni çıkarır | Image URL |
| Arketic Rerank | Bir sonuç listesini alır ve en alakalı olanları öne taşır | Query, Documents, Top K |
| Arketic Embedding | Metni, arama adımlarının karşılaştırabileceği sayısal bir forma dönüştürür — kendi eşleştirme mantığınızı kurarken kullanışlıdır | Dönüştürülecek metin |
| Arketic Trigger Blueprint | Workflow'dan bir Blueprint'i — bir insan sürecini — başlatır | Blueprint ID, Inputs, Execution mode (Fire and forget veya Wait for completion) |
| Arketic Send Notification | Kuruluşunuzdaki birine uygulama içi bildirim gönderir | Kime bildirileceği ve bildirimin içeriği |
| Arketic Task Create | Bir görev oluşturur | Title, ayrıca isteğe bağlı Description, Status, Priority, Department, Deadline, Parent ve Tags |
| Arketic Task Update | Var olan bir görevi günceller | Task ID ve değiştirilecek en az bir alan |
:::info Workflow kimin adına işlem yapar Bildirimler ve görevlerde, bir yönetici tarafından çalıştırılmayan workflow, onu çalıştıran kişinin adına işlem yapar — bildirimler o kişiye gider ve yeni görevler o kişiye atanır. Yönetici tarafından çalıştırılan workflow'lar başka kişileri hedefleyebilir. :::
İlgili sayfalar: Bilgi Bankası, Belgeler, Görevler, Blueprint'ler.
Entegrasyon Block'ları
Entegrasyon block'ları ekibinizin zaten kullandığı servislerin içinde işlem yapar — Slack mesajı göndermek, GitHub issue'su 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 |
|---|---|
| Operation | O serviste hangi işlemin yapılacağı. Örneğin Slack için: Send Message, Read Messages, List Channels, Add Reaction, Get Channel Info, Get User |
| Authentication | Block'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 |
Palette'te entegrasyonlar her servis için tek bir kartta toplanır. O servisin adımlarını görmek için karta tıklayın.
:::tip Önce hesabı bağlayın Bağlantıyı block'un Authentication alanından seçin. Orada henüz bir şey yoksa Bağlantılar sekmesinden ekleyin — OAuth 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ışma duraklar ve hangi servisi beklediğini size söyler. :::
Notlar
| Block | Ne yapar |
|---|---|
| Note | Doğrudan tuvalin üzerine yazılı bir açıklama ekler |
Notlar, workflow'unuzu 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ışmaya 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 Block'u Seçmek
| Şunu yapmak istiyorsanız… | Şunu kullanın |
|---|---|
| Kurarken workflow'u kendiniz çalıştırmak | Start |
| Başka bir sistemin başlatmasını sağlamak | Webhook veya API Trigger |
| Yapay zekânın bir şey yazması, sınıflandırması veya özetlemesi | Agent |
| Çalışmayı birkaç yoldan birine yönlendirmek | Condition (evet/hayır) veya Router (yapay zekânın seçtiği çok yollu) |
| Bir listedeki her öğe için bir şey yapmak | For Each veya hepsini aynı anda yapmak için Collection modunda Parallel |
| Kendi kurumsal bilginizden yanıt vermek | Knowledge veya Arketic KB Search |
| Bir Agent'ın tek bir web sitesinden veya dokümandan yanıt vermesini sağlamak | Website Scraper veya Document, Agent'ın Knowledge portuna bağlı |
| Bir değeri çalışmanın ilerisi için saklamak | Variables |
| Çalışmadan sonra da kalacak bir şey saklamak | Bir Table block'u |
| Sonucu çağırana geri döndürmek | Response |
| Bir yapay zekâ sonucuna göre hareket etmeden kalitesini kontrol etmek | Evaluator |