> ## Documentation Index
> Fetch the complete documentation index at: https://wl.macaly.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Macaly Agent

Macaly agent staví weby a aplikace za vás. Popíšete, co chcete, běžným jazykem a agent zjistí, jak to udělat.

## Co je agent?

Pokud jste používali ChatGPT nebo podobné nástroje, znáte chatboty.

Položíte otázku, dostanete odpověď. Tím to končí.

Agent je něco jiného. Agent jedná.

Představte si to takhle:

* Chatbot vám řekne, jak objednat pizzu.
* Agent prohlédne restaurace, porovná ceny, objedná za vás a dá vám vědět, až dorazí.

Macaly agent funguje stejně, akorát místo objednávání pizzy staví weby a aplikace.

## Režimy

Macaly má 3 režimy, které řídí, jak agent zpracovává vaše požadavky:

* **Build:** Staví okamžitě bez otázek. Nejlepší, když přesně víte, co chcete.
* **Plán:** Nejdřív vytvoří plán nebo se zeptá na upřesňující otázky. Použijte, když je úkol složitý nebo chcete postup nejdřív zkontrolovat.
* **Auto (výchozí)**: Sám rozhodne, kdy plánovat a kdy rovnou stavět. Jednoduché požadavky rovnou staví, složité spustí plánování nebo otázky.

Režim můžete přepnout přímo v chatu pomocí selektoru vedle vstupního pole.

<img src="https://mintcdn.com/macalywl/j-Vf23AL_8eSkHUs/images/Execution%20modes.png?fit=max&auto=format&n=j-Vf23AL_8eSkHUs&q=85&s=aafa6cf111f694abecf6311473d5da79" alt="Execution Modes" width="2880" height="1324" data-path="images/Execution modes.png" />

## Schopnosti agenta

Agent funguje jako spolupracovník, který umí plánovat, ptát se, zkoumat a stavět vaši aplikaci od začátku do konce.

<AccordionGroup>
  <Accordion title="Plánuje před stavbou" icon="list">
    U složitějších funkcí agent rozloží váš požadavek na kroky a nejdřív vám ukáže plán. Můžete ho zkontrolovat a schválit, než se začne stavět.
  </Accordion>

  <Accordion title="Ptá se, když něco není jasné" icon="question">
    Místo hádání se agent zastaví a položí cílené otázky. Výsledek pak odpovídá tomu, co skutečně chcete.
  </Accordion>

  <Accordion title="Pamatuje si předchozí rozhodnutí" icon="clock">
    Agent si drží kontext z předchozí práce na projektu, takže změny zůstávají konzistentní s dřívějšími rozhodnutími.
  </Accordion>

  <Accordion title="Hledá na webu" icon="globe">
    Pokud agent potřebuje aktuální informace, příklady nebo dokumentaci, vyhledá si je na internetu.
  </Accordion>

  <Accordion title="Učí se z existujících webů" icon="book-open-cover">
    Když sdílíte URL, agent dokáže pochopit strukturu a design a použít je jako referenci nebo inspiraci.
  </Accordion>

  <Accordion title="Pracuje s fotkami" icon="image">
    Najde kvalitní stock fotky, které se hodí do vašeho projektu — hero obrázky, pozadí nebo lifestyle fotky.
  </Accordion>

  <Accordion title="Tvoří vlastní vizuály" icon="wand">
    Generuje nové obrázky, edituje existující nebo odstraňuje pozadí, když stock fotky nestačí.
  </Accordion>

  <Accordion title="Provádí změny za vás" icon="edit">
    Nemusíte se dotýkat kódu. Agent aktualizuje stránky, obsah, layout a funkcionalitu podle toho, co si řeknete.
  </Accordion>

  <Accordion title="Kontroluje vlastní práci" icon="check-circle">
    Před dokončením agent zkontroluje, co vytvořil, aby odhalil chyby nebo chybějící detaily.
  </Accordion>
</AccordionGroup>

## AI modely

Model projektu vyberete v **Nastavení → Obecné → AI Model**. Dostupné možnosti závisí na konfiguraci vaší white-label platformy a mohou zahrnovat:

* **OpenAI**: GPT-5.6 Terra, Sol a Luna — zpracování v USA
* **Anthropic**: Sonnet 5 a Opus 5 — zpracování v EU
* **Grok 4.5** a **Kimi K3** — zpracování v USA
* **Minimax 3**, **GLM 5.2** a **DeepSeek Flash v4** — zpracování v EU

Výběr u každého modelu zobrazuje vlajku EU nebo USA. Modely se liší schopnostmi, rychlostí a spotřebou kreditů; vhodný kompromis pro aktuální úkol vyberte podle popisu pod nabídkou.

Agent běží v bezpečném sandbox prostředí a má přístup ke skutečným vývojářským nástrojům. Umí procházet internet, uvažovat o struktuře, iterovat na řešeních a vylepšovat projekty bez neustálého manuálního promptování.

## Často kladené otázky

<AccordionGroup>
  <Accordion title="Agent se zasekl nebo pracuje příliš dlouho. Co mám dělat?">
    Pokud agent více než 10 až 15 minut nevykazuje žádný pokrok, nejprve znovu načtěte stránku. Pokud je náhled zamrzlý, otevřete nabídku náhledu a u novějších projektů zvolte **Rebuild Preview**, u starších **Restart App**.

    Jestli poslední změna projekt rozbila, použijte **Historii verzí**, pokud je dostupná, nebo **Obnovit tuto verzi** u poslední funkční odpovědi agenta. Pokud problém přetrvává, nahlaste ho u dotčené odpovědi a přiložte odkaz na chat, přibližný čas a snímek obrazovky nebo podrobnosti chyby.
  </Accordion>

  <Accordion title="Agent opakuje stejnou chybu. Jak se vyhnout zbytečnému spotřebovávání kreditů?">
    Při popisu chyby buďte co nejkonkrétnější. Popište, co jste dělali před chybou, co vidíte nyní, co nefunguje a jaké by mělo být správné chování. Čím více detailů poskytnete, tím lépe agent chybu opraví na první pokus.
  </Accordion>

  <Accordion title="Mám velké požadavky rozdělit na menší kroky?">
    Ano. Množství práce, které agent zvládne, se liší podle úkolu a může zahrnovat paralelní práci, takže jeden pevný limit kroků není užitečný. Velké nebo navazující požadavky rozdělte na zvládnutelné prompty, každý výsledek ověřte a pak pokračujte.
  </Accordion>

  <Accordion title="Jak si vytvořit zálohu projektu?">
    Pro návrat k funkční verzi použijte **Historii verzí**, pokud je dostupná, nebo **Obnovit tuto verzi**. Projekt duplikujte tehdy, když chcete samostatnou větev pro experimentování, ne jako hlavní způsob obnovy. Běžné duplikáty neobsahují historii konverzace a u projektů s databází si zvolíte, zda vytvořit novou databázi, nebo použít stejnou.
  </Accordion>

  <Accordion title="Mohu obnovit předchozí verzi projektu?">
    Ano. V **Historii verzí**, pokud je dostupná, můžete procházet předchozí náhledy, rozeznat nejnovější a publikovanou verzi, otevřít je samostatně nebo obnovit. Také můžete použít **Obnovit tuto verzi** pod odpovědí agenta a vrátit kód projektu do daného bodu.
  </Accordion>

  <Accordion title="Kdy mám použít /compact?">
    `/compact` použijte, když dlouhý chat začíná ztrácet soustředění nebo před novým, ale souvisejícím úkolem. Příkaz shrne konverzaci, ale zachová stejný projekt a kód. Vytvoření shrnutí spotřebuje kredity a vyžaduje minimální zůstatek, kratší kontext ale může zlevnit další zprávy. Nepouštějte ho po každé zprávě, protože opakované shrnování může ztratit detaily.
  </Accordion>
</AccordionGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.