跳转到主要内容
在本教程中,你将构建 Document Generator —— 一个应用,它将可复用的模板转换为使用你现有 CRM 数据生成的个性化文档。 使用 {{placeholders}} 一次性编写模板,然后即可为任意 Person 或 Company 一键生成已填充的文档——可从命令菜单、AI 代理或工作流中发起。
生成的销售提案文档

为特定人员生成的单个模板,以可打印页面的形式打开。

您将会学到什么

每一章都会增加一项功能。 在本教程结束时,您将接触到 SDK 的大部分内容。

先决条件

您应该已经完成了快速开始: 一个在端口 2020 上运行的本地 Twenty 服务器,以及已通过身份验证并连接到它的 CLI。 如果还没有,现在就创建并启动一个:
更想直接阅读完成版代码? 完整应用位于 packages/twenty-apps/examples/document-generator。 下面的每个代码片段都来自该应用。

应用如何协同运作

带有占位符的模板会被生成为一份带 PDF 的精美文档,可以通过命令菜单、AI 智能体、工作流或可分享链接来触发
您只需在富文本编辑器中编写一次模板,其中包含 {{placeholders}}。 选择一个 模板和一条 CRM 记录,就会填充占位符,并存储一份精美的 文档(带有一个 PDF 文件)。 其他所有内容——命令菜单、AI 智能体、工作流步骤、可分享链接——都只是触发同一个生成器的不同方式。

让这个循环持续运行

在整个教程期间,在一个终端中保持运行 yarn twenty dev。 每当您在 src/ 下添加或编辑文件时,它都会在几秒钟内重新同步到服务器,这样您就可以在构建的同时,在 UI 中看到每项功能逐步出现。

开始构建 →

第 1 章:为文档和模板建模。