メインコンテンツへスキップ
このチュートリアルでは、再利用可能なテンプレートを、既に CRM にあるデータを使ってパーソナライズされたドキュメントに変換するアプリ Document Generator を作成します。 一度テンプレートを作成し、{{placeholders}} を記述しておけば、コマンドメニュー、AI エージェント、またはワークフローからワンクリックで、任意の Person または Company 用の入力済みドキュメントを生成できます。
生成された営業提案書

学べること

各章で 1 つずつ機能を追加していきます。 最後には、SDK のほとんどの部分に触れ終えていることになります。
機能リファレンス
1. データモデルオブジェクト、フィールド、およびリレーションData
2. ドキュメント生成Markdown テンプレートを埋めて、整えられた PDF を添付するロジック関数(AI ツール + ワークフローアクション)ロジック関数
3. HTTP ルートルートから JSON と共有可能な HTML ページを配信するロジック関数
4. UI 構築ビュー、ナビゲーション、コマンドメニュー、ドキュメントのプレビューとテンプレート編集用のフロントエンドコンポーネントレイアウト
5. AI エージェントエージェント + スキルスキルとエージェント
6. 公開マーケットプレイスに公開する公開

前提条件

クイックスタートを完了している必要があります。 ローカルの Twenty サーバーがポート 2020 で動作しており、CLI がそのサーバーに対して認証済みになっている状態です。 まだであれば、今すぐスキャフォールドして起動してください:
npx create-twenty-app@latest document-generator
cd document-generator
yarn twenty dev
完成版のコードを読みたいですか? 完成したアプリは packages/twenty-apps/examples/document-generator にあります。 以下のすべてのスニペットは、そこからコピーしたものです。

アプリ全体の構成

プレースホルダー付きテンプレートが、コマンドメニュー、AI エージェント、ワークフロー、または共有可能なリンクからのトリガーによって、PDF 付きの整えられたドキュメントに生成されます
リッチテキストエディタで {{placeholders}} を使って テンプレート を一度作成します。 テンプレートと CRM レコードを選ぶと、プレースホルダーが埋められ、整えられた ドキュメント(PDF ファイル付き)が保存されます。 その他のもの — コマンドメニュー、AI エージェント、 ワークフローステップ、共有可能なリンク — はすべて、その 1 つのジェネレーターをトリガーする別々の手段にすぎません。

このループを動かし続ける

チュートリアル全体を通して、ターミナルで yarn twenty dev を実行したままにしておいてください。 src/ 配下のファイルを追加または編集するたびに、数秒以内にサーバーへ再同期されるため、ビルドしながら各機能が UI に現れていく様子を確認できます。

構築を開始する →

第 1 章: ドキュメントとテンプレートをモデリングする。