BotreamDokümanlar Web sitesi English v0.1.1

Sorun giderme ve SSS

Bu sayfada en sık karşılaşılan sorunları, Botream'in gösterdiği mesajlarla ve bu sorunlar için yapmanız gerekenlerle birlikte bulabilirsiniz. Neden açık değilse Günlükler nerede bulunur bölümüyle başlayın.

Ajanlar

Ajan çevrimdışı veya bağlanmıyor

Tepsi simgesinin araç ipucu ve ajan penceresi (tepsi simgesi → Open dashboard) bağlantı durumunu ve nedenini gösterir. Logs sekmesi (tepsi simgesi → View logs) her bağlantı denemesini gösterir.

Ajandaki mesaj Neden Çözüm
Cannot connect to <address> Sunucu adresi yanlış, BotreamServer hizmeti durdurulmuş veya bir güvenlik duvarı bağlantı noktasını engelliyor Tepsi uygulamasının Settings penceresindeki adresi denetleyin (Server address, örneğin http://rpa-server:3000). Aynı adresi ajan makinesindeki bir tarayıcıda açın.
Invalid agent credentials Kayıt belirteci yanlış Belirteci Administration → Agents → Install an agent bölümünden kopyalayın, tepsi uygulamasının Settings penceresindeki Registration token alanına yapıştırın ve Save and connect düğmesine tıklayın.
Another machine already uses the agent name '…' İki makine aynı Agent name değerini kullanıyor Tepsi uygulamasının Settings penceresinde başka bir ajan adı seçin.
Agent connections are disabled on this server Sunucuda yapılandırılmış bir kayıt belirteci yok Bir yönetici, sunucu yapılandırmasında AGENT_REGISTRATION_TOKEN değerini ayarlar.
This agent was rejected by an administrator / This agent has been deactivated Bir yönetici ajanı engellemiş Bir yönetici ajanı Administration → Agents altında yeniden etkinleştirir.

Son dördü gibi bir retten sonra ajan yalnızca dakikada bir yeniden dener; bu nedenle beklemek yerine nedeni giderin ve tepsi menüsünde Reconnect seçeneğine tıklayın. Ağ sorunları, bir dakikaya kadar artan aralıklarla otomatik olarak yeniden denenir.

İpucu: Kurulu bir ajanda ayarlar makineye aittir ve yalnızca bir yönetici bunları değiştirebilir. Settings penceresinde Change as administrator görünüyorsa onu kullanın.

Ajan bağlanıyor ancak hiçbir şey çalıştırmıyor ("Waiting for approval")

Require approval for new agents açık olduğunda (Administration → Settings, Agents), yeni bir ajan bir yöneticiyi bekler. Tepsi simgesi kehribar rengine döner ve "Waiting for administrator approval" mesajını gösterir. Bir yönetici Administration → Agents sayfasını açar, Waiting for approval olarak işaretlenmiş ajanı bulur ve Approve seçeneğini seçer. O zamana kadar ajanda hiçbir görev çalışmaz.

"No agent is online" veya "Several agents are online"

Bu mesajlar, kendi bilgisayarınızdaki ajana ihtiyaç duyan yakalamalardan, kayıtlardan ve AI Task Generator'dan gelir:

  • No agent is online: Bilgisayarınızda Botream Agent'ı başlatın (Başlat menüsü → Botream Agent) ve bağlı olduğunu denetleyin.
  • Several agents are online: choose the one on your computer: İletişim kutusunda kendi ajanınızı seçin.
  • Agent '…' is offline veya is not approved: Yukarıdaki bölümlere bakın.

Ajan tepside görünmüyor

BotreamAgent Windows hizmetinin çalıştığını denetleyin. Bu hizmet, tepsi uygulamasını oturum açmış kullanıcının masaüstünde başlatır. Bir kullanıcı bir iş istasyonunda tepsi uygulamasından çıkarsa, uygulama bir sonraki oturum açmaya kadar kapalı kalır; Başlat menüsünden (Botream Agent) yeniden başlatın. Gözetimsiz bir robotta otomatik olarak yeniden başlatılır.

Öğe yakalama ve kayıt

Web öğesi yakalama başlamıyor

Web yakalama ve kaydedicinin tarayıcı bölümü, aynı bilgisayardaki tepsi uygulamasına bağlı Botream Element Capture eklentisine ihtiyaç duyar. Tipik hata şudur: "The Botream Chrome extension is not connected to this agent. Install it and keep Chrome open, or open the page with a browser command first".

Şunları bu sırayla denetleyin:

  1. Tepsi uygulaması çalışıyor olmalıdır; yakalama yaptığınız bilgisayarda. Windows hizmeti tek başına yakalama yapamaz.
  2. Eklenti yüklü olmalıdır; Chrome veya Edge'de (chrome://extensions veya edge://extensions). Ajan yükleyicisi eklentiyi tarayıcı ilkesi aracılığıyla ekler; tarayıcılar bunu yalnızca etki alanına katılmış veya başka şekilde yönetilen makinelerde kabul eder. Diğer makinelerde eklentiyi elle yükleyin; bkz. Eklentiyi yükleme.
  3. Eklenti bağlı olmalıdır. Araç çubuğu simgesi, ajana ulaşamadığı sürece kırmızı bir ! gösterir ve açılır penceresi bağlantı durumunu gösterir. Bağlandığında ajanın Logs sekmesinde "Browser extension connected" mesajını görürsünüz.
  4. Eklentiyi yeniden yükleyin. Simge kırmızı kalırsa chrome://extensions sayfasında eklentinin yeniden yükleme düğmesine basın veya tarayıcıyı yeniden başlatın.

Ayrıca şunlara dikkat edin:

  • chrome:// sayfaları, Web Mağazası ve PDF görüntüleyici gibi tarayıcı sayfaları yakalanamaz.
  • iframe içindeki öğeler henüz yakalanamaz; iframe'in kendisi seçilir.
  • Bir yakalama, tıklamanız için 120 saniyeye kadar bekler. Esc, onayladığınızda yakalamayı iptal eder.

Masaüstü yakalama veya kayıt başlamıyor

Masaüstü yakalama, ekran alanı işaretleme ve kaydedicinin masaüstü bölümü tepsi uygulaması tarafından gösterilir. "Desktop capture needs the Botream Agent tray app (the Windows service has no desktop)" gibi mesajlar, tepsi uygulamasının o bilgisayarda çalışmadığı anlamına gelir. Ajanda bir görev çalışırken masaüstü kaydı da başlamaz.

Masaüstü otomasyonu Windows hizmeti altında başarısız oluyor

Windows, hizmetleri masaüstü olmayan ayrı bir oturumda (Session 0) çalıştırır: pencere, fare ve klavye yoktur. Botream'in görevleri BotreamAgent hizmetinde çalıştırmamasının nedeni budur. Hizmet yalnızca tepsi uygulamasını oturum açmış kullanıcının masaüstünde çalışır durumda tutar; görevleri ise tarayıcı ve masaüstü otomasyonunun çalıştığı tepsi uygulaması çalıştırır.

Bu nedenle masaüstü otomasyonu, oturum açılmış bir Windows oturumu gerektirir:

  • İş istasyonları: Görevler, biri oturum açmışken çalışır.
  • Zamanlanmış görevleri çalıştıran makineler: Ajanı Unattended robot olarak yükleyin. Windows bu durumda her başlangıçta otomatik olarak oturum açar ve ajan sürekli çalışır. Bkz. Ajan yükleme.
  • Uzak Masaüstü: Bir robot makinesinde Uzak Masaüstü penceresini kapattığınızda ajan, masaüstünün robotlar için kullanılabilir kalması amacıyla oturumu konsola geri taşır.

Ekran gerektiren komutlar, ekran olmadığında açık bir mesajla başarısız olur; örneğin "messagebox needs the Botream Agent tray app; the Windows service has no desktop to show dialogs on". Bkz. Masaüstü otomasyonu.

Bir seçici bozuldu

Sayfalar ve programlar değişir; dün bulunan bir öğe bugün bulunamayabilir. Botream'in üç güvenlik ağı vardır ve her biri çalıştırmanın günlüğünde iz bırakır:

Günlük uyarısı Ne oldu Ne yapmalı
Not found: … Using the fallback … instead; re-capture the element so the task stays reliable Ana konum belirleyici hiçbir şey bulamadı, bir yedek konum belirleyici buldu Öğeyi yeniden yakalayın
Not found: … Self-healed: used … instead (93 % similar); apply the suggestion in the editor so the task stays reliable Kendi kendini onarma en benzer öğeyi kullandı Düzenleyicide komut, öneriyi özellikler panelinde gösterir: Apply öğenin özelliklerini komuta yerleştirir, Dismiss öneriyi yok sayar
Self-healing: the most similar element, … is 72 % similar; 90 % is needed Hiçbir öğe yeterince benzer değildi, bu nedenle adım başarısız oldu Öğeyi yeniden yakalayın

Nereye bakmalı:

  • Selector health (Edit tasks yetkisi), yakın zamanda çalışan her öğe komutunu en kötüden başlayarak bir durumla listeler: Healed, Fallback, Drifting (bulundu, ancak öğe yakalandığından beri değişti: bozulmadan önce yeniden yakalayın) ve bozuk olanlar. Bir satır, düzenleyiciyi o komutta açar.
  • Başarısız çalıştırmanın sayfası, hata anındaki ekran görüntüsünü ve değişkenleri gösterir; yapay zeka hata analizi hatayı açıklayabilir.
  • Bir yönetici, günlük seçici sağlığı raporunun e-postayla gönderilmesini sağlayabilir (Administration → Settings altında, Notifications bölümünde Daily selector health report).

Kendi kendini onarma, Administration → Settings altında Self-healing bölümünde (Heal elements that are not found, Minimum similarity, Only suggest for clicks that cannot be undone) ve görev bazında Task details içinde Self-healing altında ayarlanır. Bkz. Öğeleri güvenilir şekilde bulma.

Yapay zeka özellikleri

Mesaj Neden ve çözüm
… is not set up: an administrator enters the API key under Administration → Settings → AI API base URL, API key veya Model boş. Bkz. Yapay zeka ayarları.
The AI service at <host> did not answer within <n> s. Free endpoints can queue requests for minutes: try a faster model or a longer timeout under Administration → Settings → AI. Model çok yavaştı. Timeout değerini artırın veya daha hızlı bir model seçin.
The AI service at <host> could not be reached Botream Server, API base URL içindeki adrese ulaşamıyor: adresi, DNS'i, proxy'yi ve güvenlik duvarını sunucu makinesinden denetleyin.
The AI service answered <status>: … Sağlayıcı isteği reddetti. Ardından sağlayıcının kendi mesajı gelir: genellikle yanlış bir anahtar (401), bilinmeyen bir model adı veya bir kota sınırı.
The model used the whole answer length (<n> tokens) for thinking before writing an answer. Raise "Maximum answer length" under Administration → Settings → AI. Bir "düşünen" modelin token'ları tükendi. Maximum answer length değerini artırın.
The answer was cut off at the maximum answer length (<n> tokens), so the code is incomplete. … AI Task Generator'ın ürettiği kod eksik. Maximum answer length değerini artırın veya görevin daha küçük bir bölümünü isteyin.
The ai command is turned off under Administration → Settings → AI Allow the ai command in tasks kapalı.
Agent '…' cannot explore: it needs the Botream Agent tray app of this version or later (the Windows service has no desktop) Keşif modu, seçilen ajanda güncel bir tepsi uygulaması gerektirir. Ajanı güncelleyin veya tepsi uygulamasını başlatın.
Agent '…' is already exploring; stop that first Her ajanda aynı anda yalnızca bir keşif çalışır.

Bkz. Yapay zeka özellikleri.

Zamanlanmış çalıştırmalar başlamıyor

  1. Zamanlayıcı çalışıyor mu? Zamanlayıcı, Botream Server içinde çalışır ve SQL Server gerektirir. Çalışamadığında Schedules sayfası "The scheduler is not working" mesajını gösterir. Administration → System health zamanlayıcının durumunu ve son hatayı gösterir. Veritabanına yeniden erişilebildiğinde kendiliğinden toparlanır.
  2. Son seferde ne oldu? Schedules sayfasının Last run sütunu son tetiklemenin sonucunu gösterir; mesajı görmek için fareyle üzerine gelin:
    • Skipped: Boş ajan yoktu, ajan çevrimdışıydı veya "The previous run is still going". Zamanlama bir sonraki zamanında yeniden dener.
    • Failed: Örneğin "The task has never been saved" (görevin genel sürümü yok: önce push edin, bkz. Sürümler) veya "The task has been deleted".
  3. Hedef ajan görevi çalıştırabilir mi? Ajan (veya ajan grubunun bir üyesi) çevrimiçi, onaylanmış ve meşgul olmayan durumda olmalıdır. Masaüstü işleri için oturum açılmış bir oturum gerekir: zamanlamaları çalıştıran makineleri Unattended robot olarak yükleyin.
  4. O sırada sunucu durdurulmuş muydu? Zamanlanan saatte sunucu çalışmıyorsa çalıştırma kaçırılır. If a run is missed altında bir zamanlama ya Skip it (varsayılan) ya da Run once when back (within 24 h) seçeneğini kullanır.

Bkz. Zamanlamalar.

Oturum açma

Bir kullanıcı parolasını unuttu

Bir yönetici Administration → Users sayfasını açar, kullanıcıyı düzenler ve bir New password girer. Parolanın değiştirilmesi, kullanıcının her yerdeki oturumunu kapatır. Botream parola sıfırlama e-postası göndermez.

Birçok denemeden sonra oturum açma reddediliyor

Oturum açma denemeleri hız sınırına tabidir (varsayılan olarak dakikada 10). Bir dakika bekleyip yeniden deneyin. Betikler için bkz. REST API.

Günlükler nerede bulunur

Ne Nerede
Bir çalıştırmanın günlüğü Executions → çalıştırma: düzey filtresi ve arama içeren canlı günlük. Hata ayıklama satırları yalnızca Keep debug log lines açıkken tutulur (Administration → Settings, Executions).
Bir çalıştırmanın neden başarısız olduğu Çalıştırmanın sayfası: hata, hata veren satır, ekran görüntüsü, değişkenler ve yapay zeka hata analizi
Ajan etkinliği (bağlantı, yakalamalar, kayıtlar) Tepsi simgesi → View logs. Copy satırları panoya kopyalar. Bu satırlar yalnızca tepsi uygulaması çalıştığı sürece tutulur.
Ajan hizmeti C:\ProgramData\Botream\logs\agent-service-*.log (günde bir dosya) ve Windows Olay Günlüğü'ndeki uyarılar (Application, kaynak "Botream Agent")
Ajanın kendi kendini güncellemeleri C:\ProgramData\Botream\logs\agent-update-<version>.log
Ajan ayarları C:\ProgramData\Botream\agent.json
Sunucu C:\ProgramData\Botream\Server (günlükler günlük olarak döndürülür ve 14 gün saklanır; yalnızca yöneticiler okuyabilir)
Kim neyi değiştirdi Administration → Audit log
Sunucu ve zamanlayıcı sağlığı Administration → System health

Uyarı: C:\ProgramData\Botream\Server\server.json, kasa parolalarını şifreleyen anahtar da dahil olmak üzere sunucunun gizli anahtarlarını içerir. Bu dosyayı asla bir destek talebiyle göndermeyin ve veritabanıyla birlikte yedeğini tutun. Bkz. Yükseltme ve yedekleme.

Botream 0.1.1 · Oluşturulma 2026-10-14