Připravovaný workshop: Agentní práce s LLM

Praktický workshop o tom, jak používat velké jazykové modely jako agenty: jak zadat úkol, vyhodnotit výsledek, bezpečně pracovat s nástroji a vybrat vhodný model. Budeme pracovat ve VS Code s GitHub Copilotem a podle potřeby připojíme vlastní modely Gemini a Mistral.

Termín, místo a odkaz na repozitář účastníci obdrží před workshopem. Níže uvedené kroky si můžete připravit s předstihem.

Co si připravit

• notebook s aktuálním systémem Windows, macOS nebo Linux a přístupem k internetu,
• GitHub účet pro VS Code a GitHub Copilot,
• VS Code nainstalované a přihlášené pod stejným GitHub účtem,
• volitelně vlastní klíč Gemini a/nebo Mistral uložený mimo repozitář.

API klíče nejsou podmínkou pro začátek, ale umožní vám během workshopu vyzkoušet více poskytovatelů a modelů.

1. Vytvořte si GitHub účet

1. Navštivte registraci GitHubu.
2. Vytvořte osobní účet nebo pokračujte přes Google.
3. Ověřte e-mailovou adresu.
4. Zapněte dvoufázové ověření (2FA).
5. Přihlaste se a před workshopem ověřte, že otevřete zaslaný repozitář workshopu.
6. Pokud je pro váš účet dostupný, aktivujte Copilot Free.

GitHub nabízí Copilot Free s omezeným přístupem k funkcím AI, agentům a automatickému výběru modelu. Protože se podmínky a limity mohou měnit, řiďte se vždy aktuálním přehledem plánů. GitHub také doporučuje po založení účtu zapnout 2FA; podrobnosti najdete v návodu k vytvoření účtu.

Kontrola připravenosti: Jste připraveni, když se přihlásíte do GitHubu, otevřete repozitář workshopu a ve VS Code vidíte Copilot Chat.

2. Nainstalujte Visual Studio Code

Windows

1. Na oficiální stránce ke stažení VS Code zvolte User Installer pro Windows.
2. Spusťte stažený instalátor.
3. Ponechte zapnutou možnost přidat VS Code do proměnné PATH.
4. Spusťte VS Code.
5. Přihlaste se GitHub účtem, který jste si připravili výše.
6. Otevřete zobrazení Chat nebo Agents a aktivujte Copilot.
7. Stáhněte nebo naklonujte repozitář workshopu.
8. Otevřete ve VS Code celý repozitář jako složku, nikoli jednotlivé soubory.

Pro většinu uživatelů Windows Microsoft doporučuje User Setup: nevyžaduje administrátorská práva a poskytuje plynulejší aktualizace. Podrobný postup je v oficiálním návodu pro Windows.

Pro macOS a Linux použijte odpovídající oficiální návod. Pokud s Gitem zatím nezačínáte, v repozitáři lze přes tlačítko Code použít Download ZIP. Pro plný postup s klonováním, commity a větvemi však budete potřebovat Git.

Další možnosti otevření a rozložení Chat/Agents popisuje oficiální dokumentace VS Code.

3. Nainstalujte Git

Git potřebujete pro plný postup s klonováním repozitáře, větvemi, commity a odesíláním změn. Pokud zatím chcete pouze číst materiály workshopu, můžete v repozitáři použít Code > Download ZIP; pro praktická cvičení je ale Git doporučený.

Windows

1. Stáhněte aktuální instalátor z oficiální stránky Git for Windows.
2. Spusťte instalátor a ponechte běžná výchozí nastavení, včetně možnosti používat Git z příkazového řádku.
3. Po dokončení otevřete nový PowerShell nebo Git Bash.
4. Ověřte instalaci příkazem:

git --version

Pokud používáte Windows Package Manager, lze Git nainstalovat také příkazem winget install --id Git.Git -e --source winget.

macOS a Linux

• macOS: V Terminálu spusťte xcode-select --install, případně při používání Homebrew brew install git. Viz oficiální možnosti instalace pro macOS.
• Debian/Ubuntu: sudo apt install git
• Fedora: sudo dnf install git
• Další distribuce: použijte správce balíčků své distribuce podle oficiálního návodu pro Linux.

Po instalaci na libovolném systému znovu ověřte git --version. Pokud budete vytvářet vlastní commity, nastavte si jednou své jméno a e-mail; tyto údaje se stanou součástí historie commitů:

git config --global user.name "Vaše jméno"
git config --global user.email "[email protected]"

Podrobnosti najdete v návodu pro první nastavení Gitu.

Kontrola připravenosti: Jste připraveni, když git --version vypíše verzi a ve VS Code po otevření repozitáře vidíte zobrazení Source Control.

4. Získejte Gemini API key

1. Přihlaste se do Google AI Studio.
2. Přijměte příslušné podmínky.
3. Otevřete sekci Projects nebo API Keys.
4. Použijte automaticky vytvořený projekt nebo importujte existující projekt Google Cloud.
5. Vytvořte nebo zobrazte Gemini API key.
6. Okamžitě jej zkopírujte do správce hesel.
7. Nikdy jej nevkládejte do repozitáře workshopu.
8. Ve VS Code spusťte Chat: Manage Language Models, zvolte Add Models, vyberte Gemini a vložte klíč.
9. Vyberte Gemini model podporující tool calling.
10. Spusťte připravený test připojení z repozitáře workshopu.

Google u vybraných modelů nabízí omezenou bezplatnou úroveň Gemini Developer API. U bezplatné úrovně může být odeslaný obsah použit pro zlepšování produktů Google, proto do ní nepatří důvěrná pracovní ani osobní data. Podmínky a aktuální ceny ověřte na stránce Gemini API pricing.

Google doporučuje používat proměnné prostředí, například GEMINI_API_KEY, a výslovně varuje před commitem klíčů do Gitu nebo jejich vystavením v klientských aplikacích. Viz návod k API key. Ve VS Code se vlastní modely přidávají přes Language Models; agentům se zobrazují jen modely s podporou tool callingu. Viz dokumentace VS Code k vlastním modelům.

5. Získejte Mistral API key

1. Vytvořte si účet v Mistral Studio.
2. Otevřete sekci API Keys.
3. Zvolte Create new key.
4. Pojmenujte klíč rozpoznatelně, například agentic-llm-workshop.
5. Pokud to rozhraní nabízí, nastavte datum expirace.
6. Ihned klíč zkopírujte — celá hodnota se zobrazí pouze jednou.
7. Uložte ho bezpečně mimo repozitář.
8. Připojte jej přes integrovaného poskytovatele VS Code, je-li k dispozici, přes kompatibilní provider extension nebo přes vlastní API endpoint.
9. Vyberte model s podporou tool callingu a spusťte test připojení.

Mistral uvádí, že režim Free nevyžaduje platební kartu, ale podléhá limitům používání a rychlosti. Aktuální postup najdete v oficiálním návodu pro aktivaci a vytvoření API key. Dostupnost poskytovatelů a modelů ve VS Code se může měnit; pokud Mistral nenajdete mezi integrovanými poskytovateli, použijte kompatibilní rozšíření nebo vlastní endpoint podle dokumentace VS Code.

Bezpečné použití během workshopu

• Nikdy neposílejte klíče, hesla, interní dokumenty ani osobní údaje do chatu, promptu nebo repozitáře.
• Před spuštěním nástroje vždy zkontrolujte, co má agent provést a které soubory může změnit.
• Změny agenta kontrolujte jako běžné změny kódu: projděte diff a spusťte testy.
• Když si nejste jistí, zastavte se a zeptejte se během workshopu.

Těším se na společné experimentování s agenty, nástroji a modely.

Michael Princ