Veri ve metin

Bir değişkene metin, sayı, liste veya başka bir değişkenin değerini atar; sayaç başlatmak için.

Nasıl kullanılır?

1. Değişkene bir ad verin (ör. sonuc).
2. Değeri yazın: metin, sayı veya başka bir değişken.

Sonuç

${ad}: verdiğiniz değer. Sonraki adımlarda kullanılır.

İpucu. Tablo adresi gibi birçok adımda geçen değerleri akışın başında bir kez tanımlayın; değişince tek yerden düzeltirsiniz.

Uygulamalı deneme: Deneme 01 · Hazırlık: deneme dosyalarını indir, Deneme 02 · Veri ve metin, Deneme 03 · Döngüler, koşullar ve hata yakalama, Deneme 04 · Excel ve dosya işlemleri, Deneme 05 · PDF, e-Fatura ve Word belgeleri, Deneme 06 · Word'den PDF, Excel ve yazıcı, Deneme 07 · Web sayfasında form, tablo ve sekmeler, Deneme 09 · Kullanıcıya sor, pano ve komut, Deneme 10 · Masaüstü programı: Not Defteri, Deneme 11 · E-posta gönder, oku, işaretle ve mesaj kanalı, Deneme 12 · Veritabanı: sorgula ve güncelle, Deneme 14 · FTP / SFTP ile dosya gönder ve al, Deneme 15 · Yapay zekâ ve Telegram onayı

Matematik ve mantık ifadesi hesaplar: sayac + 1, round(tutar * 1.2, 2), adet > 0 and durum == 'Bekliyor'.

Nasıl kullanılır?

1. İfadeyi yazın: sayac + 1, round(tutar * 1.2, 2), adet > 0 and durum == 'Bekliyor'.
2. Değişkenleri adıyla veya ${row.tutar} biçiminde kullanın.

Sonuç

Hesabın sonucu: sayı, metin veya doğru/yanlış.

İpucu. Sayaç artırmak için çıktı adına aynı değişkeni yazın: sayac = sayac + 1.

Uygulamalı deneme: Deneme 02 · Veri ve metin, Deneme 03 · Döngüler, koşullar ve hata yakalama, Deneme 08 · Web servisi (API) ve TCMB kuru

Metni temizler, dönüştürür, parçalar veya içinden bilgi çıkarır.

Nasıl kullanılır?

1. Metin alanına işlenecek değeri verin (ör. ${mesaj}).
2. İşlemi seçin; altındaki alanlar buna göre değişir.

Sonuç

İşlenmiş metin (bölme işlemlerinde liste, 'İçeriyor mu?' gibi sorularda doğru/yanlış).

İpucu. OCR ile okunan sayıyı temizlemek için: Desenle değiştir (regex), desen [^0-9], yerine boş.

Uygulamalı deneme: Deneme 02 · Veri ve metin, Deneme 03 · Döngüler, koşullar ve hata yakalama

Bugünün tarihini alır, tarih biçimler, gün/ay ekler, iki tarih arasındaki farkı hesaplar; iş günü ekler ve sayar (hafta sonu ve resmi tatiller hariç), ay sonunu bulur.

Nasıl kullanılır?

1. İşlemi seçin: şimdi, biçimlendir, ekle/çıkar, fark, haftanın günü, iş günü işlemleri veya ay sonu.
2. Biçimi yazın: %d.%m.%Y → 02.10.2026, %H:%M → 14:30.

Sonuç

Biçimlenmiş tarih metni (farkta ve iş günü sayısında sayı, İş günü mü? işleminde doğru/yanlış).

İpucu. İş günü işlemleri Cumartesi, Pazar ve resmi tatilleri (Ramazan ve Kurban Bayramı dahil) atlar. İki tarih arası iş günü başlangıç gününü saymaz, bitiş gününü sayar: Cuma'dan sonraki Pazartesi'ye 1 iş günü. Dini bayram tarihleri 2024–2028 için yerleşiktir; sonraki yıllar için Ek tatil günleri'ne yazın.

Uygulamalı deneme: Deneme 02 · Veri ve metin

Listelerde sayma, öğe alma, filtreleme, sıralama, toplama ve birleştirme.

Nasıl kullanılır?

1. Listeyi verin (ör. ${sheet_rows}).
2. İşlemi seçin: say, ilk/son öğe, filtrele, sırala, topla, birleştir.

Sonuç

İşleme göre sayı, tek öğe veya yeni liste.

İpucu. Yalnız BEKLIYOR satırlarını almak için: Filtrele, alan adı durum, Eşittir, BEKLIYOR.

Uygulamalı deneme: Deneme 01 · Hazırlık: deneme dosyalarını indir, Deneme 02 · Veri ve metin, Deneme 03 · Döngüler, koşullar ve hata yakalama, Deneme 04 · Excel ve dosya işlemleri, Deneme 05 · PDF, e-Fatura ve Word belgeleri, Deneme 06 · Word'den PDF, Excel ve yazıcı, Deneme 07 · Web sayfasında form, tablo ve sekmeler, Deneme 11 · E-posta gönder, oku, işaretle ve mesaj kanalı, Deneme 12 · Veritabanı: sorgula ve güncelle, Deneme 13 · Google Sheets'e yaz ve oku

Bir değeri veya kaydı listeye ekler; liste yoksa oluşturur. Sonuçları toplayıp rapora yazmak için.

Nasıl kullanılır?

1. Liste adını yazın (ör. results).
2. Döngünün içinde her turda eklenecek değeri verin.

İpucu. Döngü bitince listeyi Excel / CSV'ye yaz veya Çalışma raporu ile dosyaya dökün.

Uygulamalı deneme: Deneme 02 · Veri ve metin, Deneme 03 · Döngüler, koşullar ve hata yakalama

Seçilen modele sınırlı veri gönderir; araç çalıştırmadan metin veya şemayla doğrulanan JSON döndürür.

Nasıl kullanılır?

1. Ajanlar bölümünde bir sağlayıcı bağlantısı oluşturun; bu adımda bağlantıyı seçin.
2. Talimatı ve gönderilecek girdiyi yazın. Yapılandırılmış karar gerekiyorsa JSON şemasını girin.
3. Sonucu kaydeden değişkeni Koşul adımında kullanın; örneğin ${ai_result.karar}.

Sonuç

Şema yoksa metin, şema varsa doğrulanmış JSON döner. Geçersiz yanıt sonuç değişkenine yazılmaz.

İpucu. Ajan lisansı gerekir. Bulut bağlantısında girdi sağlayıcıya gönderilir; hassas veri için yerel model seçin. Önizleme dış çağrı yapmaz; sonuç bilinmeyen kalır. Elle, zamanlayıcıyla veya otomasyonla başlayan akışlarda çalışır; ajanların araç olarak çalıştırdığı akışlara eklenemez (ajan metni zaten kendisi anlar).

Uygulamalı deneme: Deneme 15 · Yapay zekâ ve Telegram onayı

İki listeyi ortak bir alana göre eşleştirir: banka ekstresi ile muhasebe kayıtları, siparişler ile irsaliyeler, stok ile sayım. Eşleşenleri, tutarı farklı olanları ve yalnız bir listede kalanları ayırır.

Nasıl kullanılır?

1. Liste A ve Liste B'ye iki listeyi verin (ör. banka ekstresi ve muhasebe kayıtları için iki Excel / CSV oku adımının çıktısı).
2. Her listede iki satırı bağlayan anahtar alanı yazın (ör. Fatura No); adı ikisinde de aynıysa B'yi boş bırakın.
3. Tutarlar da tutmalıysa tutar alanlarını ve toleransı yazın.
4. Sonuçları Excel / CSV'ye yaz ile ayrı sayfalara yazın veya Her satır için ile işleyin.

Sonuç

${eslesme.eslesen}: eşleşen satırlar, iki listenin alanları A_ ve B_ ön ekiyle yan yana (A_Tutar, B_Tutar). ${eslesme.tutar_farkli}: anahtarı tutan ama tutarı farklı satırlar ve Fark alanı. ${eslesme.yalniz_a} / ${eslesme.yalniz_b}: karşılığı olmayan satırlar, olduğu gibi. ${eslesme.sayilar}: dört sayı; ${eslesme.tamam}: hepsi eşleştiyse doğru.

İpucu. Aynı anahtar bir listede birden çok kez geçiyorsa sırayla birebir eşleşir: A'daki ilk 1001, B'deki ilk 1001 ile; fazlası eşleşmeden kalır. Boş anahtar hiçbir satırla eşleşmez. Her liste en fazla 100.000 satır.

Uygulamalı deneme: Deneme 02 · Veri ve metin

Satırları bir veya birkaç alana göre gruplar; her grup için toplam, adet, ortalama, en küçük ve en büyük değeri hesaplar (Excel'deki özet tablo gibi). Sonuç gruba göre sıralı bir satır listesidir.

Nasıl kullanılır?

1. Listeyi verin (ör. ${rows}).
2. Gruplama alanını yazın (ör. Cari); birden fazlaysa virgülle (Cari, Ay).
3. Hesaplanacak alanı ve işlemi seçin (ör. Tutar → Toplam); en fazla üç alan.

Sonuç

Her grup için bir satır: gruplama alanları, Tutar_toplam gibi hesaplanan sütunlar ve gruptaki satır sayısı adet. Satırlar gruba göre (Türkçe alfabe sırasıyla) sıralanır.

İpucu. 1.234,56 gibi metin sayılar çevrilir; boş hücreler hesaba katılmaz. Sayı olmayan bir değer hangi satırda olduğu yazılarak akışı durdurur. Özeti Excel / CSV'ye yaz ile rapora dökün.

Uygulamalı deneme: Deneme 02 · Veri ve metin, Deneme 07 · Web sayfasında form, tablo ve sekmeler

T.C. kimlik no, vergi kimlik no ve IBAN'ı kontrol hanesiyle doğrular; tutarı 1.234,56 biçiminde yazar veya yazıyla yazar (fatura ve çek için).

Nasıl kullanılır?

1. İşlemi seçin: TCKN, VKN veya IBAN doğrulama, tutarı biçimlendirme ya da yazıyla yazma.
2. Değer alanına numarayı veya tutarı verin (ör. ${row.VKN}).
3. Doğrulamada geçersiz değer akışı durdursun mu, yoksa sonucu Koşul ile mi kontrol edeceksiniz, seçin.

Sonuç

Doğrulamada ${dogrulama.gecerli} (doğru/yanlış), ${dogrulama.deger} (boşlukları alınmış; IBAN dörtlü gruplarla: TR33 0006 …) ve ${dogrulama.neden} (geçersizse neden). Biçimlendirmede metin: 1.234,56 TL veya bin iki yüz otuz dört Türk lirası elli kuruş.

İpucu. Kontrol hanesi doğrulaması numaranın yazım hatasını yakalar; numaranın gerçekten birine ait olduğunu göstermez. Excel'in baştaki sıfırını sildiği VKN sayıları 10 haneye tamamlanır.

Uygulamalı deneme: Deneme 02 · Veri ve metin, Deneme 08 · Web servisi (API) ve TCMB kuru

Fatura, irsaliye, dekont veya kendi şemanızdaki bilgileri PDF ya da resimden alanlara ayırır. Metin bu bilgisayarda okunur; yapay zekâya dosyanın kendisi değil, yalnız metni gönderilir.

Nasıl kullanılır?

1. Ajanlar bölümünde bir sağlayıcı bağlantısı oluşturun; bu adımda bağlantıyı seçin.
2. Belgeyi seçin (e-posta eki için ${email.attachments[0].path}) ve belge türünü seçin.
3. Sonucu sonraki adımlarda kullanın: ${belge.fatura_no}, ${belge.genel_toplam}; kalemler için Her satır için adımına ${belge.kalemler} verin.

Sonuç

Seçilen türün alanlarıyla doğrulanmış kayıt. Belgede olmayan alan boş (null) gelir; tarihler 2026-10-29, tutarlar sayı olarak döner.

İpucu. Ajan lisansı gerekir. Belgenin metni bu bilgisayarda okunur (taranmış sayfalar OCR ile); sağlayıcıya dosya değil yalnız metin gider. Metin 32.000 baytı aşarsa Sayfalar alanını kullanın. Tutarsızsa onaya gönder açıkken sonuçta ${belge.kontrol.sorunlar}, ${belge.onaylandi} ve ${belge.duzeltildi} de olur; atlanan belgeyi döngüde Koşul (${belge.onaylandi}) ile geçin.

Uygulamalı deneme: Deneme 15 · Yapay zekâ ve Telegram onayı