概要 - Twenty Documentation

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 の下に配置されます。

概要

アプリ

API

セルフホスト

貢献

概要

このセクションについて

ロジック関数

スキルとエージェント

接続

トリガータイプの概要

​このセクションについて

ロジック関数

スキルとエージェント

接続

​トリガータイプの概要

このセクションについて

トリガータイプの概要