Skip to main content
Otomasyon oluşturmak için Komut dosyası çalıştır’ı kullanmanızı kesinlikle öneririz; bu özellik, aksi hâlde elle oluşturulması gerekecek eylemler dahil tüm eylem davranışlarını kapsayabilir. Gereksinimlerinizi sohbette AI’a açıklamanız yeterlidir.Lütfen unutmayın: eylemleri elle eklerseniz AI daha sonra bunları tanıyamaz veya değiştiremez.
Komut dosyası çalıştır eylemi, yerleşik eylemlerin karşılayamadığı mantığı işlemek için özel JavaScript yazmanızı sağlar. Güvenli bir korumalı alan ortamında verileri dönüştürebilir, harici API’leri çağırabilir, hesaplamalar yapabilir, koşullu dallanma uygulayabilir ve çok daha fazlasını gerçekleştirebilirsiniz. Komut dosyaları önceki adımlardaki verileri input nesnesi üzerinden alır ve sonuçları output.set() işleviyle sonraki adımlara aktarır.

Komut dosyası çalıştır ve yerleşik eylemler ne zaman kullanılmalı?

Genel olarak ihtiyaçlarınıza uyduklarında yerleşik eylemleri kullanın. Özel mantık, veri dönüştürme veya karmaşık API etkileşimi gerektiğinde Komut dosyası çalıştır’ı kullanın.

Ortam

Nasıl yapılandırılır?

  1. İş akışınıza bir Komut dosyası çalıştır eylemi ekleyin.
  2. Komut dosyası düzenleyicisi boş bir çalışma alanıyla açılır. JavaScript kodunuzu buraya yazın.
  3. Komut dosyanız önceki adımlardaki verileri input nesnesiyle okuyabilir (aşağıya bakın).
  4. Sonuçları sonraki adımlara aktarmak için output.set(key, value) kullanın.
  5. (İsteğe bağlı) Komut dosyanız harici kitaplıklar gerektiriyorsa yapılandırma paneline npm bağımlılıkları ekleyin.
  6. Komut dosyasını en son tetikleyici çalıştırmasındaki gerçek verilerle çalıştırmak için Test et’e tıklayın.
  7. Komut dosyanızın doğru çalıştığını doğrulamak için test çıktısını ve konsol günlüklerini denetleyin.
  8. Eylemi kaydedin.

Girdi verilerini okuma

input nesnesi, iş akışındaki önceki tüm adımların verilerini içerir. Her adım eylem kimliğiyle tanımlanır.

Girdi yapısı

Tetikleyici verilerini alma (kayıt alanları)

Kayıtları Getir adımındaki verileri alma

Diğer eylem çıktılarındaki verileri alma

Test sırasında girdi verilerinizin tam yapısını görmek için console.log(JSON.stringify(input, null, 2)) kullanın. Nelerin kullanılabilir olduğunu anlamanın en hızlı yolu budur.

Çıktı yazma

Verileri sonraki adımlarda kullanılabilir hâle getirmek için output.set(key, value) kullanın. Birden fazla anahtar ayarlayabilirsiniz.
Ayarladığınız her anahtar, sonraki adımların + değişken seçici üzerinden başvurabileceği ayrı bir değişken olur. Örneğin output.set("status", "success") çağrısı yaparsanız sonraki adım bu komut dosyasının çıktısındaki status değerine başvurabilir.

console.log ile hata ayıklama

Geliştirme sırasında verileri incelemek ve yürütme akışını izlemek için console.log() kullanın. Test et’e tıkladığınızda günlük çıktısı test panelinde görünür.
Konsol günlükleri yalnızca test sırasında görünür; üretim çalıştırma geçmişinde gösterilmez. Komut dosyanızı oluştururken bunları dilediğiniz kadar kullanabilirsiniz.

npm paket yönetimi

Komut dosyalarınızda npm paketlerini kullanabilirsiniz. Bağımlılıkları yapılandırma panelinde bildirin:
Ardından komut dosyanızda require() ile kullanın:
Mümkün olduğunda npm paketleri yerine yerleşik JavaScript özelliklerini tercih edin. Modern JavaScript; Array.map(), Array.filter(), Object.entries(), şablon dizeleri, yapı bozma ve daha birçok yerleşik yardımcı sunar. Yalnızca önemli bir fayda sağladıklarında npm paketleri ekleyin.

Yerleşik değişkenler

Güvenlik: AUTOMATION_TOKEN kapsamı

AUTOMATION_TOKEN her otomasyon çalıştırması için otomatik olarak oluşturulur. Otomasyonu oluşturan kişiyle aynı izinlere sahiptir ve kapsamı geçerli yürütmeyle sınırlıdır. Önemli noktalar:
  • Otomasyonu oluşturan kişinin erişebildiği tüm tablolara erişebilir.
  • Yalnızca komut dosyası yürütülürken geçerlidir (60 saniyelik zaman aşımı).
  • Bu belirteci harici sistemlere ifşa etmeyin; komut dosyanızın içinden Teable API’sini çağırmak için tasarlanmıştır.

Teable API’sini çağırma

Komut dosyasından AI çağırma

POST /api/automation/runtime/ai, Veritabanınızın AI modeline bir istem gönderir. Veritabanı otomasyon bağlamından alındığı için Veritabanı kimliği gerekmez. Gövde prompt değerini ve isteğe bağlı attachments, modelKey, temperature ve outputType değerlerini alır; yanıt { "message": ... } biçimindedir. Ekler, her çağrıda en fazla 10 adet olmak üzere { url, mimetype, name } öğeleridir; her biri 20 MB’tan küçük olmalı ve 30 saniye içinde indirilmelidir. Görüntüler, PDF’ler ve Office belgeleri desteklenir. Varsayılan sohbet modeli görüntüleri ve benzer ekleri okuyamayabilir; bu nedenle dosya gönderirken modelKey iletin. Her çağrı kredi tüketir.

Hata işleme

İş akışınızın hataları uygun şekilde ele alabilmesi için riskli işlemleri her zaman try/catch blokları içine alın:
Hata işleme olmadan başarısız bir fetch çağrısı veya beklenmeyen veri biçimi komut dosyasını durdurur ve sonraki adımlar çıktı alamaz.

Tam örnek: destek taleplerini işleme ve yönlendirme

İpuçları

  • console.log ile başlayın. Yeni bir komut dosyası oluştururken yapısını anlamak için önce input nesnesinin tamamını günlüğe kaydedin.
  • Komut dosyalarını tek konuya odaklayın. Birden fazla görevi tek komut dosyasına sıkıştırmak yerine tek bir işi iyi yapın. Gerekirse birden fazla Komut dosyası çalıştır eylemini zincirleyin.
  • 60 saniyelik zaman aşımını göz önünde bulundurun. Uzun süren işlemler (büyük veri işleme, çok sayıda sıralı API çağrısı) zaman aşımına uğrayabilir. Büyük görevleri daha küçük parçalara ayırın.
  • Gerçek verilerle test edin. Test paneli en son tetikleyici çalıştırmasındaki gerçek verileri kullanarak size gerçeğe uygun sonuçlar sunar.
  • Eksik verileri ele alın. Boş veya tanımsız olabilecek alanlar için varsayılan değerleri (|| işleci) kullanın.

İlgili konular

  • AI ile oluştur — özel kod gerektirmeyen, istem tabanlı AI görevleri için
  • HTTP isteği — komut dosyası gerektirmeyen basit API çağrıları için
Son değiştirilme tarihi 4 Eylül 2026