الانتقال إلى المحتوى الرئيسي
طبقة المنطق في تطبيق Twenty هي الشيفرة التي تعمل — معالِجات TypeScript على جانب الخادم تستجيب لطلبات HTTP، وجداول كرون، وتغييرات السجلات؛ ومهارات ووكلاء الذكاء الاصطناعي التي تعمل داخل مساحة العمل؛ واتصالات OAuth التي تتيح لدوالّك العمل نيابةً عن المستخدم في الخدمات الخارجية.
            ┌─ 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)   │
                                  └────────────────────────────┘

في هذا القسم

الوظائف المنطقية

لبنة البناء الأساسية — أنواع المشغلات، والحمولات، وعميل واجهة برمجة التطبيقات ذو الأنواع.

المهارات والوكلاء

تعليمات قابلة لإعادة الاستخدام لوكلاء الذكاء الاصطناعي ومساعدين مع مطالبات نظام مخصّصة.

الاتصالات

بيانات اعتماد OAuth التي يحتفظ بها تطبيقك للخدمات الخارجية — مثل Linear وGitHub وSlack وغيرها.

لمحة عن أنواع المشغلات

دالة المنطق تختار واحدًا أو أكثر من المشغلات — كل إدخال أدناه هو حقل منفصل في defineLogicFunction():
المشغّلمتى يعملالإعداد
مسار HTTPطلب يضرب عنوان URL العام لوظيفتكhttpRouteTriggerSettings
كرونعند تطابق تعبير CRONcronTriggerSettings
حدث قاعدة البياناتيتم إنشاء سجل في مساحة العمل أو تحديثه أو حذفهdatabaseEventTriggerSettings
أداة ذكاء اصطناعيميزة ذكاء اصطناعي في Twenty تقرر استدعاء دالتكtoolTriggerSettings
إجراء سير العملتستدعي خطوة في سير العمل دالتكworkflowActionTriggerSettings
تعمل الدوال ضمن عمليات Node.js معزولة، وتصل إلى مساحة العمل عبر عميل واجهة برمجة تطبيقات مضبوط الأنواع ومحدّد النطاق بالدور المصرّح عنه في defineApplication().
خطافات وقت التثبيت — الشيفرة التي تعمل قبل التثبيت أو بعده — تشارك بيئة التشغيل هذه ولكنها تستخدم دوال تعريف خاصة بها وتوجد ضمن Config → Install Hooks.