Übersicht

Serverseitiges TypeScript, das innerhalb von Twenty ausgeführt wird – ausgelöst durch HTTP-Routen, Cron-Zeitpläne, Datenbankereignisse, KI-Tools oder Workflow-Aktionen.

Die Logikschicht einer Twenty-App ist der Code, der ausgeführt wird – serverseitige TypeScript-Handler, die auf HTTP-Anfragen, Cron-Zeitpläne und Datensatzänderungen reagieren; KI-Skills und -Agenten, die innerhalb des Workspaces leben; und OAuth-Verbindungen, die es Ihren Funktionen ermöglichen, im Namen eines Benutzers in Drittanbieterdiensten zu agieren.

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

​

In diesem Abschnitt

Logikfunktionen

Der zentrale Baustein – Auslösertypen, Payloads und der typisierte API-Client.

Skills & Agenten

Wiederverwendbare Anweisungen für KI-Agenten und Assistenten mit benutzerdefinierten System-Prompts.

Verbindungen

OAuth-Anmeldedaten, die Ihre App für Dienste von Drittanbietern verwaltet – Linear, GitHub, Slack und mehr.

Key-Value-Store

Zustand zwischen Ausführungen von Logikfunktionen beibehalten — Caches, Cursor und arbeitsbereichsübergreifende Claims.

​

Auslösertypen im Überblick

Eine Logikfunktion wählt einen oder mehrere Auslöser – jeder Eintrag unten ist ein eigenes Feld auf defineLogicFunction():

Auslöser	Wann sie ausgeführt wird	Einstellung
HTTP-Route	Eine Anfrage erreicht Ihren /s/\<path>-Endpunkt	httpRouteTriggerSettings
Cron	Ein CRON-Ausdruck trifft zu	cronTriggerSettings
Datenbankereignis	Ein Workspace-Datensatz wird erstellt, aktualisiert oder gelöscht	databaseEventTriggerSettings
KI-Tool	Eine Twenty-KI-Funktion entscheidet sich, Ihre Funktion aufzurufen	toolTriggerSettings
Workflow-Aktion	Ein Workflow-Schritt ruft Ihre Funktion auf	workflowActionTriggerSettings

Funktionen werden in isolierten Node.js-Prozessen in einer Sandbox ausgeführt und greifen über einen typisierten API-Client, der auf die in defineApplication() deklarierte Rolle beschränkt ist, auf den Workspace zu.

Installations-Hooks – Code, der vor oder nach der Installation ausgeführt wird – teilen sich diese Laufzeitumgebung, verwenden jedoch eigene Define-Funktionen und befinden sich unter Config → Install Hooks.