Přejít na hlavní obsah
V tomto tutoriálu vytvoříte Generátor dokumentů — aplikaci, která převádí znovupoužitelné šablony na personalizované dokumenty pomocí dat, která už máte ve svém CRM. Napište šablonu jednou pomocí {{placeholders}} a poté vygenerujte vyplněný dokument pro libovolnou osobu nebo společnost jedním kliknutím — z příkazové nabídky, od AI agenta nebo z workflow.
Vygenerovaný dokument obchodní nabídky

Co se naučíte

Každá kapitola přidá jednu schopnost. Na konci se seznámíte s většinou SDK.
KapitolaSchopnostReferenční dokumentace
1. Datový modelObjekty, pole a relaceData
2. Generování dokumentůLogická funkce (nástroj AI + akce workflow), která vyplní šablonu v Markdownu a připojí vyladěné PDFLogické funkce
3. HTTP trasyPoskytování JSONu a sdílitelné HTML stránky z trasLogické funkce
4. Vytváření uživatelského rozhraníZobrazení, navigace, příkazová nabídka a frontendové komponenty, které zobrazují náhled dokumentu a upravují šablonuRozvržení
5. Agent AIAgent + dovednostDovednosti a agenti
6. PublikováníPublikujte ji na marketplacePublikování

Předpoklady

Měli byste mít hotový rychlý start: lokální server Twenty běžící na portu 2020 a CLI k němu přihlášené. Pokud ne, nyní si jeden vytvořte a spusťte:
npx create-twenty-app@latest document-generator
cd document-generator
yarn twenty dev
Raději byste si přečetli hotový kód? Celá aplikace je v packages/twenty-apps/examples/document-generator. Každý úryvek níže je z ní zkopírovaný.

Jak do sebe aplikace zapadá

Šablona se zástupnými symboly se převede na vyladěný dokument s PDF souborem; generování lze spustit z příkazové nabídky, agenta AI, workflow nebo pomocí sdílitelného odkazu
Šablonu napíšete jednou v rich-text editoru pomocí {{placeholders}}. Výběr šablony a CRM záznamu vyplní zástupné symboly a uloží vyladěný dokument (s PDF souborem). Všechno ostatní — příkazová nabídka, agent AI, krok workflow, sdílený odkaz — je jen jiný způsob, jak spustit ten jeden generátor.

Udržujte tento cyklus v chodu

Nechte yarn twenty dev běžet v terminálu po celý tutoriál. Pokaždé, když přidáte nebo upravíte soubor pod src/, během několika sekund se znovu synchronizuje s vaším serverem, takže můžete sledovat, jak se každá schopnost objevuje v uživatelském rozhraní, jak ji vytváříte.

Začněte vytvářet →

Kapitola 1: modelujte dokumenty a šablony.