Обзор

Логический слой приложения Twenty — это код, который выполняется: серверные обработчики TypeScript, реагирующие на HTTP-запросы, расписания cron и изменения записей; навыки ИИ и агенты, работающие внутри рабочего пространства; а также 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)   │
                                  └────────────────────────────┘

В этом разделе

Логические функции

Основной строительный блок — типы триггеров, полезные данные (payloads) и типизированный клиент API.

Навыки и агенты

Повторно используемые инструкции агента ИИ и ассистенты с пользовательскими системными подсказками.

Подключения

OAuth-учетные данные, которые ваше приложение хранит для сторонних сервисов — Linear, GitHub, Slack и других.

Типы триггеров вкратце

Логическая функция выбирает один или несколько триггеров — каждая запись ниже — это отдельное поле в defineLogicFunction():

Триггер	Когда запускается	Настройка
HTTP-маршрут	Запрос попадает на вашу конечную точку `/s/\<path>`	`httpRouteTriggerSettings`
Cron	Срабатывает выражение CRON	`cronTriggerSettings`
Событие базы данных	Запись рабочего пространства создается, обновляется или удаляется	`databaseEventTriggerSettings`
Инструмент ИИ	Возможность Twenty AI решает вызвать вашу функцию	`toolTriggerSettings`
Действие рабочего процесса	Шаг рабочего процесса вызывает вашу функцию	`workflowActionTriggerSettings`

Функции выполняются в изолированных процессах Node.js в песочнице и получают доступ к рабочему пространству через типизированный клиент API с областью действия, ограниченной ролью, объявленной в defineApplication().

Хуки времени установки — код, который выполняется до или после установки, — используют то же окружение выполнения, но свои собственные функции define* и находятся в разделе Config → Install Hooks.

Приложения

API

Самостоятельный хостинг

Внести вклад

Обзор

В этом разделе

Логические функции

Навыки и агенты

Подключения

Типы триггеров вкратце

​В этом разделе

Логические функции

Навыки и агенты

Подключения

​Типы триггеров вкратце

В этом разделе

Типы триггеров вкратце