# Řešení problémů

> Opravy běžných problémů PentAGI — flow, který selže při prvním volání modelu, chyby parseru tool call, varování instalátoru na macOS a zaseknuté malé modely.

Začněte s logy obou stran spojení: `docker compose logs -f pentagi` pro PentAGI a logy vašeho backendu modelu nebo proxy.

## [Flow selže s chybou „failed to select primary docker image via llm call“](https://pentagi.com/cs/docs/deployment/troubleshooting/#a-flow-fails-with-failed-to-select-primary-docker-image-via-llm-call)

První věc, kterou [flow](https://pentagi.com/cs/docs/glossary/#flow) udělá, je požadavek na model, aby vybral Docker image, prostřednictvím agenta `simple`. Tato chyba téměř vždy ukazuje na backend modelu, nikoli na Docker:

1. Zkontrolujte logy PentAGI a logy vašeho backendu modelu.
2. Ověřte, že základní URL, API klíč a název modelu jsou správné a dostupné z kontejneru.
3. Tento požadavek neodesílá žádné nástroje, takže selže na připojení, klíči nebo modelu, nikoli na [tool](https://pentagi.com/cs/docs/glossary/#tool) calling: zkontrolujte, že model agenta `simple` odpoví na běžný chatový požadavek. Chybějící tool-call parser se projeví až později, jakmile agenti začnou volat nástroje.

## [Chyby tool-call parseru u vlastních modelů](https://pentagi.com/cs/docs/deployment/troubleshooting/#tool-call-parser-errors-with-self-hosted-models)

PentAGI řídí agenty pomocí [tool calls](https://pentagi.com/cs/docs/glossary/#tool-call), takže vlastní backend musí vracet platný JSON tool call ve stylu OpenAI. Mezi příznaky chybějícího nebo neodpovídajícího parseru patří `Failed to parse tool call arguments as JSON`, flow, které se zastaví po několika krocích, a tool calls, která se opakují bez dosažení výsledku.

* Povolte tool-call parser a šablonu chatu doporučenou pro model, který provozujete v llama.cpp, SGLang nebo vLLM.
* Před spuštěním kompletního flow ověřte [provider](https://pentagi.com/cs/docs/glossary/#provider) pomocí utility `ctester`.
* Aktualizujte PentAGI: nedávné verze sanitizují chybně formátované argumenty, takže jedna špatná odpověď již nezablokuje celý flow.

## [macOS blokuje instalační program](https://pentagi.com/cs/docs/deployment/troubleshooting/#macos-flags-the-installer)

Verze pro macOS jsou podepsané a notářsky ověřené. Pokud macOS stále varuje před instalátorem, nepřepisujte toto varování pomocí **Přesto otevřít**: soubor smažte a znovu si stáhněte archiv pro váš procesor z oficiálních odkazů — `darwin/amd64` pro Intel, `darwin/arm64` pro Apple silicon. Nikdy nepoužívejte archiv z neoficiálního zdroje.

## [Menší modely se zasekávají](https://pentagi.com/cs/docs/deployment/troubleshooting/#smaller-models-get-stuck)

Povolte [monitorování provádění a plánování task](https://pentagi.com/cs/docs/concepts/agents/#safeguards) a přiřaďte agentovi `adviser` silnější model nebo vyšší nastavení usuzování.

## [Stále máte potíže?](https://pentagi.com/cs/docs/deployment/troubleshooting/#still-stuck)

Zeptejte se na [Discordu](https://discord.gg/2xrMh7qX6m) nebo [vytvořte issue](https://github.com/vxcontrol/pentagi/issues) s příslušnými řádky z logů.