NeboAI
NeboAI
Commencer

Flux de travail

Un workflow est un travail qu'un employé fait sans qu'on le lui demande : un résumé du matin, une réponse à chaque nouveau message, un rapport hebdomadaire. Chaque workflow associe un déclencheur aux activités que l'employé réalise. Les workflows se trouvent dans le fichier agent.json de l'employé : ils accompagnent le rôle.

Un premier workflow

Ajoutez une table workflows à agent.json. Chaque clé nomme un workflow ; chaque valeur contient un déclencheur et des activités.

{
  "workflows": {
    "morning-summary": {
      "trigger": { "type": "schedule", "cron": "0 8 * * 1-5" },
      "description": "Summarize yesterday's open conversations every weekday morning.",
      "activities": [
        { "id": "summarize", "intent": "Summarize yesterday's open customer conversations and what each one is waiting on." }
      ]
    }
  }
}

Ce workflow s'exécute à 08:00 les jours de semaine, à l'heure locale du bot. L'employé réalise l'activité avec sa propre personnalité, ses skills et ses connexions.

Champs d’un workflow

ChampSignification
triggerObligatoire. Quand le workflow s’exécute. Voir Déclencheurs.
descriptionÀ quoi sert le workflow.
activitiesLes étapes. Voir Activités.
connectionsArêtes {from, to, label} qui font des activités un graphe. __trigger__ est le départ et __emit__ la fin.
emitLes événements que ce workflow annonce quand il se termine : une liste, ou une chaîne séparée par des virgules. Voir Événements.
inputsValeurs transmises à chaque exécution.
budget{total_per_run, cost_estimate}. Dans une exécution en graphe, total_per_run plafonne les jetons de sortie ; sinon, les deux sont des estimations.
caseFait du workflow un dossier de longue durée par personne ou par objet. Voir Dossiers.

Un workflow avec un déclencheur et sans activités est valide. Une observation sans activités ne fait que relayer ses événements à d’autres workflows.

Comment se déroule une exécution

Sans connections, les activités s'exécutent dans l'ordre et l'employé réalise chacune d'elles. Le résultat de chaque activité est transmis à la suivante. Une activité sans sortie met fin à l'exécution.

Avec connections, les activités forment un graphe. Les branches s'exécutent en parallèle, et six types d'activités s'exécutent sans le modèle : condition, loop, wait, http, command et decide. Utilisez un graphe quand le routage doit être exact.

{
  "trigger": { "type": "watch", "plugin": "mail", "event": "email.new" },
  "activities": [
    { "id": "classify", "type": "decide",
      "params": {
        "questions": {
          "kind": {
            "type": "choice",
            "instructions": "What kind of message is this?",
            "criteria": { "invoice": "A bill from a vendor", "other": "Anything else" }
          }
        },
        "default": { "kind": "other" }
      } },
    { "id": "is-invoice", "type": "condition", "params": { "expression": "nodes.classify.kind.choice == invoice" } },
    { "id": "record", "intent": "Record the invoice in _watch_payload as a bill and note the due date." }
  ],
  "connections": [
    { "from": "__trigger__", "to": "classify" },
    { "from": "classify", "to": "is-invoice" },
    { "from": "is-invoice", "to": "record", "label": "True" },
    { "from": "record", "to": "__emit__" }
  ],
  "emit": ["invoice.recorded"]
}

Ce que reçoit une exécution

L'employé dispose toujours de sa personnalité et des réponses du propriétaire à ses questions inputs. Une exécution reçoit aussi ces valeurs, selon son déclencheur.

EntréePrésent quand
_event_source, _event_payload, _event_originUn déclencheur d’événement s’est activé. Les charges utiles de 8 KB ou plus sont réduites à leurs champs scalaires, en conservant les en-têtes des e-mails et les références aux pièces jointes.
_watch_payloadUn déclencheur watch ou folder s’est activé. Une ligne de la sortie de l’observateur, ou {files} pour un dossier.
inputsToujours. Les valeurs inputs propres au workflow.

Dossiers

Certains travaux s'étalent sur plusieurs jours : un prospect qui demande des relances, une demande en attente de documents. Ajoutez case et le workflow garde un dossier ouvert par personne ou par objet au lieu de repartir de zéro à chaque fois.

ChampSignification
keyObligatoire. Chemins à points séparés par des virgules, dans les données du déclencheur, qui identifient le sujet, par exemple contactEmail,email,phone.
typeLe type de dossier, par exemple lead. Les workflows de même type partagent leurs dossiers. Par défaut, le nom du workflow.
default_waitDurée d’attente quand un tour n’indique aucune attente : 3d, 12h, 45m. Trois jours par défaut.

Chaque tour d'un dossier doit se terminer par un objet JSON, sans rien après. result est l'état métier ; next indique au moteur s'il faut wait ou close. Une échéance s'exprime en RFC 3339 ou en durée relative. Tout le reste est un tour invalide.

{"result": {"status": "awaiting_documents", "summary": "Requested two bank statements"},
 "next":   {"action": "wait", "on": "signal", "deadline": "3d", "reason": "documents"}}

Limites et reprise

  • Chaque activité peut utiliser jusqu'à 50 tours de modèle, sauf indication contraire dans params.maxIterations.
  • Dans un graphe, une même activité peut s'exécuter au plus 10 000 fois par exécution.
  • Le plafond de dépenses fixé par le propriétaire pour l'employé arrête une exécution quand il est atteint. Le token_budget d'une activité est une estimation.
  • Une exécution interrompue par un redémarrage est marquée comme interrompue et reprise une fois.
  • L'employé peut mettre fin à une exécution plus tôt avec l'outil exit.

Exécuter et gérer les workflows

Le propriétaire peut lancer n'importe quel workflow à la main. Les employés gèrent les workflows avec run_workflow, workflow_status, list_workflow_runs, set_workflow_enabled et les autres outils de workflow listés sur Assistants et équipes.