Ajanları kurun

Botream Agent, görevleri bir Windows makinesinde çalıştıran robottur; görev çalıştıran veya üzerinde görev oluşturduğunuz her makineye tek bir MSI ile kurarsınız.

#Gereksinimler

.NET kurmanız gerekmez: pakete dahildir.

#Ajan nasıl çalışır

Ajan iki bölümden oluşur:

Görevler tepsi uygulamasında çalışır, çünkü Windows hizmetleri masaüstü olmayan Session 0'da çalışır: bir hizmet pencereleri göremez ve kullanamaz; bu nedenle masaüstü otomasyonu, element yakalama ve kayıt, oturum açılmış bir oturum gerektirir. Aynısı AI Task Generator'ın tarayıcıdaki keşfi için de geçerlidir: bunu yalnızca tepsi uygulaması çalışan bir ajan yapabilir.

Pratikte bunun anlamı şudur:

• Bir makine yalnızca Windows'ta oturum açmış bir kullanıcı varken görev çalıştırır. Kesintisiz çalışması gereken robotlar için ajanı Unattended robot olarak kurun: Windows bu durumda her başlangıçta otomatik olarak oturum açar.
• Bir iş istasyonunda kullanıcı tepsi uygulamasından çıkarsa uygulama bir sonraki oturum açmaya kadar kapalı kalır. Başlat menüsündeki Botream Agent kısayoluyla da başlatılabilir. Robot makinelerinde her zaman yeniden başlatılır.

Her makine için, makinenin tüm kullanıcıları tarafından paylaşılan tek bir ajan kimliği vardır.

#Kurulum paketini ve bilgileri edinin

Yönetici olarak web uygulamasında Administration → Agents sayfasını açın ve Install an agent düğmesine tıklayın. İletişim kutusu şunları sunar:

1. Download the installer — bu sunucunun sunduğu Botream-Agent-<version>.msi.
2. Run it on the machine and enter — Server address ve Registration token (Show token düğmesine tıklayın).
3. Or install silently (software deployment) — Workstation veya Unattended robot için hazır bir msiexec komutu.

Uyarı: Web uygulamasını localhost olarak açtıysanız iletişim kutusundaki sunucu adresi de localhost olur. Diğer makineler bu adrese ulaşamaz: aynı portla sunucunun adını veya IP adresini kullanın.

#Ajan kurulum paketini çalıştırın

MSI dosyasını ajan makinesinde çalıştırın:

1. Welcome — Next düğmesine tıklayın.
2. Destination Folder — varsayılan C:\Program Files\Botream Agent.
3. Botream server
   • Server address: Web uygulamasının adresi, örneğin http://rpa-server:3000.
   • Registration token: Install an agent iletişim kutusundaki belirteç.
   • Test connection bağlantıyı dener; Next de bunu denetler.
4. This machine

   • Agent name: Bir görevin nerede çalışacağını seçerken web uygulamasında gösterilen ad.

   • Ajanın çalışma biçimi:

     Seçenek	Davranış	Kimin için
     Workstation	Ajan, Windows'ta oturum açmış biri varken çalışır.	Geliştirici ve kullanıcı bilgisayarları
     Unattended robot	Windows her başlangıçta otomatik olarak oturum açar ve ajan sürekli çalışır.	Zamanlanmış görevleri çalıştıran makineler

   • Install the Botream extension in Chrome and Edge: Web elementlerini yakalamak için gereklidir; işaretli bırakın. Bkz. Tarayıcı eklentisini kurun.

5. Automatic sign-in (yalnızca Unattended robot için)
   • Windows account: Yerel hesap için robot, etki alanı hesabı için COMPANY\robot. Tercihen yalnızca robotun kullandığı bir hesap.
   • Password: Hesap, kurulumdan önce Windows ile doğrulanır. Windows parolayı şifrelenmiş olarak (LSA gizli bilgisi olarak) saklar; parola bir dosyaya veya kayıt defterine yazılmaz.
6. Ready to install — Install, ardından Finish düğmesine tıklayın.

Kurulumdan sonra BotreamAgent hizmeti çalışır; ajan, oturum açmış kullanıcının masaüstünde (bildirim alanında) başlar ve sunucuya bağlanır. Robot makinelerinde otomatik oturum açmayı test etmek için Windows'u yeniden başlatın.

Uyarı: Bir robot makinesinin ekranına erişebilen herkes, robot hesabının masaüstüne ulaşır. Robot makinelerini kilitli bir yerde tutun veya yalnızca Uzak Masaüstü üzerinden kullanın. Bir Uzak Masaüstü oturumu sona erdiğinde ajan, masaüstünü konsola geri taşır.

#Sessiz kurulum

Yükseltilmiş bir komut isteminden:

msiexec /i Botream-Agent-<version>.msi /qn SERVER=http://rpa-server:3000 TOKEN=<token> [AGENTNAME=<name>]
        [MODE=robot ROBOTUSER=.\robot ROBOTPASSWORD=<password>] [EXTENSION=0]

#Ajanı onaylayın

Administration → Settings altında Require approval for new agents açıksa (Ajan ayarları), yeni bir makine bir yönetici onaylayana kadar bekler ve o zamana kadar üzerinde hiçbir görev çalışmaz.

• Tepsi simgesi Waiting for administrator approval gösterir ve Windows bununla ilgili bir bildirim görüntüler.
• Administration → Agents altında ajanın Waiting for approval etiketi vardır. Approve düğmesine tıklayın.

Bir ajanın işlemler menüsü ayrıca Reject (bağlantısını keser ve bundan sonra reddeder), Deactivate ve Activate seçeneklerini sunar. Bkz. Ajanlar.

#Bağlantıyı kontrol edin

Tepsi simgesinin rengi ve araç ipucu durumu gösterir:

Open dashboard, View logs, Settings, Reconnect ve Exit için simgeye sağ tıklayın. Gösterge paneli o anki görevi (Stop ile birlikte), ajanın adını, sunucuyu, makineyi, IP adresini, Windows sürümünü ve ajan sürümünü ve son çalıştırmaları gösterir.

Web uygulamasında Dashboard ve Administration → Agents, hangi ajanların çevrimiçi olduğunu gösterir.

#Sunucu adresini veya belirteci değiştirin

Tepsi simgesinden Settings öğesini açın. Ayarlar makineye aittir; bu nedenle standart bir kullanıcı bunları salt okunur görür ve düzenlemek için Change as administrator düğmesine tıklar. Server address, Agent name veya Registration token değerini değiştirin (saklanan belirteci korumak için belirteç kutusunu boş bırakın) ve Save and connect düğmesine tıklayın. Çalışan ajan yeniden başlatma gerektirmeden yeniden bağlanır.

#Ajan grupları

Administration → Agents → Groups altında ajanları gruplayabilirsiniz, örneğin "Finance robots". Bir grubu hedefleyen zamanlama, grubun boştaki ve çevrimiçi ilk üyesinde çalışır. Bkz. Ajanlar.

#Robot makinelerini hazır tutun

Bir zamanlama yalnızca açık, uyanık ve oturumu açık, ajanı bağlı bir makinede çalışır. Gözetimsiz bir robot makinesinde ajan, çalıştığı sürece makinenin uykuya geçmesini ve ekranın kilitlenmesini engeller, yeniden başlatmadan sonra (Windows güncellemeleri, elektrik kesintileri) oturumu kendisi açar ve kapatılan bir Uzak Masaüstü oturumunu konsola geri taşır. Yapamadığı şey, kapalı veya uykudaki bir makineyi başlatmaktır. Bunun için:

• Mümkünse robot makinelerini 7/24 açık tutun (en kolayı sanal makinelerdir) ve güç planını hiç uyumayacak ve hazırda beklemeyecek şekilde ayarlayın.
• Fiziksel makinelerde, elektrik geldiğinde makineyi başlatan ürün yazılımı (BIOS/UEFI) ayarını açın.
• Bir grup ilkesi boştaki oturumları kilitliyorsa robot hesabını bu ilkeden muaf tutun: kilitli bir masaüstü otomatikleştirilemez.
• Ya da zamanlamaların bir ajan beklemesine ve makineyi Wake-on-LAN ile uyandırmasına izin verin.

#Makineleri Wake-on-LAN ile uyandırma

Her ajan bağlandığında kablolu ağ kartlarını (MAC adresi ve ağı) bildirir. Sunucu bundan sonra makineyi uyandırabilir: bir zamanlamadan ya da elle Administration → Agents altından (satır menüsü → Wake (Wake-on-LAN), çevrimdışı ajanlar için). Paketler sunucudan ve aynı ağdaki en fazla iki çevrimiçi ajan üzerinden gönderilir; çünkü yönlendiriciler bu paketleri ağlar arasında nadiren geçirir.

Makinenin ihtiyaç duydukları:

Uyandırılan makine Windows'u başlatır; gözetimsiz bir robot makinesi oturumu kendisi açar ve ajanı birkaç dakika sonra bağlanır. Otomatik oturum açması olmayan bir iş istasyonu oturum açma ekranında bekler; bu yüzden biri oturum açana kadar ajanı bağlanmaz.

#Güncellemeler

Kurulu ajanlar, sunucu daha yeni bir ajan kurulum paketi sunduğunda ve çalışan bir görev olmadığında kendilerini günceller. Bkz. Yükseltme, yedekleme ve kaldırma.

#Dosyalar ve hizmet

#Sorun giderme