Champs
{
"id": "draft-reply",
"label": "Draft the reply",
"intent": "Draft a reply to the customer message in _watch_payload using the reply-drafting skill.",
"skills": ["reply-drafting"],
"requires_tools": ["mail_message_send"],
"on_error": { "retry": 1, "fallback": "notify_owner" }
} | Champ | Par défaut | Signification |
|---|---|---|
id | obligatoire | Unique au sein du workflow. Utilisé dans connections et dans les chemins de données. |
type | custom | Une étape de l’employé, ou l’un de condition, loop, wait, http, command, decide. |
intent | aucun | Ce que l’employé doit accomplir. Une étape de l’employé nécessite intent ou steps. |
steps | [] | Des instructions ordonnées, quand une phrase ne suffit pas. |
label | aucun | Nom affiché au propriétaire. |
skills | [] | Skills à utiliser. Les skills de la boutique listés ici sont installés avec l’employé. |
tools | [] | Quand il est défini, les seuls outils que l’étape peut utiliser. |
requires_tools | [] | Outils qui doivent réussir pour que l’étape compte comme terminée. |
cmds | [] | Commandes de plugin désignées pour l’étape. |
mcps | [] | Serveurs MCP désignés pour l’étape. |
model | aucun | Un identifiant de modèle pour cette étape. |
params | aucun | Paramètres des activités typées, et maxIterations pour les étapes de l’employé. |
min_iterations | aucun | Nombre minimum de tours de modèle avant que l’étape puisse se terminer. |
token_budget | aucune | {max}. Une estimation. |
on_error | {retry: 1, fallback: notify_owner} | Nouvelles tentatives, puis la solution de repli. Tout échec après les nouvelles tentatives met fin à l’exécution. |
Étapes de l’employé
Une étape de l'employé s'exécute comme un tour de l'employé : sa personnalité, sa mémoire et ses connexions s'appliquent, et elle peut utiliser jusqu'à 50 tours de modèle, ou params.maxIterations. Les résultats des étapes précédentes lui sont transmis sous forme de blocs [Activity 'id' result]. L'étape qui termine un workflow doté d'une liste emit reçoit la consigne d'appeler emit_event avec ces événements. L'outil exit est toujours disponible pour mettre fin à l'exécution.
Le contexte de données
Les activités typées lisent les valeurs par chemin à points dans un seul objet : inputs contient les entrées de l'exécution, nodes.<id> contient la sortie de chaque activité terminée (analysée en JSON quand c'est du JSON), et item contient l'élément en cours dans une boucle. Un chemin seul est cherché dans inputs, puis dans nodes.
condition
{ "id": "large", "type": "condition", "params": { "expression": "inputs.amount >= 500" } } params.expression est obligatoire. Ses connexions sortantes sont libellées True et False. params.mode choisit la façon de la lire :
| Mode | Expression |
|---|---|
expression | Par défaut. path op value avec ==, !=, >=, <=, > ou <, comparés comme nombres quand les deux côtés sont des nombres ; ou un chemin seul, vrai quand sa valeur est évaluée comme vraie. |
exists | Un chemin ; vrai quand il aboutit à une valeur évaluée comme vraie. |
contains | path contains text, ou un texte seul comparé à la sortie précédente. |
regex | Un motif comparé à la sortie précédente. |
loop
{ "id": "each-invoice", "type": "loop", "params": { "source": "nodes.fetch.invoices", "concurrency": 4 } } params.source est le chemin d'une liste. La connexion libellée Each item mène au corps, qui s'exécute une fois par élément avec item défini ; celle libellée Done s'exécute après tous les éléments. Les itérations démarrent ensemble, sauf si vous définissez concurrency. maxIterations et batchSize sont aussi acceptés.
"connections": [
{ "from": "__trigger__", "to": "fetch" },
{ "from": "fetch", "to": "each-invoice" },
{ "from": "each-invoice", "to": "check", "label": "Each item" },
{ "from": "each-invoice", "to": "report", "label": "Done" }
] wait, http et command
{ "id": "pause", "type": "wait", "params": { "duration": "5m" } }
{ "id": "status", "type": "http", "params": { "url": "https://status.example.com/api", "method": "GET" } }
{ "id": "export", "type": "command", "params": { "command": "date -u" } } | Type | Obligatoire | Comportement |
|---|---|---|
wait | params.duration | Fait une pause pendant une durée en s, m ou h. Il n’existe pas d’attente jusqu’à une date ; pour reprendre sur un événement, déclenchez un second workflow sur cet événement. |
http | params.url | Effectue la requête. method, headers et body sont facultatifs. |
command | params.command | Exécute une commande shell. Sa stdout constitue la sortie de l’activité. |
decide
Une activité decide pose des questions typées sur le travail effectué jusqu'ici et enregistre des réponses structurées sur lesquelles une condition peut router.
{
"id": "triage",
"type": "decide",
"params": {
"questions": {
"urgency": { "type": "score", "instructions": "How urgent is this request?", "criteria": ["low", "normal", "high"] },
"refund": { "type": "noul", "instructions": "The customer is asking for money back." }
},
"default": { "urgency": "normal", "refund": false }
}
} | Type de question | criteria | Réponse |
|---|---|---|
choice | Objet associant chaque option à une description, de 2 à 255 options. | choice, confidence et probabilities. |
score | Liste de 2 à 10 niveaux ordonnés. | score à partir de 0 (premier niveau) et au-delà, et confidence. |
noul | Aucun. | noul, la probabilité que l’affirmation soit vraie. |
Routez selon une réponse avec une condition, par exemple nodes.triage.urgency.score >= 1.5. params.default donne la réponse sûre pour chaque question quand aucune décision ne peut être prise ; une réponse par défaut a une confiance de 0. Une question sans valeur par défaut n'obtient aucune réponse : les conditions qui portent sur elle prennent leur arête False.
Erreurs
on_error.retry définit combien de fois une activité en échec est relancée ; la valeur par défaut est 1. Après la dernière tentative, l'exécution s'arrête et, avec le fallback par défaut notify_owner, le propriétaire est prévenu. Nebo vérifie les paramètres obligatoires de chaque activité typée au démarrage de l'exécution, et refuse une branche qui pointe vers une activité inconnue.