Format JSON

Objet Étape

Une action du processus : son identifiant, son type, son libellé et ses propriétés.

Une étape est un élément du tableau steps d'un package. Son type détermine ce qu'elle fait et les propriétés qu'elle accepte.

Synopsis

{
  "id": "classer",
  "type": "ai.classify",
  "label": "Classer la dépense",
  "props": {
    "input": "{{facture.objet}}",
    "labels": "Informatique, Fournitures, Prestation de service",
    "into": "categorie"
  }
}

Propriétés

Propriété	Type	Requis	Description
`id`	chaîne	recommandé	Identifiant unique dans le package. Utilisé par Studio (coloration en direct), le journal, les captures et la reprise. Généré (7 caractères) s'il manque ou s'il est en double.
`type`	chaîne	oui	Un des 42 types d'étapes, sous la forme `famille.action`.
`label`	chaîne	recommandé	Libellé métier affiché dans Studio, le journal et les messages d'erreur (« Échec à « libellé » : … »). Défaut : nom du type.
`props`	objet	oui	Paramètres propres au type. Toutes les valeurs sont des chaînes.

Règles des propriétés (`props`)

Chaînes uniquement. Nombres, booléens et JSON s'écrivent en texte : "count": "4", "html": "false", "args": "{\"q\": \"{{client}}\"}".
Interpolation. Toute valeur peut contenir {{variable}} ou {{objet.champ}}. Voir Expressions.
Propriétés connues seulement. Une propriété absente de la fiche du type est ignorée (avertissement à l'import).
Valeurs énumérées. Une valeur hors liste est remplacée par la valeur par défaut (flow.if.otherwise → skip, log.write.level → info).
Obligatoires. Une propriété obligatoire vide après interpolation fait échouer l'étape avant toute action.
into. Nomme la variable de résultat, sans accolades. Même règle pour list (flow.foreach), message (mail.attachments) et item (files).

Où s'exécute une étape

Exécutant	Types	Conséquence
Robot	`web.`, `ui.`, `file.`, `app.open`, `desktop.`, `http.call`, `cmd.run`	agit sur le poste ou le navigateur du robot choisi ; capture d'écran possible
Orchestrator	`data.`, `ai.`, `doc.extract`, `mail.`, `queue.`, `mcp.call`, `flow.*`, `log.write`	n'utilise pas l'écran du robot
Humain	`human.approve`, `human.form`	suspend le job jusqu'à la réponse

Voir aussi

Source : orchestrator/zokas_orch/scenario.py — STEP_TYPES, validate() ; orchestrator/zokas_orch/runtime.py — PackageRunner.

Mis à jour le 28 octobre 2026