Wiki · Začínáme
Skilly — rozšíření agenta
Napíšete postup jednou a agent ho použije pokaždé — bez programování a bez toho, aby to zabíralo místo.
Co je skill (a co není)
| Co | Co to je | Příklad |
|---|---|---|
| Skill | Napsaný postup pro agenta: kdy ho použít, jaké kroky udělat, čeho se vyvarovat, jak ověřit výsledek | „Jak u nás zálohovat databázi“ |
| Nástroj (tool) | Schopnost, kterou agent má — čte soubory, spouští příkazy, hledá na webu | Spuštění příkazu v terminálu |
| Plugin | Programové rozšíření samotného agenta (nová funkce v kódu). Píše se v Pythonu | Napojení na platební bránu |
Pro většinu uživatelů stačí skilly. Plugin je něco, co programátor vyvíjí a udržuje — skill je jen prověřený postup v textu.
Proč se to vyplatí
| Přínos | Co to znamená v praxi |
|---|---|
| Postup se dodrží pokaždé | Agent nemusí pokaždé vymýšlet, jak na to — přečte si váš postup. Méně chyb, méně vysvětlování |
| Nezabírá místo, dokud není potřeba | Agent zná jen názvy a popisy skillů. Celý text si načte, až když se hodí — proto můžete mít desítky skillů a nic to nestojí |
| Vaše know-how zůstane u vás | Skilly jsou obyčejné soubory na vašem serveru ve složce ~/.hermes/skills/. Můžete je zálohovat i přesunout |
| Agent se zlepšuje sám | Když se něco složitě podaří, agent si z toho umí sepsat skill a příště to má jednodušší |
Hotové skilly — kde je brát
Agent už má 58 hotových skillů a dalších 153 volitelných, které se doinstalovávají zvlášť. Podívat se a vybrat si můžete příkazem:
Instalace jednoho skillu je jeden příkaz:
| Kategorie | Co v ní najdete (příklady z hotových skillů) |
|---|---|
| Dokumenty | Word, Excel, PDF, prezentace — tvorba i čtení |
| Práce s kódem | GitHub, kontrola změn, hledání chyb, spouštění testů |
| Výzkum a web | Ověřené citace, sběr z RSS, sledování stránek, kontrola domén |
| Komunikace | Procházení e-mailů a příprava odpovědí |
| Provoz serveru | Docker, zálohy, monitorování, bezpečnost |
| Tvořivé | Grafy, diagramy, obrázky, jednoduché animace |
Nainstalovaný skill platí pro nové rozhovory. Když ho chcete použít hned uprostřed práce,
spusťte /reset (nový rozhovor), nebo si vyžádejte okamžité načtení přepínačem --now — to je
o něco dražší, protože se znovu načítá paměť rozhovoru.
Naučte agenta vlastní postup — i bez psaní
Nemusíte psát soubor ručně. Příkazem /learn řeknete agentovi, ať si postup sepíše sám —
z dokumentace, z webové stránky, nebo z toho, co jste právě spolu udělali:
Agent si materiál projde, napíše z něj skill a od příště ho bude používat. Nic nemusíte umět programovat.
Jak vypadá vlastní skill
Skill je jediný textový soubor SKILL.md ve vlastní složce. Na začátku je krátké označení, podle kterého
agent pozná, kdy má skill použít, a zbytek je návod:
Rozhoduje první věta. Agent se dívá hlavně na description — musí být krátká a musí
říct, při jaké příležitosti se skill použije („Když se…“ / „Use when…“).
Naše tipy z provozu
| Tip | Proč |
|---|---|
| Pište konkrétní postup, ne obecné rady | „Spusť tento příkaz a zkontroluj tento výstup“ je použitelné, „buď opatrný“ není |
| Jeden skill = jedna věc | Malý a přesný skill se použije správně; obří se plete s ostatními |
| Doplňte, co se nepovedlo | Napsat do skillu chyby, na které jste narazili, ušetří hodiny příště |
| Přidejte, jak výsledek ověřit | Agent si tak sám zkontroluje, jestli to udělal dobře (a vy taky) |
| Žádná hesla a klíče uvnitř skillu | Skill je návod, ne trezor. Tajné údaje patří do nastavení agenta |
| Když se realita změní, přepište skill | Zastaralý skill je horší než žádný — agent se podle něj naučí špatný postup |
| Než nainstalujete cizí skill, přečtěte si ho | Skill říká agentovi, co má dělat. Nainstalujte jen zdroj, kterému věříte, a text si projděte |
Když se to nedaří
| Co se děje | Příčina a co s tím |
|---|---|
| Agent skill nepoužije | Popis (první věta) nesedí na zadání — přepište ho tak, aby začínal „Když se…“ a obsahoval slova, kterými úkol zadáváte |
| Nainstalovaný skill nefunguje hned | V rozhovoru se načítá při jeho začátku. Spusťte /reset, nebo si vyžádejte načtení hned |
| Pletou se dva podobné skilly | Dva skilly se stejným jménem nebo stejnou oblastí. Jeden přejmenujte nebo slučte |
| Nevím, co agent používá | hermes skills list (nebo /skills search) ukáže, co je k dispozici; hermes skills audit zkontroluje stav katalogu |
| Skill dělá něco zlého | Cizí skill může obsahovat nebezpečný postup. Smažte ho ze složky ~/.hermes/skills/ a berte skilly jen z ověřených zdrojů |