Перейти к основному содержанию
Логический слой приложения 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Срабатывает выражение CRONcronTriggerSettings
Событие базы данныхЗапись рабочего пространства создается, обновляется или удаляетсяdatabaseEventTriggerSettings
Инструмент ИИВозможность Twenty AI решает вызвать вашу функциюtoolTriggerSettings
Действие рабочего процессаШаг рабочего процесса вызывает вашу функциюworkflowActionTriggerSettings
Функции выполняются в изолированных процессах Node.js в песочнице и получают доступ к рабочему пространству через типизированный клиент API с областью действия, ограниченной ролью, объявленной в defineApplication().
Хуки времени установки — код, который выполняется до или после установки, — используют то же окружение выполнения, но свои собственные функции define* и находятся в разделе Config → Install Hooks.