Обзор

Что покрывает логический слой

Логический слой приложения Twenty — это код, который выполняется — серверные обработчики TypeScript, реагирующие на HTTP-запросы, расписания cron и изменения записей; навыки ИИ и агенты, работающие внутри рабочего пространства; подключения (OAuth или пользовательский процесс входа), позволяющие вашим функциям действовать от имени пользователя в сторонних сервисах; а также каналы обмена сообщениями, которые переносят внешний почтовый ящик в Twenty.

            ┌─ 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)   │
                                  └────────────────────────────┘

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

Logic Functions

Ключевой строительный блок — триггерные типы, полезные нагрузки и тип API клиента.

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

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

Рабочие процессы

Прошлые рабочие процессы, установленные в вашем приложении: триггеры, шаги и как они выполняются.

Подключения

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

Каналы обмена сообщениями

Привлечение разговоров любого провайдера к записям Twenty’s Message and Message Thread — включая обсуждение и удаление дублирования.

Входящие

Отправляйте сообщения во входящие участников из логических функций и компонентов фронтенда.

Store Key-Value Store

Сохранять состояние между логическими функциями — кэш, курсоры и межрабочее пространство.

Фоновые задания

Вставить в очередь функции логики на работников, чтобы пройти тайм-аут каждого запуска.

Списание кредитов

Укажите, за что ваше приложение выставляет счета, и списывайте за это кредиты рабочего пространства.

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

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

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

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

Хуки времени установки — код, который выполняется до или после установки, — используют то же окружение выполнения, но свои собственные функции define* и находятся в разделе Config → Install Hooks.Проверка работоспособности также использует его совместно. Приложение объявляет одну проверку без триггера. По умолчанию Twenty вызывает свой обработчик без аргументов при открытии настроек приложения рабочего пространства. Установите runOnUserPreferences: true, чтобы вместо этого запускать его на странице настроек приложений участника с обязательным userWorkspaceId.

Разработчики

Приложения

API

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

Внести вклад

Библиотека интерфейса

Что покрывает логический слой

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

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

​Что покрывает логический слой

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

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

Что покрывает логический слой

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

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