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í)
- 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í.
- Nechte si zkontrolovat instalaci. Příkaz
hermes doctorprojde nastavení a řekne, co chybí nebo co je špatně:$ hermes doctor - 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ěje | Příčina | Řešení |
|---|---|---|
| Odpovědi přestaly chodit, hlásí chybu 429 | Došel kredit nebo jste narazili na hodinový limit u poskytovatele modelu | Dobí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 unese | Srovnat rozhovor příkazem /compress, nebo začít nový (/new) |
| Agent neodpovídá v Telegramu ani Discordu, ale v aplikaci ano | Neběží 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ý kredit | Ověřit klíč u poskytovatele a vložit nový do nastavení agenta |
| Agent odmítá spustit příkaz | Pří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ě
| Projev | Co s tím |
|---|---|
| Odpověď se uprostřed přerušila | Napiš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ému | Zač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ěřit | Vyžá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á pomalu | Je to velký model nebo dlouhý rozhovor. Pomůže menší/rychlejší model nebo nový rozhovor |
Co si můžete spravit sami
| Příkaz | K čemu je |
|---|---|
hermes doctor | Kontrola: instalace, nastavení, klíče, co chybí |
hermes logs | Záznam o tom, co se dělo (vhodné přiložit, když se ptáte na pomoc) |
hermes sessions browse | Projít starší rozhovory a dohledat, co se kdy dělalo |
hermes pause / hermes resume | Zastavit a znovu pustit všechny pravidelné úlohy |
hermes cron status | Zda plánovač běží — když ne, úlohy se nespustí |
Kde hledat pomoc
| Kde | Kdy se tam obrátit |
|---|---|
| Discord komunity | Nejrychlejší cesta — zeptejte se ostatních, kteří si tím prošli |
| Oficiální dokumentace | Potř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í
| Co | Proč |
|---|---|
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 jednom | Když uděláte tři změny naráz a něco přestane fungovat, nepoznáte viníka |
| Sledovat spotřebu | Nejč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
Časté dotazyOdpovědi na to, na co se ptá nejvíc lidí⏳ připravujeme
BezpečnostCo agent smí a co musí odsouhlasit
Pravidelné úlohyKdyž úloha nechodí, jak ji prověřit
Oficiální dokumentaceŘešení potíží do detailu (anglicky)
