VirtualLab
AI Research Agents
Používateľská príručka
Apríl 2026
VirtualLab je nástroj pre kolaboratívny vedecký výskum pomocou AI agentov. Táto príručka
vás prevedie inštaláciou, registráciou a používaním aplikácie.
Jakub Balog • Fakulta informatiky, Masarykova univerzita
Obsah
1 Predpoklady a inštalácia 2
1.1 Systémové požiadavky 2
1.2 Získanie A P I tokenu e-INFRA CZ 2
1.3 Stiahnutie a inštalácia CLI 2
2 Registrácia a prihlásenie 4
2.1 Registrácia nového používateľa 4
2.2 Prihlásenie existujúceho používateľa 4
2.3 Automatické prihlásenie 4
2.4 Odhlásenie 4
3 Správa laboratórií 5
3.1 Vytvorenie laboratória 5
3.2 Výber existujúceho laboratória 5
4 Správa agentov 6
4.1 Pridanie PI agenta 6
4.2 Návrh tímu agentom PI 6
4.3 Manuálne pridanie agenta 6
4.4 Pridanie agentov z JSON 7
4.5 Zobrazenie agentov 7
5 Stretnutia 8
5.1 Individuálne stretnutie 8
5.2 Tímové stretnutie 8
5.3 Priebeh stretnutia 8
5.4 História stretnutí 9
6 Správa účtu 10
6.1 Aktualizácia A P I tokenu 10
7 Prehľad hlavného menu 10
VirtualLab — Používateľská príručka Strana 1
Predpoklady a inštalácia
S y s t é m o v é p o ž i a d a v k y
Pre používanie VirtualLab potrebujete:
• Python 3.10 alebo novší — stiahnuteľný z https://www.python.org/downloads/
• Prístup k internetu — CLI komunikuje s backendom bežiacim na platforme CERIT-SC
• API token e-INFRA C Z — pre prístup k jazykovým modelom (postup nižšie)
Tip: Pri inštalácii Pythonu na Windows nezabudnite zaškrtnúť možnosť Add Python to PATH.
Získanie A P I tokenu e - I N F R A C Z
Každý používateľ potrebuje vlastný A P I token pre prístup k jazykovým modelom prevádzkovaným
na infrastruktuře e-INFRA CZ. Token získate nasledovne:
1. Otvorte webovú stránku https://chat.ai.e-infra.cz
2. Prihláste sa pomocou svojho účtu MetaCentrum (e-INFRA CZ AAI)
3. Po prihlásení kliknite na svoje meno v pravom hornom rohu
4. Vyberte položku Settings (Nastavenia)
5. V sekcii Account nájdite položku API Keys
6. Kliknite na Create new secret key
7. Skopírujte vygenerovaný kľúč — zobrazí sa iba raz!
Pozor: Token si bezpečne uložte. Ak ho stratíte, budete musieť vygenerovať nový.
Ak ešte nemáte účet MetaCentrum, zaregistrujte sa na adrese https://metavo .metacentrum.
cz/en/application/f orm. Registrácia je bezplatná pre členov českých a slovenských akademických
inštitúcií.
Stiahnutie a inštalácia C L I
Klientská aplikácia (CLI) je jediná časť, ktorú potrebujete nainštalovať. Backend beží centrálne
na platforme CERIT-SC.
Krok 1: Stiahnite adresár cli/ z repozitára projektu.
Krok 2: Nainštalujte závislosti:
cd c l i
pip i n s t a l l -r requirements.txt
Krok 3: Spustite aplikáciu:
python -m cli.main
VirtualLab — Používateľská príručka Strana 2
Tip: Aplikácia sa automaticky pripája na server VirtualLab. Nie je potrebné nastavovať žiadne
premenné prostredia.
VirtualLab — Používateľská príručka Strana 3
Registrácia a prihlásenie
Pri prvom spustení aplikácie sa zobrazí úvodné menu s možnosťou registrácie alebo prihlásenia.
Registrácia n o v é h o p o u ž í v a t e ľ a
V úvodnom menu zvoľte možnosť 1. Register:
1. Zadajte používateľské meno (unikátne)
2. Zadajte heslo (minimálne 4 znaky)
3. Potvrďte heslo
4. Zadajte váš A P I token e-INFRA CZ (získaný v kroku 1.2)
Príklad:
=== REGISTRATION ===
Username: jakub
Password: ****
Confirm password: ****
You need an e-INFRA CZ API token to use LLM models.
Get yours a t : h t t p s : / / c h a t . a i . e - i n f r a . c z
e-INFRA API token: sk-abc123...
R e g i s t r a t i o n s u c c e s s f u l ! Welcome, jakub.
Pri registrácii sa overí platnosť API tokenu volaním na server e-INFRA CZ. Ak je token neplatný
registrácia sa neuskutoční.
Prihlásenie e x i s t u j ú c e h o p o u ž í v a t e ľ a
Ak už máte účet, v úvodnom menu zvoľte možnosť 2. Login a zadajte svoje používateľské meno
a heslo.
A u t o m a t i c k é prihlásenie
Po úspešnom prihlásení sa token relácie uloží lokálne. Pri ďalšom spustení sa aplikácia automaticky
prihlási bez nutnosti zadávať heslo. Ak je token neplatný (napríklad po prihlásení na inom
počítači), budete vyzvaní na opätovné prihlásenie.
Odhlásenie
V hlavnom menu zvoľte možnosť 12. Logout. Tým sa vymažú lokálne uložené prihlasovacie
údaje aj stav posledného laboratória. Na tom istom počítači sa následne môže prihlásiť iný
používateľ.
VirtualLab — Používateľská príručka Strana 4
Správa laboratórií
Laboratórium je základná organizačná jednotka v aplikácii VirtualLab. Obsahuje agentov a stretnutia.
Každý používateľ vidí iba svoje laboratóriá.
Vytvorenie laboratória
V hlavnom menu zvoľte možnosť 1. Create new lab:
1. Zadajte názov laboratória (musí byť unikátny)
2. Zadajte popis laboratória (nepovinný)
Príklad:
Enter lab name:
>>> Nanobody Research Lab
Enter lab d e s c r i p t i o n :
>>> Research on SARS-CoV-2 nanobodies
Lab created! ID: 680da71e3d4dbd456f9e760c
V ý b e r e x i s t u j ú c e h o laboratória
V hlavnom menu zvoľte možnosť 2. Select existing lab. Zobrazí sa zoznam vašich laboratórií.
Zadajte číslo požadovaného laboratória.
Available labs:
0. Nanobody Research Lab - Research on SARS-CoV-2 nan...
1. ML Experiments - Machine learning experiments
Select lab number: 0
Selected l a b : 'Nanobody Research Lab'
VirtualLab — Používateľská príručka Strana 5
Správa agentov
Agenti sú AI účastníci výskumných stretnutí. Každý agent má definovanú odbornosť, cieľ a rolu.
Existujú tri typy agentov:
• Principal Investigator (PI) — vedie diskusiu, syntetizuje vstupy, formuluje závery
• Špecialista — agent s odbornosťou v konkrétnej oblasti
• Vedecký kritik — hodnotí návrhy a požaduje zlepšenia (pridávaný automaticky)
Pridanie PI agenta
Každé laboratórium potrebuje agenta PI. V hlavnom menu zvoľte možnosť 3. Setup PI agent.
PI sa pridá automaticky s preddefinovanými atribútmi.
Pozor: PI je potrebné pridať pred vytváraním tímových stretnutí a pred návrhom tímu.
N á v r h t í m u agentom PI
PI agent dokáže navrhnúť vhodné zloženie výskumného tímu na základe popisu výskumného
problému. V hlavnom menu zvoľte možnosť 4. Ask PI to suggest team:
1. Popíšte výskumný problém
2. Počkajte na odpoveď PI (môže trvať 30-60 sekúnd)
3. PI vráti návrh agentov vo formáte JSON
4. Tento JSON môžete priamo použiť v možnosti 6 (pridanie z JSON)
Príklad:
Describe the research problem:
>>> Design nanobodies that bind to SARS-CoV-2
spike p r o t e i n variants JN.1 and KP.3
PI i s thinking about the team...
Suggested agents:
[
{ " t i t l e " : "Computational B i o l o g i s t " , ...},
{ " t i t l e " : "Immunologist", ...},
{ " t i t l e " : "ML S p e c i a l i s t " , ...}
]
M a n u á l n e pridanie agenta
V hlavnom menu zvoľte možnosť 5. Add agent manually. Postupne zadáte:
• Title — názov agenta (napr. Immunologist)
• Expertise — oblasť odbornosti
VirtualLab — Používateľská príručka Strana 6
• Goal — cieľ agenta v rámci výskumu
• Role — úloha agenta v tíme
• Tools — výber nástrojov z číslovaného zoznamu
Dostupné nástroje:
• pubmed search — vyhľadávanie vedeckých článkov v databáze PubMed Central
Pridanie agentov z J S O N
V hlavnom menu zvoľte možnosť 6. Add agent (s) as JSON. Vložte JSON reťazec obsahujúci
definíciu jedného alebo viacerých agentov. Táto možnosť je obzvlášť užitočná po použití funkcie
návrhu tímu (4.2), kedy stačí skopírovať a vložiť výstup od PI.
Zobrazenie agentov
V hlavnom menu zvoľte možnosť 7. List agents in lab pre zobrazenie všetkých agentov v aktuálnom
laboratóriu vrátane ich atribútov a pridelených nástrojov.
VirtualLab — Používateľská príručka Strana 7
Stretnutia
Stretnutia sú jadrom aplikácie VirtualLab. Počas stretnutia AI agenti diskutujú o výskumnom
probléme a spoločne formulujú riešenia.
I n d i v i d u á l n e stretnutie
V individuálnom stretnutí jeden špecializovaný agent pracuje na úlohe, pričom vedecký kritik
hodnotí jeho odpovede a požaduje zlepšenia. V hlavnom menu zvoľte možnosť 8. Create individual
meeting.
Postup:
1. Vyberte jedného špecialistu zo zoznamu agentov
2. Zadajte agendu stretnutia (výskumný problém alebo úloha)
3. Voliteľne zadajte otázky agendy (konkrétne otázky na zodpovedanie)
4. Voliteľne zadajte pravidlá agendy (obmedzenia diskusie)
5. Rozhodnite, či zahrnúť súhrny z predchádzajúcich stretnutí
6. Voliteľne zadajte kontexty (doplňujúce informácie pre agentov)
7. Zadajte počet kôl diskusie (odporúčané: 1-3)
8. Zadajte teplotu generovania (0.0-2.0, odporúčané: 0.2-0.7)
9. Potvrďte vytvorenie a spustenie stretnutia
T í m o v é stretnutie
V tímovom stretnutí PI vedie diskusiu, v ktorej sa postupne vyjadrujú všetci členovia tímu.
V hlavnom menu zvoľte možnosť 9. Create team meeting.
Postup je podobný ako pri individuálnom stretnutí, ale namiesto jedného špecialistu vyberiete
viacerých členov tímu. PI je automaticky zaradený ako vedúci diskusie.
Priebeh tímového stretnutia v každom kole:
1. PI predstaví agendu alebo syntetizuje predchádzajúcu diskusiu
2. Každý špecialista sa vyjadrí zo svojho odborného pohľadu
3. Vedecký kritik zhodnotí diskusiu a upozorní na nedostatky
4. Po poslednom kole PI sformuluje záverečné zhrnutie
Priebeh stretnutia
Po spustení stretnutia sa v reálnom čase zobrazujú stavové správy:
STARTING MEETING EXECUTI0N
Setting up meeting...
VirtualLab — Používateľská príručka Strana 8
Type: I n d i v i d u a l Meeting
Team Member: Immunologist
C r i t i c : S c i e n t i f i c C r i t i c
Rounds : 2
Round 0 of 2
Immunologist's turn
Immunologist i s t h i n k i n g . . .
Immunologist responded
S c i e n t i f i c C r i t i c ' s turn
S c i e n t i f i c C r i t i c i s t h i n k i n g . . .
S c i e n t i f i c C r i t i c responded
Po dokončení stretnutia sa zobrazí záverečné zhrnutie obsahujúce odporúčania a odpovede na otázky
agendy.
Pozor: Stretnutie môže trvať niekoľko minút v závislosti na počte agentov, počte kôl a rýchlosti
inferenčnej služby.
História stretnutí
V hlavnom menu zvoľte možnosť 10. View meeting history pre zobrazenie zoznamu predchádzajúcich
stretnutí. Po výbere konkrétneho stretnutia sa zobrazí kompletný prepis diskusie.
Prepis je možné exportovať do súboru vo formáte Markdown.
VirtualLab — Používateľská príručka Strana 9
Správa účtu
A k t u a l i z á c i a A P I tokenu
Ak váš A P I token e-INFRA CZ expiruje alebo ho potrebujete zmeniť, v hlavnom menu zvoľte
možnosť 11. Update e-INFRA API token. Zadajte nový token a systém overí jeho platnosť
pred uložením.
Prehľad hlavného menu
Možnosť Funkcia Vyžaduje lab
1 Vytvoriť nové laboratórium Nie
2 Vybrať existujúce laboratórium Nie
3 Pridať PI agenta Áno
4 Nechať PI navrhnúť tím Áno (4 PI)
5 Manuálne pridať agenta Áno
6 Pridať agentov z JSON Áno
7 Zobraziť agentov Áno
8 Individuálne stretnutie Áno (4- agenti)
9 Tímové stretnutie Áno (4- PI + agenti)
10 História stretnutí Áno
11 Aktualizovať A P I token Nie
12 Odhlásiť sa Nie
0 Ukončiť aplikáciu Nie
Tabuľka 1: Prehľad možností hlavného menu
VirtualLab — Používateľská príručka Strana 10