> ## Documentation Index
> Fetch the complete documentation index at: https://www.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/macaly-41b1d3e9/klfbwgQaYrAYi4Bk/images/Execution%20modes.png?fit=max&auto=format&n=klfbwgQaYrAYi4Bk&q=85&s=0a2b6b7f4724bc81da726b595cbafb4d" 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

Macaly používá kombinaci AI modelů optimalizovaných pro kvalitu a spolehlivost:

* Anthropic Sonnet 4.6 pro primární generování a úpravy (výchozí)

* Anthropic Sonnet 4.5, Opus 4.5 a Opus 4.6 jako alternativní modely

* Gemini pro drobné knowledge-retrieval úlohy

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, zkuste duplikovat chat pomocí tlačítka **Duplikovat** > **Začít znovu (bez zpráv)**. To obvykle problém vyřeší. Pokud ne, [kontaktujte podporu](mailto:support@macaly.com) s odkazem na chat. Veškeré kredity spotřebované během potvrzeného problému budou přezkoumány a případně vráceny.
  </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="Kolik úkolů může agent provést na jeden prompt?">
    Macaly zvládne přibližně 20 kroků v rámci jednoho promptu. Pokud je váš prompt příliš složitý, agent nemusí dokončit vše. Rozdělte velké požadavky na menší kroky: pošlete jednu konkrétní změnu na zprávu, ověřte, že vše funguje, a pak pokračujte dál.
  </Accordion>

  <Accordion title="Jak si vytvořit zálohu projektu?">
    Chat duplikujte ideálně tehdy, když je projekt v ideálním stavu, zejména před většími změnami. Použijte funkci **Duplikovat** > **Ponechat vše (se zprávami)** pro zachování celé historie chatu, nebo **Duplikovat** > **Začít znovu (bez zpráv)** pro přenesení kódu projektu bez historie chatu. Každá kopie bude mít vlastní samostatnou databázi.
  </Accordion>

  <Accordion title="Mohu obnovit předchozí verzi projektu?">
    Ano. Pod každou odpovědí agenta v chatu je tlačítko **Obnovit tuto verzi**. Po kliknutí se projekt vrátí do stavu, v jakém byl při generování dané odpovědi.
  </Accordion>
</AccordionGroup>