> ## Documentation Index
> Fetch the complete documentation index at: https://docs.upshiftcloud.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Vue d'ensemble

> TypeScript côté serveur qui s’exécute dans Upshift — déclenché par des routes HTTP, des planifications CRON, des événements de base de données, des outils d’IA ou des actions de flux de travail.

La **couche logique** d’une application Upshift est le code qui *s’exécute* — des gestionnaires TypeScript côté serveur qui réagissent aux requêtes HTTP, aux planifications CRON et aux modifications d’enregistrements ; des compétences et des agents d’IA qui résident dans l’espace de travail ; et des connexions OAuth qui permettent à vos fonctions d’agir au nom d’un utilisateur dans des services tiers.

```text theme={null}
            ┌─ HTTP route      ──┐
            │  Cron schedule     │
            │  Database event    │      ┌────────────────────┐
  triggers ─┤  AI tool call      ├─────▶│ Logic function     │
            │  Workflow action   │      │ (your handler)     │
            │  Manual exec       │      └────────────────────┘
            └────────────────────┘                │
                                                  ▼
                                  ┌────────────────────────────┐
                                  │ Upshift API (records)      │
                                  │ Third-party API            │
                                  │   (via Connection token)   │
                                  └────────────────────────────┘
```

## Dans cette section

> **[Fonctions logiques](https://docs.upshiftcloud.com/developers/extend/apps/logic/logic-functions.md)**
>
> Le bloc de construction principal — types de déclencheurs, charges utiles et client API typé.

> **[Compétences et agents](https://docs.upshiftcloud.com/developers/extend/apps/logic/skills-and-agents.md)**
>
> Instructions d’agent IA réutilisables et assistants avec invites système personnalisées.

> **[Connexions](https://docs.upshiftcloud.com/developers/extend/apps/logic/connections.md)**
>
> Identifiants OAuth détenus par votre application pour des services tiers — Linear, GitHub, Slack, et plus encore.

> **[Stockage clé-valeur](https://docs.upshiftcloud.com/developers/extend/apps/logic/key-value-store.md)**
>
> Conservez l’état entre les exécutions de fonctions logiques — caches, curseurs et revendications inter-espaces de travail.

> **[Tâches en arrière-plan](https://docs.upshiftcloud.com/developers/extend/apps/logic/background-jobs.md)**
>
> Mettez en file d’attente l’exécution d’une fonction logique sur les workers afin de contourner la limite de temps par exécution.

## Aperçu des types de déclencheurs

Une fonction logique choisit un ou plusieurs déclencheurs — chaque entrée ci-dessous est un champ distinct sur `defineLogicFunction()`:

| Déclencheur | Moment d’exécution | Paramètre |
| - | - | - |
| **Route HTTP** | Une requête atteint votre point de terminaison `/s/\<path>` | `httpRouteTriggerSettings` |
| **Cron** | Une expression CRON correspond | `cronTriggerSettings` |
| **Événement de base de données** | Un enregistrement de l’espace de travail est créé, mis à jour ou supprimé | `databaseEventTriggerSettings` |
| **Outil IA** | Une fonctionnalité IA de Upshift décide d’appeler votre fonction | `toolTriggerSettings` |
| **Action de flux de travail** | Une étape de flux de travail invoque votre fonction | `workflowActionTriggerSettings` |

Les fonctions s’exécutent dans un environnement isolé dans des processus Node.js sandboxés et accèdent à l’espace de travail via un client API typé, limité au rôle déclaré sur [`defineApplication()`](https://docs.upshiftcloud.com/developers/extend/apps/config/application).

> [!NOTE]
>
> Les **hooks au moment de l’installation** — du code qui s’exécute avant ou après l’installation — partagent ce runtime mais utilisent leurs propres fonctions define et se trouvent sous [Config → Install Hooks](https://docs.upshiftcloud.com/developers/extend/apps/config/install-hooks.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.