Komut referansı

Görev dilinin 60 komutunun tamamı; editörün ve ajanın kullandığı tanımlardan üretilir. Söz dizimi için Görev dili sayfasına bakın.

Değişkenler

set — Bir değişken tanımlar veya günceller.
input — Bir görev giriş parametresi tanımlar.
output — Bir görev çıkış parametresi tanımlar.
variable — Tek komutta her tür için değişken işlemleri.
string — Bir metin değişkeni üzerinde metin işlemleri.
number — Bir sayı değişkeni üzerinde hesaplamalar.
boolean — Bir doğru/yanlış değişkeni üzerinde mantık işlemleri.
list — Bir liste değişkeniyle çalışır (dizin 0 ilk öğedir).
dictionary — Bir sözlük veya kayıt değişkeniyle çalışır (anahtarlar ve değerleri).
datetime — Tarih ve saatler: geçerli zaman, metinden tarih okuma, süre ekleme, farklar, parçalar ve biçimlendirme.
datatable — Bir veri tablosu değişkeniyle çalışır (adlandırılmış sütunlu satırlar; satır 0 ilk satırdır).

if — Bir koşul doğru olduğunda içindeki komutları çalıştırır.
switch — Değeri switch değerine eşit olan ilk case bölümünün komutlarını çalıştırır (metin olarak karşılaştırılır; 1 ve 1.0 gibi sayılar eşittir); hiçbir case eşleşmezse default bölümünü çalıştırır.

step — Komutları adlandırılmış bir adımda gruplar.
runtask — Başka bir görevi çağırır.
stoptask — Çalıştırmayı burada başarıyla bitirir: sonraki komutlar çalışmaz (finally bölümleri yine çalışır) ve çıktılar döndürülür.
pausetask — Çalıştırmayı biri devam ettirene kadar duraklatır: ajan makinesindeki ilerleme penceresinde Run, web uygulamasında çalıştırmanın sayfasında Resume veya resumetask.
resumetask — Başka bir görevin duraklatılmış çalıştırmalarını devam ettirir (pausetask ile, ilerleme penceresinde veya web uygulamasında duraklatılanlar).
queue — İş kuyrukları: bir görevin eklediği ve diğerlerinin yeniden denemelerle tek tek işlediği öğeler (faturalar, siparişler…).
humantask — Web uygulamasının Inbox sayfasında bir kişiye sorar: kontrol edilecek, düzeltilecek veya doldurulacak bir form (örneğin ai komutunun okuduğu bir fatura, PDF'inin yanında) ve Approve, Reject gibi düğmeler.

try — Hata yönetimi bloğu.
retry — İçindeki komutlardan biri başarısız olursa komutları toplam --times denemeye kadar yeniden çalıştırır; --until ile, komutlardan sonra bu koşul yanlış olduğu sürece de yeniden dener.
onerror — Görev hata yöneticisi: yalnızca hiçbir catch bölümünün yakalamadığı bir hata görevi başarısız kılmak üzereyken çalışır (hata ekran görüntüsü alındıktan sonra); hata --error değişkenindedir.
throw — Bir hata oluşturur: en yakın catch ele alır (--error değişkeni mesajı içerir), aksi halde görev başarısız olur.

delay — Çalışmayı belirli sayıda saniye veya milisaniye duraklatır.
wait — Bir şey olana kadar bekler: bir dosya oluşur, bir pencere kapanır, ekran değişir, bir element görünür… --timeout dolduğunda, --failontimeout:true değilse görev (bir uyarıyla) devam eder.

comment — Açıklayıcı yorum; çalıştırmaya hiçbir etkisi yoktur.
log — Bir günlük kaydı yazar.
logtofile — Ajan makinesindeki bir dosyaya bir satır metin yazar.
messagebox — Ajan makinesinde bir mesaj iletişim kutusu gösterir.
prompt — Ajan makinesinin başındaki kişiden bir değer ister: metin, parola, sayı, bir seçenek listesinden biri ya da bir dosya veya klasör.

window — Uygulama pencerelerini yönetir.
desktop — Windows UI Automation aracılığıyla masaüstü arayüz elementleriyle etkileşim kurar.
sendkeys — Bir pencereye metin ve özel tuşlar yazar.
mouse — Fareyle piksel konumlarında tıklar, hareket ettirir, sürükler ve kaydırır: elementleri yakalanamayan programlar için (uzak masaüstleri, çizimler).
screenshot — Ekranın, bir pencerenin veya bunların bir alanının resmini kaydeder, ör.
ocr — Windows'un yerleşik OCR özelliğiyle ekrandan veya bir resimden metin okur: elementlerin yakalanamadığı uygulamalar ve taramalar için (terminaller, Citrix, görüntüler).
image — Ekranda bir resmi (bir düğme, bir simge, bir logo) bulur ve ona tıklar ya da nerede olduğunu söyler: öğeleri yakalanamayan ekranlar için (Citrix ve uzak masaüstleri, canvas uygulamaları, oyunlar).
clipboard — Windows panosundaki metni okur ve yazar, ör.

sap — SAP GUI Scripting üzerinden SAP GUI for Windows: oturum açma, işlem çalıştırma, alan doldurma, düğmelere basma, tabloları ve durum çubuğunu okuma.

excel — Excel çalışma kitaplarını okur ve yazar: .xlsx dosyalarını doğrudan (Excel'in kurulu olması gerekmez) ya da --engine:excel ile kurulu bir Microsoft Excel üzerinden (Excel'in açtığı her biçim, makrolar, veri yenileme, PDF'e aktarma).
xml — XML belgelerini XPath ile okur ve düzenler.
json — JSON okur ve oluşturur, ör.
csv — CSV dosyalarını veri tablolarına okur ve veri tablolarını CSV olarak yazar.
pdf — PDF dosyalarının metnini okur ve sayfalarını birleştirir, böler veya ayıklar (PDF programı gerekmez).
database — Veritabanı sorguları çalıştırır; sonuçlar veri tablosu değişkenleri olarak saklanır.

file — Dosya işlemleri.
folder — Klasör işlemleri.
zip — Dosyaları ve klasörleri bir .zip dosyasına sıkıştırır, bir .zip dosyasını ayıklar ve içeriğini listeler.

mail — E-posta gönderir (SMTP) ve bir posta kutusuyla çalışır (IMAP): read mesajları kayıt olarak listeler; saveattachments, move, delete ve markread bu kayıtların Id değerini alır.
restapi — Bir HTTP isteği yapar; yanıt bir kayıt değişkeni olarak saklanır.

javascript — Hızlı hesaplamalar ve veri biçimlendirme için JavaScript çalıştırır.
run — Harici bir program, belge veya sistem komutu başlatır.
process — Çalışan programları denetler, listeler, bekler ve durdurur.

ai — Settings → AI içinde ayarlanan AI modeline sorar (yanıt Botream sunucusu üzerinden gelir, böylece anahtar robota hiç ulaşmaz): bir soruyu yanıtlar, bir belgeden veya e-postadan alanları çıkarır ya da bir metni kategorilere ayırır.