Wiki · Funkce do hloubky

Desktop

Stejný agent, ale v okně s tlačítky: projekty, soubory, terminál a rozhovory vedle sebe — a můžete se z něj připojit k agentovi na serveru.

🖥️
Aplikace není jiný agent — je to jiné okno k tomu samému. Stejné nastavení, stejné klíče, stejná paměť, stejné rozhovory, stejné skilly. Co uděláte v terminálu, uvidíte v aplikaci, a naopak.

Kdy se hodí

SituaceProč aplikace
Chcete vidět, co agent děláPrůběh odpovědi i každé volání nástroje je vidět v přehledné podobě, včetně obrázků
Pracujete na víc věcech najednouVíc oken a panelů: jeden rozhovor na jednom monitoru, druhý na jiném
Potřebujete soubory a terminál po ruceVedle chatu je prohlížeč souborů a skutečný terminál — bez přepínání oken
Nechcete psát příkazyNastavení se dělá v přehledných stránkách, ne v souboru s nastavením
Spravujete víc agentůVolitelné okno „Applies to“ říká, kterého profilu se změna v nastavení týká

Instalace a spuštění

Aplikace se stahuje z webu projektu, ale když už Hermes na počítači máte, stačí jeden příkaz — použije vaše klíče, rozhovory i skilly:

❯ hermes desktop ❯ hermes desktop --cwd /cesta/k/projektu # otevřít rovnou v projektu

Běží na macOS, Windows i Linuxu. Na počítači s Windows je potřeba Git a pro připojení na vzdálený stroj SSH klient.

Co v aplikaci najdete

ČástK čemu slouží
Chat (střed)Rozhovor s agentem, průběh nástrojů, přílohy přetažením, obnovené neodeslané zprávy
Postranní sloupecSeznam rozhovorů, projektů a nastavení; přepínání profilů
Náhled vpravoZobrazení souborů, výsledků nástrojů a webových stránek, na kterých agent pracuje
Terminál vpravoSkutečný terminál: Ctrl+` ho otevře, další Ctrl+Shift+`. Běží dál, i když panel schováte
Výstupy práce (artefakty)Hotové soubory a náhledy nad psacím polem — kliknutím se otevřou
Živí podagentiPruh s počtem a stavem pracujících pomocníků, s možností do jejich práce mluvit nebo je zastavit

Práce na víc věcech najednou

KlávesaCo udělá
Ctrl+TNový rozhovor v nové kartě
Ctrl+TabPřepínání mezi rozhovory
Ctrl+1…9Skok na rozhovor podle pořadí
Ctrl+Shift+NNové okno — hodí se pro dlouhou úlohu na druhý monitor
Ctrl+B / Ctrl+JSkrytí levého / pravého sloupce (víc místa pro chat)

Na macOS je místo Ctrl klávesa Cmd.

Projekty

Aplikace umí pracovat s víc projekty vedle sebe. Složky s projekty hledá při startu — ve vaší domovské složce do omezené hloubky. Hledání se dá vypnout nebo omezit:

# ~/.hermes/config.yaml — nastavení prohledávání složek repo_scan_enabled: false # ať se domovská složka vůbec neprohledává

Složku, ve které má agent pracovat, můžete určit i při spuštění (--cwd) nebo trvale přes terminal.cwd v nastavení profilu — viz Profily a více agentů.

Víc profilů v jedné aplikaci

Máte-li víc profilů (třeba jeden pro práci a jeden pro osobní věci), nemusíte přepínat celou aplikaci. Stránky nastavení mají nahoře přepínač „Applies to“, kterým určíte, kterého profilu se změna týká.

❯ Cmd/Ctrl+K → Export profile… # celý profil do jednoho souboru

Export obsahuje skilly, paměť, osobnost, plánované úlohy a nastavení — API klíče se do exportu nedávají, ty se doplňují až na cílovém počítači. Hodí se na přenos nastavení na jiný počítač nebo na sdílení s kolegou.

Agent na serveru, aplikace u vás

Aplikace umí běžet i tak, že sama nic nepočítá a jen se připojí k agentovi na serveru (VPS, domácí server, malý počítač doma). Nastavuje se to na jedné stránce Nastavení → Gateways:

MožnostCo to znamená
Místní agentVýchozí: aplikace si agenta spouští sama na vašem počítači
Vzdálený agentZadáte adresu serveru, na kterém běží hermes serve, a přihlásíte se
Hermes CloudPřihlášení a výběr agenta z vašeho účtu — bez zadávání adresy

Připojení k serveru je věc počítače, ne profilu: z jednoho počítače se dá připojit k víc serverům a profily se načítají z toho, ke kterému jste připojení.

Když něco nefunguje

Co se dějeCo s tím
Po aktualizaci (hermes update) aplikace zmizelaZavřela se kvůli výměně souborů. Spusťte ji znovu: hermes desktop
Nedostanu se na server, hlásí to přihlášeníZkontrolujte jméno i heslo (server schválně neprozrazuje, které z nich je špatně) a jestli je přihlašování na serveru vůbec zapnuté
Okno „pod oknem“ nic nevidíNa Windows s čipem ARM to neumí — použijte běžnou verzi pro Intel/AMD nebo to neřešte
Připojení ke vzdálenému serveru vypadloDá se obnovit bez zavírání aplikace (znovu připojit na stránce Gateways)
Změnil se klíč serveru (SSH)Aplikace se ozve, že se klíč serveru změnil — to je ochrana proti podvržení, ne chyba. Řešte to s správcem serveru

Naše zkušenosti

Co jsme řešiliPonaučení
Rozhovor začal v terminálu a chtěli jsme pokračovat v aplikaciJde to — stav je společný. Do aplikace se dá i přepnout uprostřed úlohy
Vedle chatu jsme potřebovali vidět, co agent dělá na serveruTerminál v pravém sloupci a náhled souborů šetří přepínání oken; terminál běží dál i skrytý
V aplikaci jsme si psali s dvěma agenty a nastavení se pletloPomohl přepínač „Applies to“ — změna platí pro vybraný profil, ne pro všechny
Dvě aktualizace za sebou a aplikace se neotevřelaNení to závada: aplikaci po aktualizaci spouštějte znovu (klidně z terminálu příkazem hermes desktop)

Naše tipy

TipProč
Nastavte si --cwd nebo terminal.cwdAgent začne v projektu, ne v domovské složce — míň vysvětlování na začátku
Dlouhou úlohu si vydejte do samostatného oknaMůžete pracovat jinde a nesaháte pořád na stejný rozhovor
Používejte aplikaci i terminál podle situaceRychlý dotaz je lepší v terminálu, rozbor s obrázky a soubory v aplikaci
Před přenosem na jiný počítač si profil vyexportujteOdnesete si nastavení a paměť; klíče doplníte — ty se schválně nepřenášejí

Kam dál

← Zpět na wiki