BotreamDokümanlar
Web sitesi English v0.1.1

Hızlı başlangıç

Bu adım adım kılavuz sizi yeni bir kurulumdan ilk tamamlanmış çalıştırmaya götürür: oturum açarsınız, bir ajanın çevrimiçi olduğunu kontrol edersiniz, küçük bir web görevi oluşturur, çalıştırır ve günlüğünü okursunuz.

Başlamadan önce

İhtiyacınız olanlar:

  • çalışan bir Botream Server ve bir yönetici veya geliştirici hesabı (Sunucuyu kurun),
  • üzerinde çalıştığınız bilgisayara kurulmuş ve sunucuya bağlı bir Botream Agent (Ajanları kurun),
  • o bilgisayardaki Chrome'da Botream Element Capture eklentisi (Tarayıcı eklentisini kurun).

İpucu: İlk görevinizi aynı bilgisayarda oluşturun ve çalıştırın. Element yakalama her zaman tarayıcınızın bulunduğu bilgisayardaki ajan üzerinden çalışır; bu örnekteki messagebox komutu da ajanın ekranında açılır.

1. Oturum açın

Web uygulamasını http://<server-name>:<port> adresinde açın (yöneticiniz başka bir port seçmediyse port 3000'dir), Username ve Password bilgilerinizi girin ve Sign in düğmesine tıklayın.

Dashboard (gösterge paneli) açılır. Agents online sayısı ve Agents kartı, şu anda hangi robotların bağlı olduğunu gösterir.

2. Ajanın çevrimiçi olduğunu kontrol edin

Ajan bilgisayarında Botream Agent simgesi bildirim alanında bulunur. Fareyle üzerine gelin: araç ipucunda Botream Agent · Connected yazmalıdır. Simgeye tıkladığınızda sunucuyu, ajan adını ve son çalıştırmaları gösteren ajan gösterge paneli açılır.

Araç ipucu / durum Ne yapmalısınız
Connected Hiçbir şey, hazırsınız.
Waiting for administrator approval Bir yönetici, ajanı Administration → Agents altında onaylar (Approve).
Refused: … Sunucu adresi veya kayıt belirteci yanlış ya da ajan reddedilmiş veya devre dışı bırakılmış. Bkz. Ajanları kurun.
Disconnected, retrying Sunucuya ulaşılamıyor. Adresi ve ağı kontrol edin.

Yöneticiler ayrıca her ajanı, durumunu ve sürümünü Administration → Agents altında görür.

3. Bir görev oluşturun

  1. Kenar çubuğunda Tasks öğesini açın.
  2. Local görünümünde kalın. Local, sizin kendi çalışma alanınızdır: yeni görevler burada başlar ve siz yayınlayana kadar başka kimse onları görmez. Public, zamanlamaların ve diğer kullanıcıların çalıştırdığı yayınlanmış sürümleri gösterir.
  3. İsterseniz soldan bir klasör seçin; görev o klasörde oluşturulur.
  4. New task düğmesine tıklayın, Blank task seçili kalsın, bir Name girin (örneğin Quick start) ve Create and open düğmesine tıklayın.

New task penceresi görevi hazır bir şablondan da başlatabilir (From a template) ya da Yapay Zekâ Görev Oluşturucu ile açabilir (Describe it to AI); aşağıdaki Şablonla başlayın bölümüne bakın.

Düzenleyici açılır. Araç çubuğu, görev adını Local · never pushed etiketiyle gösterir.

Düzenleyicide üç panel bulunur:

  • Sol: COMMANDS (Search commands içeren komut paleti) ve VARIABLES.
  • Orta: Görev, Blocks veya Code (metin olarak görev dili) biçiminde. Her iki görünüm de aynı görevi gösterir.
  • Sağ: Seçili komutun PROPERTIES paneli.

Düzenleyicinin yapabildiği her şey için bkz. Görev düzenleyicisi.

4. Komutları ekleyin

Görev bir web sayfası açar, başlığını okur, günlüğe yazar ve bir mesaj kutusunda gösterir.

Tarayıcıyı açın

  1. COMMANDS içinde browser araması yapın ve Browser öğesine tıklayın (veya göreve sürükleyin).
  2. PROPERTIES içinde Action değerini open, URL değerini https://example.com ve Output değerini page olarak ayarlayın.

Output değişkeni page, sonraki komutların bu tarayıcıya başvurma yoludur.

Başlığı Capture ile okuyun

  1. Bilgisayarınızda bir Chrome sekmesinde https://example.com adresini açın. Capture, elementi görevin açtığı tarayıcıda değil, kendi tarayıcınızda seçer.
  2. Bir Capture komutu ekleyin. Action değerini gettext, Browser değerini $page$ ve Output değerini heading olarak ayarlayın.
  3. Selector yanındaki Capture düğmesine tıklayın. İletişim kutusunda Switch to Chrome and click the element yazar.
  4. Chrome sekmesine geçin. Fareyi hareket ettirdikçe elementler vurgulanır; Example Domain başlığına tıklayın. Tıklama sayfaya ulaşmaz; Esc işlemi iptal eder.
  5. Düzenleyiciye döndüğünüzde, elementi bulmanın birden fazla yolu bulunduysa birini seçin (ilki Recommended olarak işaretlidir) ve Use selected düğmesine tıklayın.

Selector artık doldurulmuştur. Birden fazla ajan çevrimiçiyse, iletişim kutusu önce bu bilgisayardakini seçmenizi ister.

Not: Capture için bu bilgisayarda Botream Agent tepsi uygulaması ve Chrome'da Botream Element Capture eklentisi gerekir. İletişim kutusu bir sorun bildirirse bkz. Tarayıcı eklentisini kurun.

Sonucu günlüğe yazın ve gösterin

  1. Message değeri The heading is: $heading$ olan bir Log komutu ekleyin.
  2. Title değeri Quick start ve Message değeri The page heading is: $heading$ olan bir Message box komutu ekleyin.

Değişken eklemek için bir alana $ yazın veya alanın değişken düğmesini kullanın.

Aynı görev kod olarak

Görevi görev dilinde görmek için orta paneli Code görünümüne geçirin. Görevi blok blok oluşturmak yerine buraya yazabilir veya yapıştırabilirsiniz:

browser --action:open --url:"https://example.com" --output:page
capture --browser:$page$ --action:gettext --dompath:"//h1" --output:heading
log --message:"The heading is: $heading$"
messagebox --title:"Quick start" --message:"The page heading is: $heading$"

Sizin Selector değeriniz //h1 değerinden farklı olabilir: yakalama iletişim kutusunda ne seçtiyseniz odur. Dil, Görev dili sayfasında açıklanmıştır; her komut ve parametre komut başvurusunda yer alır, örneğin browser, capture, log ve messagebox.

5. Kaydedin

Save düğmesine tıklayın (veya Ctrl+S tuşlarına basın). Saved to your local copy mesajı kaydı onaylar.

Kaydetme yalnızca yerel kopyanıza yazar; sürüm oluşturmaz. Zorunlu bir alan boşken veya bir satırda hata varken araç çubuğu No problems yerine To complete veya Problems gösterir ve kaydetme engellenir. İlgili komuta gitmek için göstergeye tıklayın.

6. Çalıştırın

  1. Araç çubuğunda Run düğmesine tıklayın. Kaydedilmemiş değişiklikleriniz varken Run devre dışıdır: ajanlar kaydedilmiş yerel kopyayı çalıştırır.
  2. İletişim kutusunda Any available agent seçeneğini koruyun veya Agent altında ajanınızı seçin, ardından Run düğmesine tıklayın.

Görev çalışırken sayfada ajanın adı ve geçen süreyle birlikte Running Quick start gösterilir. Ajan bilgisayarında:

  • bir tarayıcı https://example.com adresini açar,
  • küçük bir ilerleme paneli o anki komutu gösterir,
  • mesaj kutusu görünür. Çalıştırma, siz OK düğmesine tıklayana kadar bekler; bu nedenle mesaj kutusuna geçip onaylayın.

Görev bittiğinde bir bildirim Quick start completed (veya hatayla birlikte failed) bilgisini verir. Çalışan karttaki Cancel, ajandaki görevi durdurur.

7. Çalıştırma günlüğünü okuyun

Görev çalışırken Watch the live log düğmesine tıklayın veya kenar çubuğunda Executions öğesini açıp çalıştırmaya tıklayın.

Çalıştırma sayfası ajanı, başlangıç zamanını, süreyi, çalıştırmayı kimin başlattığını, girdileri ve çıktıları, ardından da günlüğü gösterir. Günlüğü düzeye göre (Info +, Warnings, Errors, Debug) filtreleyin veya içinde arama yapın; Follow, bir çalıştırma canlıyken en yeni satırı görünür tutar. Log satırınız The heading is: Example Domain burada yer alır.

Bir çalıştırma başarısız olursa sayfa ayrıca hata veren satırı, ajanın ekranının bir ekran görüntüsünü ve o andaki değişkenleri gösterir. Bkz. Görevleri çalıştırma ve Hata ayıklama.

8. Görevi yayınlayın

Göreviniz yalnızca yerel çalışma alanınızda bulunur. Zamanlamaların ve diğer kullanıcıların çalıştırabilmesi için yayınlamak üzere:

  1. Düzenleyici araç çubuğunda Push düğmesine tıklayın.
  2. İsterseniz değişikliği What changed? altında açıklayın.
  3. Push as version 1 düğmesine tıklayın.

Görev, sürüm 1 olarak genel hale gelir. Daha sonra genel bir görevi değiştirmek için onu Pull ile çekersiniz (bu, görevi diğerlerine kilitler), yerel kopyanızı düzenleyip kaydedersiniz ve bir sonraki sürüm olarak yeniden yayınlarsınız. Bkz. Sürümler ve çalışma alanları.

Şablonla başlayın

Boş bir sayfadan başlamak zorunda değilsiniz. Botream şablonlarla gelir: sık yapılan işler için açıklamalı, eksiksiz görevler; sıfırdan kurmak yerine bunları kendinize uyarlarsınız.

Şablon Ne yapar
Save PDF attachments of unread e-mails Ekli okunmamış e-postaları okur (mail read), PDF dosyalarını bir klasöre kaydeder ve e-postaları okundu olarak işaretler.
Type Excel rows into a web form Bir sayfayı okur (excel readrange) ve her satır için bir web formunu doldurur.
Extract invoice fields from PDFs with AI Bir klasördeki her PDF'yi ai extract ile okur ve alanları bir Excel raporuna yazar.
Copy a web page table into Excel Bir HTML tablosunu okur (capture gettable) ve bir Excel dosyasına yazar.
Monthly sales summary from Excel Bir satış sayfasını okur, her satırın cirosunu bir formülle hesaplar (datatable addcolumn), bölge bazında toplar (groupby) ve özeti genel toplamla (aggregate) birlikte bir Excel raporuna yazar.
Collect search results from several pages into Excel Her arama sonucunu Veri çıkar sihirbazıyla (capture extract) sayfa sayfa okur ve bir Excel dosyasına yazar.
Process work queue items Bir iş kuyruğunun öğelerini teker teker alır; her birini bir try/catch içinde tamamlar ya da başarısız olarak işaretler.
Daily report e-mail about yesterday Dünün tarihini hesaplar (datetime), o günün rapor dosyalarını bulur ve bir özet e-postası gönderir.
Archive files older than N days Bir klasörde belirli bir gün sayısından beri değişmemiş dosyaları bir arşiv klasörüne taşır.
Ask for approval of a large amount Bir limitin üzerindeki ödemeyi onaylaması için Gelen kutusunda bir kişiye sorar (humantask).

Arayüz Türkçe olduğunda şablonların adları ve açıklamaları da Türkçe gösterilir; görev dili (komutlar ve comment satırları) İngilizce kalır.

Bir şablonu kullanmak için:

  1. Tasks sayfasında New task düğmesine tıklayıp From a template seçeneğini seçin ya da boş bir görevde Start from a template düğmesine tıklayın.
  2. Kartları kategoriye göre süzün (Email, Excel & data, Web, Documents & AI, Files, Work queues, Approvals) ve bir şablona tıklayın. Sağ tarafta To fill in before the first run listesi ve şablonun Blocks ya da Code önizlemesi görünür.
  3. Pencerede Create and open düğmesine tıklayın (ad ve açıklama şablondan doldurulur, değiştirebilirsiniz). Düzenleyicide Use template düğmesine tıklayın ya da karta çift tıklayın; komutlar boş görevin yerine geçer, Ctrl+Z onları geri alır.

Ardından şablonun ihtiyaç duyduklarını doldurun:

  • Girdiler: klasörler, dosyalar, adresler ve limitler, görevin başında örnek varsayılan değerlerle input bildirimleridir. Varsayılanları değiştirin ya da değerleri görevi çalıştırırken veya zamanlarken verin.
  • Hesaplar: posta blokları Mail kasasını ve Robot mailbox kimlik bilgisini kullanır. Her posta bloğunun özelliklerinde kendi kasanızı ve kimlik bilgilerinizi (bkz. Kasalar) ve sağlayıcınızın posta sunucusunu seçin.
  • Elementler: elementini sizin seçmeniz gereken her web adımının önünde CAPTURE THIS ile başlayan bir yorum bulunur. Altındaki adımı seçin ve özelliklerinde Capture düğmesine tıklayın: şablondaki seçici yalnızca bir örnektir.

Boş görev ayrıca Yapay Zekâ Görev Oluşturucu'yu açan Generate with AI düğmesini ve üç ipucu sunar: komutları paletten sürükleyin ya da Ctrl+K tuşlarına basın, elementleri Capture düğmesiyle yakalayın ve kesme noktalarıyla (F9) adım adım hata ayıklayın.

Sonraki adımlar

Botream 0.1.1 · Oluşturulma 2026-10-14