BotreamDokümanlar Web sitesi English v0.1.1

Ayarlar

Platform genelindeki yapılandırma tek bir sayfada, yalnızca yöneticilerin açabildiği Administration → Settings sayfasında bulunur; değişiklikler kaydettiğiniz anda uygulanır.

Ayarlar sayfasıyla çalışma

  • Ayarlar kartlar hâlinde gruplanmıştır: Directory (LDAP), Agents, Executions, Self-healing, Notifications, Mail (SMTP), AI ve Audit. Her ayar ne yaptığını ve değiştirildikten sonra kimin ne zaman değiştirdiğini gösterir.
  • Bölümler kapalı başlar: açmak veya kapatmak için bölümün başlığına tıklayın. Değişiklik içeren kapalı bir bölüm, kaç değişikliğin kaydedilmediğini gösterir.
  • İhtiyacınız olan kadar ayarı düzenleyin, ardından Save changes'e (veya Discard'a) tıklayın. Unsaved olarak işaretlenen ayarlar henüz kaydedilmemiştir. Her kayıt, nelerin değiştiğiyle birlikte denetim kaydına işlenir.
  • Hiç değiştirmediğiniz bir ayar, aşağıdaki başvuruda gösterilen varsayılan değerini kullanır. Robotlar ve sunucu ayarları her ihtiyaç duyduklarında okur; bu nedenle yeniden başlatılması gereken bir şey yoktur.

Gizli değerler

SMTP parolası, yapay zekâ API anahtarı ve dizin arama hesabının parolası şifrelenmiş olarak (AES-256-GCM) saklanır; bir daha asla gösterilmez ve API tarafından döndürülmez. Alan, bir değerin kayıtlı olduğunu gösterir; yazmak onu değiştirir, Clear onu kaldırır, boş bırakmak ise korur. Denetim kaydında değiştirilen bir gizli değer "(changed)" olarak görünür.

Sayfadaki eylemler

  • Send test email (Mail (SMTP)): kaydedilmiş posta ayarlarıyla, girdiğiniz bir adrese mesaj gönderir. Önce değişikliklerinizi kaydedin.
  • Test sign-in (Directory (LDAP)): kayıtlı ayarlarla bir dizin hesabını dener ve gruplarını ve alacağı rolleri gösterir (dizin grupları her rolde Administration → Roles altında belirlenir). Bkz. Dizin ile oturum açma.
  • Clean up now (Executions): birkaç saatte bir çalışan bir sonraki otomatik temizliği beklemek yerine saklama süresi ayarlarını hemen uygular.

İpucu: Kendi kendini onarma görev bazında da ayarlanabilir: görevin ayrıntılarını açın ve Self-healing altında seçim yapın. Kendi seçimi olmayan bir görev aşağıdaki ayarları izler. Bkz. Öğeleri güvenilir şekilde bulma.

Aşağıdaki başvuru, sunucunun bildiği ayarlardan, sınırları ve varsayılan değerleriyle birlikte oluşturulur.

Tüm ayarlar

Dizin (LDAP)

AyarDeğerVarsayılanAçıklama
Sign in with directory accounts
ldap.enabled
açık / kapalıkapalıKullanıcılar Active Directory (veya başka bir LDAP) kullanıcı adı ve parolalarıyla oturum açar. Botream hesapları ilk oturum açışta oluşturulur ve rolleri gruplarını izler (her rol, dizin gruplarını Yönetim → Roller altında listeler). Yerel hesaplar çalışmaya devam eder.
Directory server
ldap.url
metinldaps://sunucu:636 (şifreli, önerilen) veya ldap://sunucu:389. Boşlukla ayrılmış birden fazla sunucu verilebilir: birine ulaşılamazsa sonraki denenir.
Check the server certificate
ldap.tlsVerify
açık / kapalıaçıkldaps:// ile, sertifikasına bu makinenin güvenmediği sunucuları reddeder. Yalnızca kendinden imzalı sertifikalı bir test dizini için kapatın.
Search base
ldap.baseDn
metinKullanıcıların arandığı yer, ör. DC=company,DC=local veya OU=Staff,DC=company,DC=local.
Sign-in domain
ldap.domain
metinActive Directory: kullanıcıların oturum açtığı etki alanı, ör. company.local (ali, ali@company.local olarak oturum açar). Arama hesabıyla gerekmez.
Lookup account
ldap.bindUser
metinİsteğe bağlı: dizini okuyabilen bir hesap (DN'i veya kullanici@etkialani). Active Directory dışındaki dizinler için gereklidir; Active Directory'de kullanıcılar kendi hesaplarıyla aranır.
Lookup account password
ldap.bindPassword
gizli (şifrelenir, bir daha gösterilmez)Şifreli olarak saklanır; bir daha asla gösterilmez.
User name attribute
ldap.usernameAttribute
metinsAMAccountNameKullanıcıların oturum açtığı öznitelik: Active Directory için sAMAccountName, diğer dizinlerin çoğu için uid.

Ajanlar

AyarDeğerVarsayılanAçıklama
Require approval for new agents
agents.requireApproval
açık / kapalıkapalıİlk kez bağlanan ajanlar bir yönetici onaylayana kadar bekler. O zamana kadar üzerlerinde hiçbir görev çalışmaz.
Update agents automatically
agents.autoUpdate
açık / kapalıaçıkBu sunucu daha yeni bir ajan yükleyicisi sunduğunda (Administration → Agents → Install an agent), yüklü ajanlar hiçbir görev çalışmıyorken bunu kendileri indirip kurar.

Çalıştırmalar

AyarDeğerVarsayılanAçıklama
Keep debug log lines
executions.storeDebugLogs
açık / kapalıaçıkKapalıyken ajanların gönderdiği Debug satırları atılır (saklanmaz, akışa gönderilmez). Info, uyarılar ve hatalar her zaman tutulur.
Keep execution history for
executions.retentionDays
0 – 3650 days90Bundan daha eski tamamlanmış çalıştırmalar ve günlükleri otomatik olarak silinir. 0 bunları sonsuza kadar tutar.

Self-healing

AyarDeğerVarsayılanAçıklama
Heal elements that are not found
healing.enabled
açık / kapalıaçıkBir web veya masaüstü elementi seçicisiyle ya da yedekleriyle bulunamadığında, ajan en benzer elementi arar (yakalama sırasında kaydedilen nesne özelliklerine göre) ve yeterince benzerse onu kullanır. Her iyileştirme günlüğe yazılır ve düzenleyicide önerilir.
Minimum similarity
healing.threshold
50 – 100 %90Bir elementin yerine kullanılabilmesi için yakalanan elemente ne kadar benzemesi gerektiği. Bunun altında adım, mesajında en iyi puanla birlikte başarısız olur.
Only suggest for clicks that cannot be undone
healing.protectRiskyClicks
açık / kapalıaçıkDelete, Remove, Send, Submit, Approve, Confirm, Pay, Transfer… (ayrıca Sil, Gönder, Onayla, Öde…) etiketli bir element üzerindeki tıklama, çift tıklama veya gönderme asla iyileştirilmez: en benzer element yalnızca önerilir ve adım başarısız olur.
Report elements changed below
healing.driftWarning
50 – 100 %95Seçici sağlığı: bulunan ancak yakalanan elemente bundan daha az benzeyen bir element, seçicisi bozulmadan önce kayma (drifting) olarak raporlanır. Görünür metin ve değerler karşılaştırılmaz (bunlar veridir).

Bildirimler

AyarDeğerVarsayılanAçıklama
Email when a scheduled run fails
notifications.scheduleFailureEmails
metin (virgülle ayrılmış e-posta adresleri)Bir zamanlamanın başlattığı çalıştırma her başarısız olduğunda e-posta alan, virgülle ayrılmış adresler. Aşağıdaki posta ayarlarını gerektirir.
Daily selector health report
notifications.selectorHealthEmails
metin (virgülle ayrılmış e-posta adresleri)Bozuk, iyileştirilmiş, bir yedekle bulunmuş veya kayan seçicileri listeleyen günlük e-postayı alan, virgülle ayrılmış adresler (yalnızca böyle seçiciler varsa gönderilir). Aşağıdaki posta ayarlarını gerektirir.
Send the selector health report at
notifications.selectorHealthHour
0 – 23 h6Son 24 saati kapsayan günlük raporun gönderildiği saat (sunucu saati, 0–23).

Posta (SMTP)

AyarDeğerVarsayılanAçıklama
SMTP server
smtp.host
metinPlatformun bildirimleri gönderdiği posta sunucusunun ana bilgisayar adı.
Port
smtp.port
1 – 65535587Genellikle 587 (STARTTLS) veya 465 (TLS).
Use TLS from the start
smtp.secure
açık / kapalıkapalı465 numaralı port için açık. Kapalıyken sunucu sunuyorsa STARTTLS kullanılır.
Username
smtp.username
metinSunucu kimlik doğrulama gerektirmiyorsa boş bırakın.
Password
smtp.password
gizli (şifrelenir, bir daha gösterilmez)Şifreli olarak saklanır; bir daha asla gösterilmez.
Sender address
smtp.from
metinBildirim e-postalarının From (gönderen) adresi.

AI

AyarDeğerVarsayılanAçıklama
API base URL
ai.baseUrl
metinhttps://integrate.api.nvidia.com/v1OpenAI uyumlu bir chat completions API'si, ör. NVIDIA build (https://integrate.api.nvidia.com/v1) veya OpenAI (https://api.openai.com/v1).
API key
ai.apiKey
gizli (şifrelenir, bir daha gösterilmez)Şifreli olarak saklanır; bir daha asla gösterilmez. Düzenleyicideki AI Task Generator için gereklidir.
Model
ai.model
metinnvidia/nemotron-3-super-120b-a12bSağlayıcının yazdığı şekliyle model adı. NVIDIA build üzerinde nvidia/nemotron-3-super-120b-a12b saniyeler içinde yanıt verir; bazı modeller (ör. z-ai/glm-5.3) istekleri birkaç dakika kuyrukta bekletir.
Send failure screenshots to the model
ai.sendScreenshots
açık / kapalıkapalıHata analizi, çalıştırma başarısız olduğunda alınan ekran görüntüsünü de gönderir (görüntü okuyan bir model gerektirir). Ekranlar kişisel veriler gösterebilir: model kendi sunucularınızda çalışmıyorsa kapalı bırakın.
Show the page to the model while exploring
ai.exploreScreenshots
açık / kapalıaçıkAI Görev Üreticisi her adımda tarayıcının, üzerine element numaraları çizilmiş bir resmini de gönderir. Resim okuyabilen modeller (ör. GPT-4o, Llama 3.2 Vision, Qwen-VL) sayfayı böylece çok daha iyi tanır; diğer modellerle keşif kendiliğinden resimsiz devam eder.
Allow the ai command in tasks
ai.taskCommands
açık / kapalıaçıkGörevler ai komutuyla (ask, extract, classify) modele metin, belge ve resim gönderebilir. Her çağrı denetim günlüğünde yer alır. Görev verilerinin modele ulaşmaması gerekiyorsa kapatın.
Timeout
ai.timeoutSeconds
30 – 1800 seconds600Tek bir yanıt için ne kadar bekleneceği. Yoğun ücretsiz uç noktaların yanıt vermeye başlaması dakikalar sürebilir.
Maximum answer length
ai.maxTokens
256 – 65536 tokens16384Modelin bir görev için üretebileceği token üst sınırı. Düşünen modeller bunun bir kısmını koddan önce akıl yürütmeye harcar, bu yüzden geniş tutun.

Denetim

AyarDeğerVarsayılanAçıklama
Keep audit log for
audit.retentionDays
0 – 3650 days0Bundan daha eski denetim kayıtları otomatik olarak silinir. 0 bunları sonsuza kadar tutar; aksi halde en az 30 gün.
Botream 0.1.1 · Oluşturulma 2026-10-14