Genel Bakış

Bir Twenty uygulamasının mantık katmanı, çalışan koddur — HTTP isteklerine, cron zamanlamalarına ve kayıt değişikliklerine tepki veren sunucu tarafı TypeScript işleyicileri; çalışma alanının içinde yaşayan yapay zeka yetenekleri ve ajanları; ve işlevlerinizin üçüncü taraf servislerde bir kullanıcının adına hareket etmesini sağlayan OAuth bağlantıları.

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

Bu bölümde

Mantıksal işlevler

Temel yapı taşı — tetikleyici türleri, payload’lar ve tür güvenli API istemcisi.

Beceriler ve Ajanlar

Yeniden kullanılabilir yapay zeka ajan yönergeleri ve özel sistem istemlerine sahip asistanlar.

Bağlantılar

Uygulamanızın üçüncü taraf servisler — Linear, GitHub, Slack ve daha fazlası — için tuttuğu OAuth kimlik bilgileri.

Anahtar-Değer Deposu

Mantık fonksiyonu çalıştırmaları arasında durumu kalıcı hale getirin — önbellekler, imleçler ve çalışma alanları arası beyanlar.

Arka Plan İşleri

Çalıştırma başına zaman aşımı sınırını aşmak için işçi süreçlerde çalıştırılacak bir mantık işlevini kuyruğa alın.

Tetikleyici türlerine genel bakış

Bir mantık fonksiyonu bir veya daha fazla tetikleyici seçer — aşağıdaki her giriş, defineLogicFunction() üzerinde ayrı bir alandır:

Tetikleyici	Ne zaman çalışır	Ayar
HTTP rotası	Bir istek `/s/\<path>` endpoint’inize ulaşır	`httpRouteTriggerSettings`
Cron	Bir CRON ifadesi eşleştiğinde	`cronTriggerSettings`
Veritabanı olayı	Bir çalışma alanı kaydı oluşturulduğunda, güncellendiğinde veya silindiğinde	`databaseEventTriggerSettings`
Yapay zeka aracı	Bir Twenty yapay zeka özelliği, fonksiyonunuzu çağırmaya karar verdiğinde	`toolTriggerSettings`
İş Akışı Aksiyonu	Bir iş akışı adımı fonksiyonunuzu çağırdığında	`workflowActionTriggerSettings`

Fonksiyonlar, izole Node.js süreçlerinde sandbox içinde çalışır ve çalışma alanına, defineApplication() üzerinde beyan edilen role göre kapsamlandırılmış tür güvenli bir API istemcisi aracılığıyla erişir.

Yükleme zamanı kancaları — yüklemeden önce veya sonra çalışan kod — bu çalışma zamanını paylaşır ancak kendi define fonksiyonlarını kullanır ve Config → Install Hooks altında bulunur.

Uygulamalar

API

Kendi Kendine Barındırma

Katkıda Bulunun

Genel Bakış

Bu bölümde

Mantıksal işlevler

Beceriler ve Ajanlar

Bağlantılar

Anahtar-Değer Deposu

Arka Plan İşleri

Tetikleyici türlerine genel bakış

​Bu bölümde

Mantıksal işlevler

Beceriler ve Ajanlar

Bağlantılar

Anahtar-Değer Deposu

Arka Plan İşleri

​Tetikleyici türlerine genel bakış

Bu bölümde

Tetikleyici türlerine genel bakış