Créer des processus

Ajouter un processus à l'Orchestrator

Importer un fichier .zokas.json, le publier depuis Studio ou par l'API, et gérer ses versions.

Un processus n'est lançable qu'une fois publié dans l'Orchestrator. La publication enregistre le package complet ; son nom sert d'identifiant fonctionnel.

Depuis Studio

Ouvrez le fichier .zokas.json (⌘O) ou créez le processus.
Vérifiez name, version et description dans les propriétés du processus.
Choisissez Publier (⇧⌘P).

Le processus apparaît dans ZOKAS Agent › Processus, rangé dans son projet.

Par l'API

Envoyez le package tel quel dans le corps de POST /processes :

curl -X POST http://localhost:17880/processes \
  -H "X-ZOKAS-Key: $ZOKAS_API_KEY" \
  -H "Content-Type: application/json" \
  --data @examples/factures.zokas.json

Réponse :

{ "id": "P-4f2a91", "name": "Traitement des factures fournisseurs", "version": "1.0.0", "project_id": null }

Le paramètre de requête facultatif project_id range le processus dans un projet. Voir API de l'Orchestrator.

Mettre à jour un processus

Publiez de nouveau un package portant le même name : l'Orchestrator remplace le contenu, conserve l'identifiant, la date de création et le projet. Les déclencheurs associés utilisent immédiatement la nouvelle version.

Incrémentez version à chaque publication (version sémantique : 1.4.0 → 1.4.1 pour une correction, 1.5.0 pour une évolution). L'Orchestrator l'affiche, mais ne compare pas les versions.

Ranger dans un projet

Ajoutez "project": "Comptabilité fournisseurs" au package : le projet est créé s'il n'existe pas. Sans ce champ, une mise à jour garde le projet actuel.

Vérifier avant de publier

Le fichier respecte le Schéma JSON.
Chaque action irréversible est précédée d'une human.approve.
Aucun secret n'apparaît dans variables ni dans props.
Le processus a été simulé, puis exécuté une fois sur un environnement de test.

Voir aussi la liste complète dans Bonnes pratiques d'écriture.

Mis à jour le 28 octobre 2026