メインコンテンツへスキップ
Twenty アプリの ロジックレイヤー は、実行される コードです。HTTP リクエスト、cron スケジュール、レコードの変更に反応するサーバーサイドの TypeScript ハンドラー、ワークスペース内で動作する AI スキルとエージェント、そして関数がサードパーティサービス上でユーザーに代わって動作できるようにする OAuth 接続が含まれます。
            ┌─ HTTP route      ──┐
            │  Cron schedule     │
            │  Database event    │      ┌────────────────────┐
  triggers ─┤  AI tool call      ├─────▶│ Logic function     │
            │  Workflow action   │      │ (your handler)     │
            │  Manual exec       │      └────────────────────┘
            └────────────────────┘                │

                                  ┌────────────────────────────┐
                                  │ Twenty API (records)       │
                                  │ Third-party API            │
                                  │   (via Connection token)   │
                                  └────────────────────────────┘

このセクションについて

ロジック関数

コアとなる構成要素 — トリガーの種類、ペイロード、および型付き API クライアント。

スキルとエージェント

再利用可能な AI エージェント向けの指示や、カスタムのシステムプロンプトを備えたアシスタント。

接続

Linear、GitHub、Slack など、サードパーティサービス向けにアプリが保持する OAuth 資格情報。

トリガータイプの概要

ロジック関数は 1 つ以上のトリガーを選択します。以下の各項目は、defineLogicFunction() 上の個別のフィールドです。
トリガー実行タイミング設定
HTTP ルートリクエストが /s/\<path> エンドポイントに到達したときhttpRouteTriggerSettings
クロンCRON 式が一致したときcronTriggerSettings
データベースイベントワークスペースのレコードが作成、更新、または削除されたときdatabaseEventTriggerSettings
AI ツールTwenty の AI 機能が関数を呼び出すことを決定したときtoolTriggerSettings
ワークフローアクションワークフローステップが関数を呼び出したときworkflowActionTriggerSettings
関数は分離された Node.js プロセス内でサンドボックス実行され、defineApplication() で宣言されたロールにスコープされた型付き API クライアントを通じてワークスペースにアクセスします。
インストール時フック — インストールの前後に実行されるコード — はこのランタイムを共有しますが、独自の define 関数を使用し、Config → Install Hooks の下に配置されます。