Vai al contenuto principale
Il livello logico di un’app Twenty è il codice che viene eseguito — handler TypeScript lato server che reagiscono a richieste HTTP, pianificazioni cron e modifiche ai record; skill e agenti di AI che vivono all’interno dello spazio di lavoro; e connessioni OAuth che permettono alle tue funzioni di agire per conto dell’utente in servizi di terze parti.
            ┌─ 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 questa sezione

Funzioni logiche

Il blocco di base — tipi di trigger, payload e client API tipizzato.

Skill e agenti

Istruzioni riutilizzabili per agenti AI e assistenti con prompt di sistema personalizzati.

Connessioni

Credenziali OAuth che la tua app detiene per servizi di terze parti — Linear, GitHub, Slack e altri.

Tipi di trigger in sintesi

Una funzione logica sceglie uno o più trigger — ogni voce qui sotto è un campo separato su defineLogicFunction():
ScatenanteQuando viene eseguitoImpostazione
Route HTTPUna richiesta raggiunge il tuo endpoint /s/\<path>httpRouteTriggerSettings
CronViene soddisfatta un’espressione CRONcronTriggerSettings
Evento databaseUn record dello spazio di lavoro viene creato, aggiornato o eliminatodatabaseEventTriggerSettings
Strumento AIUna funzionalità AI di Twenty decide di chiamare la tua funzionetoolTriggerSettings
Azione del workflowUno step di workflow richiama la tua funzioneworkflowActionTriggerSettings
Le funzioni vengono eseguite in sandbox in processi Node.js isolati e accedono allo spazio di lavoro tramite un client API tipizzato, limitato al ruolo dichiarato su defineApplication().
Hook di installazione — codice che viene eseguito prima o dopo l’installazione — condividono questo runtime ma usano le proprie funzioni define e risiedono in Config → Install Hooks.