AI komutları
ai 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. Giriş --input (metin veya herhangi bir değişken) ve/veya --file (PDF metni, bir metin dosyası veya görüntü okuyan modeller için bir resim) ile verilir.
Tüm türlerde geçerli parametreler
| Parametre | Değer | Varsayılan | Açıklama |
|---|---|---|---|
--input | herhangi bir değer | Modelin okuduğu: metin veya bir değişken (kayıtlar ve listeler JSON olarak gönderilir), ör. $mail.Body$ | |
--file | metin | Modelin okuduğu dosya: PDF (metni), .txt/.csv/.json/.xml/.html/.eml veya bir resim (.png, .jpg, .gif, .webp) Ajan makinesindeki bir dosya. | |
--instructions | metin | Ek yönlendirme, ör. "Tutarlar EUR cinsindendir; tarihler gün/ay/yıl biçimindedir" | |
--timeout | sayı | 120 | Saniye cinsinden zaman aşımı |
--retry | sayı | Yeniden deneme sayısı. Belirtilmezse ekran ve dosya komutları geçici bir sorundan (hâlâ yüklenen bir sayfa, örtülü bir öğe, kilitli bir dosya) sonra bir kez daha dener; 0 bunu kapatır | |
--retryinterval | sayı | 1 | Yeniden denemeler arasındaki saniye |
İşlemler (--action)
--action:ask
Giriş hakkında (veya giriş olmadan) bir soruyu düz metinle yanıtlar.
| Parametre | Değer | Varsayılan | Açıklama |
|---|---|---|---|
--prompt zorunlu | metin | Soru veya görev, ör. "Bu şikayeti iki cümleyle özetle" | |
--output zorunlu | değişken adı | Sonucu alan değişken |
--action:extract
Girişteki alanları bir kayda çıkarır, ör. --fields:"InvoiceNo, Date:date, Total:number, Lines:list". Türler: text (varsayılan), number, date, boolean, list. Girişte bulunmayan bir alan boş olur.
| Parametre | Değer | Varsayılan | Açıklama |
|---|---|---|---|
--fields zorunlu | metin | Virgülle ayrılmış alan adları, her biri isteğe bağlı olarak :text, :number, :date, :boolean veya :list ile | |
--output zorunlu | değişken adı | Sonucu alan değişken |
--action:classify
Girişin ait olduğu kategoriyi seçer; kayıtta Label (kategorilerden biri), Confidence (0 ile 1 arası) ve Reason bulunur.
| Parametre | Değer | Varsayılan | Açıklama |
|---|---|---|---|
--categories zorunlu | metin | Virgülle ayrılmış kategoriler, ör. Invoice, Complaint, Order, Other | |
--output zorunlu | değişken adı | Sonucu alan değişken |
Örnekler
ai --action:ask --prompt:"Summarize this complaint in two sentences" --input:$mail.Body$ --output:summary
ai --action:extract --file:"C:\In\invoice.pdf" --fields:"InvoiceNo, Date:date, Total:number, Lines:list" --instructions:"Amounts are in EUR" --output:invoice
ai --action:classify --input:$mail$ --categories:"Invoice, Complaint, Order, Other" --output:kind