Übersicht

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.

Hintergrundjobs

Reihen Sie die Ausführung einer Logikfunktion in die Warteschlange der Worker ein, um das Timeout je Ausführung zu umgehen.

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.

Apps

API

Selbsthosting

Mitwirken

Übersicht

In diesem Abschnitt

Logikfunktionen

Skills & Agenten

Verbindungen

Key-Value-Store

Hintergrundjobs

Auslösertypen im Überblick

​In diesem Abschnitt

Logikfunktionen

Skills & Agenten

Verbindungen

Key-Value-Store

Hintergrundjobs

​Auslösertypen im Überblick

In diesem Abschnitt

Auslösertypen im Überblick