NeboAI
NeboAI
Commencer

Activités

Une activité est une étape d'un workflow. La plupart des activités sont réalisées par l'employé : vous énoncez l'intention et il fait le travail avec ses skills et ses connexions. Six types s'exécutent sans le modèle, pour que le routage et la synchronisation restent exacts.

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" }
}
ChampPar défautSignification
idobligatoireUnique au sein du workflow. Utilisé dans connections et dans les chemins de données.
typecustomUne étape de l’employé, ou l’un de condition, loop, wait, http, command, decide.
intentaucunCe 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.
labelaucunNom 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.
modelaucunUn identifiant de modèle pour cette étape.
paramsaucunParamètres des activités typées, et maxIterations pour les étapes de l’employé.
min_iterationsaucunNombre minimum de tours de modèle avant que l’étape puisse se terminer.
token_budgetaucune{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 :

ModeExpression
expressionPar 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.
existsUn chemin ; vrai quand il aboutit à une valeur évaluée comme vraie.
containspath contains text, ou un texte seul comparé à la sortie précédente.
regexUn 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" } }
TypeObligatoireComportement
waitparams.durationFait 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.
httpparams.urlEffectue la requête. method, headers et body sont facultatifs.
commandparams.commandExé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 questioncriteriaRéponse
choiceObjet associant chaque option à une description, de 2 à 255 options.choice, confidence et probabilities.
scoreListe de 2 à 10 niveaux ordonnés.score à partir de 0 (premier niveau) et au-delà, et confidence.
noulAucun.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.