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?
- İş akışınıza bir Komut dosyası çalıştır eylemi ekleyin.
- Komut dosyası düzenleyicisi boş bir çalışma alanıyla açılır. JavaScript kodunuzu buraya yazın.
- Komut dosyanız önceki adımlardaki verileri
inputnesnesiyle okuyabilir (aşağıya bakın). - Sonuçları sonraki adımlara aktarmak için
output.set(key, value)kullanın. - (İsteğe bağlı) Komut dosyanız harici kitaplıklar gerektiriyorsa yapılandırma paneline npm bağımlılıkları ekleyin.
- Komut dosyasını en son tetikleyici çalıştırmasındaki gerçek verilerle çalıştırmak için Test et’e tıklayın.
- Komut dosyanızın doğru çalıştığını doğrulamak için test çıktısını ve konsol günlüklerini denetleyin.
- 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
Çıktı yazma
Verileri sonraki adımlarda kullanılabilir hâle getirmek içinoutput.set(key, value) kullanın. Birden fazla anahtar ayarlayabilirsiniz.
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çinconsole.log() kullanın. Test et’e tıkladığınızda günlük çıktısı test panelinde görünür.
npm paket yönetimi
Komut dosyalarınızda npm paketlerini kullanabilirsiniz. Bağımlılıkları yapılandırma panelinde bildirin:require() ile kullanın:
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: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
inputnesnesinin 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

