Saltar para o conteúdo principal
Neste tutorial, você vai criar o Gerador de Documentos — um aplicativo que transforma modelos reutilizáveis em documentos personalizados usando os dados que você já tem no seu CRM. Escreva um modelo uma vez com {{placeholders}} e, em seguida, gere um documento preenchido para qualquer Pessoa ou Empresa com um clique — a partir do menu de comandos, de um agente de IA ou de um fluxo de trabalho.
Um documento de proposta de vendas gerado

​
O que você vai aprender

Cada capítulo adiciona uma capacidade. Ao final, você terá usado a maior parte do SDK.
CapítuloCapacidadeReferência
1. Modelo de DadosObjetos, campos e uma relaçãoDados
2. Geração de documentosUma função lógica (ferramenta de IA + ação de fluxo de trabalho) que preenche um modelo Markdown e anexa um PDF finalizadoFunções lógicas
3. Rotas HTTPServindo JSON e uma página HTML compartilhável a partir de rotasFunções lógicas
4. Criando a UIVistas, navegação, menu de comandos e componentes de front-end que pré-visualizam um documento e editam um modeloLayout
5. Um agente de IAAgente + habilidadeHabilidades e Agentes
6. PublicaçãoEnvie-o para o marketplacePublicação

​
Pré-requisitos

Você deve ter concluído o Quick Start: um servidor Twenty local em execução na porta 2020 e o CLI autenticado nele. Se não, gere a estrutura e inicie um agora: 
npx create-twenty-app@latest document-generator
cd document-generator
yarn twenty dev
Prefere ler o código finalizado? O aplicativo completo está em packages/twenty-apps/examples/document-generator. Cada trecho abaixo foi copiado de lá.

​
Como o aplicativo se encaixa

Um modelo com placeholders é transformado em um documento finalizado com um PDF, acionado a partir do menu de comandos, de um agente de IA, de um fluxo de trabalho ou de um link compartilhável
Você escreve um modelo uma vez em um editor de texto rico, com {{placeholders}}. Escolher um modelo e um registro de CRM preenche os placeholders e armazena um documento finalizado (com um arquivo PDF). Todo o resto — o menu de comandos, o agente de IA, a etapa do fluxo de trabalho, o link compartilhável — é apenas uma forma diferente de acionar aquele único gerador.

​
Mantenha este ciclo em execução

Deixe yarn twenty dev rodando em um terminal durante todo o tutorial. Toda vez que você adicionar ou editar um arquivo em src/, ele será ressíncronizado com o seu servidor em alguns segundos, para que você possa ver cada capacidade aparecer na UI conforme a constrói.

Comece a construir →

Capítulo 1: modele documentos e modelos de documento.