Wiki · Začínáme

Když se něco pokazí

Většina potíží má jednu z pěti příčin — a agent si sám vede záznam, takže se dá zjistit, co se stalo.

🔧
Nic se nerozbije navždy — a většina potíží má jednu z pěti příčin. Agent si sám vede záznam o tom, co dělal, takže se dá nejdřív zjistit, co se stalo, a teprve pak něco měnit. Vyřešeno bylo i to, co vypadalo beznadějně.

První tři kroky (v tomto pořadí)

  1. Zeptejte se agenta, co se stalo. V rozhovoru můžete napsat přímo:
    ❯ Podívej se do záznamu a zjisti, co se pokazilo při posledním kroku. ❯ Proč ten příkaz neproběhl? Co mu bránilo?
    Agent má přístup ke své historii a k výpisu běhů, takže často odpoví sám a hned to i opraví.
  2. Nechte si zkontrolovat instalaci. Příkaz hermes doctor projde nastavení a řekne, co chybí nebo co je špatně:
    $ hermes doctor
  3. Podívejte se do záznamu a do historie rozhovorů.
    $ hermes logs # co se naposledy dělo $ hermes sessions browse # projít starší rozhovory

Pět nejčastějších příčin

Co se dějePříčinaŘešení
Odpovědi přestaly chodit, hlásí chybu 429Došel kredit nebo jste narazili na hodinový limit u poskytovatele modeluDobít kredit, chvíli počkat, nebo přepnout na levnější model (viz výběr modelu)
Agent hlásí, že je kontext příliš dlouhýRozhovor je delší, než model uneseSrovnat rozhovor příkazem /compress, nebo začít nový (/new)
Agent neodpovídá v Telegramu ani Discordu, ale v aplikaci anoNeběží brána, která zprávy přeposíláZkontrolovat stav a bránu spustit znovu (viz Telegram a Discord)
Model hlásí neplatný klíčKlíč vypršel, byl smazán, nebo je u něj vyčerpaný kreditOvěřit klíč u poskytovatele a vložit nový do nastavení agenta
Agent odmítá spustit příkazPříkaz je nebezpečný (nebo na seznamu zakázaných) a čeká na vaše potvrzeníPotvrdit, povolit natrvalo, nebo zvolit jiný postup (viz bezpečnost)

Když agent odpovídá divně

ProjevCo s tím
Odpověď se uprostřed přerušilaNapište „pokračuj“ — agent naváže tam, kde skončil. Když se to opakuje, je to nejčastěji slabé spojení nebo malý model
Plete si souvislosti a vrací se k něčemu dávnémuZačněte nový rozhovor (/new). Dlouhý rozhovor se plní nepotřebnými detaily a agent se v nich ztrácí
Tvrdí něco, co si nemůže ověřitVyžádejte důkaz: „Ukaž mi soubor / výstup příkazu, ze kterého to víš.“ Když důkaz nedá, tvrzení neberte
Odpovídá zbytečně dlouzeŘekněte, jak to chcete: „odpovídej stručně, bez tabulek“ nebo „nejdřív mi to shrň do pěti vět“. Agent si to může uložit do paměti
Odpovídá pomaluJe to velký model nebo dlouhý rozhovor. Pomůže menší/rychlejší model nebo nový rozhovor

Co si můžete spravit sami

PříkazK čemu je
hermes doctorKontrola: instalace, nastavení, klíče, co chybí
hermes logsZáznam o tom, co se dělo (vhodné přiložit, když se ptáte na pomoc)
hermes sessions browseProjít starší rozhovory a dohledat, co se kdy dělalo
hermes pause / hermes resumeZastavit a znovu pustit všechny pravidelné úlohy
hermes cron statusZda plánovač běží — když ne, úlohy se nespustí

Kde hledat pomoc

KdeKdy se tam obrátit
Discord komunityNejrychlejší cesta — zeptejte se ostatních, kteří si tím prošli
Oficiální dokumentacePotřebujete přesný popis nastavení nebo chybového hlášení (anglicky)
Oficiální repozitář (GitHub)Skutečná chyba v programu — tam patří hlášení s popisem postupu

Než napíšete o pomoc, přiložte: co jste dělali, co jste čekali, co se stalo a kolik bylo hodin. A když je to možné, i výpis z hermes logs. Bez toho se problém hledá naslepo a odpověď bude znít „zkuste to znovu“.

Prevence, která se vyplácí

CoProč
Zálohovat složku ~/.hermes/Jsou tam rozhovory, paměť i skilly — tedy všechno, co se nedá dohledat znovu
Tajnosti držet v nastaveníAby se nedostaly do textů, záloh ani do gitu (viz bezpečnost)
Měnit věci po jednomKdyž uděláte tři změny naráz a něco přestane fungovat, nepoznáte viníka
Sledovat spotřebuNejčastější důvod náhlého nefunkčního stavu je vyčerpaný kredit, ne chyba
Vědět, co je připojenéNapojení, skilly a plánované úlohy jsou tři místa, odkud přicházejí překvapení

Kam dál

← Zpět na wiki