NeboAI
NeboAI
Inizia

Flussi di lavoro

Un flusso di lavoro è un lavoro che un dipendente svolge senza che glielo si chieda: un riepilogo mattutino, una risposta a ogni nuovo messaggio, un report settimanale. Ogni flusso di lavoro abbina un trigger alle attività che il dipendente svolge. I flussi di lavoro si trovano nell'agent.json del dipendente, quindi viaggiano con il ruolo.

Un primo flusso di lavoro

Aggiungi una mappa workflows ad agent.json. Ogni chiave dà il nome a un flusso di lavoro; ogni valore ha un trigger e delle attività.

{
  "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." }
      ]
    }
  }
}

Questo flusso di lavoro viene eseguito alle 08:00 nei giorni feriali, nell'ora locale del bot. Il dipendente svolge l'attività con la propria persona, le proprie skill e le proprie connessioni.

Campi del flusso di lavoro

CampoSignificato
triggerObbligatorio. Quando viene eseguito il flusso di lavoro. Vedi Trigger.
descriptionA cosa serve il flusso di lavoro.
activitiesI passaggi. Vedi Attività.
connectionsArchi {from, to, label} che trasformano le attività in un grafo. __trigger__ è l'inizio e __emit__ la fine.
emitEventi che questo flusso di lavoro annuncia quando termina: un elenco, oppure una stringa separata da virgole. Vedi Eventi.
inputsValori passati a ogni esecuzione.
budget{total_per_run, cost_estimate}. In un'esecuzione a grafo, total_per_run limita i token di output; altrimenti entrambi sono stime.
caseRende il flusso di lavoro un unico caso di lunga durata per persona o cosa. Vedi Casi.

Un flusso di lavoro con un trigger e senza attività è valido. Un watch senza attività si limita a inoltrare i suoi eventi ad altri flussi di lavoro.

Come viene eseguita un'esecuzione

Senza connections, le attività vengono eseguite in ordine e il dipendente svolge ciascuna di esse. Il risultato di ogni attività passa alla successiva. Un'attività senza output termina l'esecuzione.

Con connections, le attività formano un grafo. I rami vengono eseguiti in parallelo, e sei tipi di attività vengono eseguiti senza il modello: condition, loop, wait, http, command e decide. Usa un grafo quando l'instradamento deve essere esatto.

{
  "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"]
}

Cosa riceve un'esecuzione

Il dipendente ha sempre la sua persona e le risposte del proprietario alle domande dei suoi inputs. Un'esecuzione riceve anche questi valori, a seconda del suo trigger.

InputPresente quando
_event_source, _event_payload, _event_originÈ scattato un trigger di evento. I payload di 8 KB o più vengono ridotti ai loro campi scalari, mantenendo le intestazioni delle email e i riferimenti agli allegati.
_watch_payloadÈ scattato un trigger watch o di cartella. Una riga dell'output dell'osservatore, oppure {files} per una cartella.
inputsSempre. I valori inputs del flusso di lavoro stesso.

Casi

Alcuni lavori durano giorni: un contatto che richiede follow-up, una richiesta in attesa di documenti. Aggiungi case e il flusso di lavoro mantiene un caso aperto per persona o cosa invece di ricominciare da capo ogni volta.

CampoSignificato
keyObbligatorio. Percorsi puntati separati da virgole nei dati del trigger che identificano il soggetto, come contactEmail,email,phone.
typeIl tipo di caso, come lead. I flussi di lavoro con lo stesso tipo condividono i casi. Predefinito il nome del flusso di lavoro.
default_waitQuanto attendere quando un turno non indica un'attesa: 3d, 12h, 45m. Predefinito tre giorni.

Ogni turno di un caso deve terminare con un solo oggetto JSON e nient'altro dopo. result è lo stato aziendale; next dice al motore di wait o close. Una scadenza è in RFC 3339 o un intervallo relativo. Qualsiasi altra cosa è un turno non valido.

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

Limiti e ripristino

  • Ogni attività può richiedere fino a 50 turni del modello, a meno che params.maxIterations indichi diversamente.
  • In un grafo, un'attività può essere eseguita al massimo 10.000 volte in un'esecuzione.
  • Il limite di spesa del proprietario per il dipendente interrompe un'esecuzione quando viene raggiunto. Il token_budget di un'attività è una stima.
  • Un'esecuzione interrotta da un riavvio viene contrassegnata come interrotta e ripresa una volta.
  • Il dipendente può terminare un'esecuzione in anticipo con lo strumento exit.

Esegui e gestisci i flussi di lavoro

Il proprietario può eseguire a mano qualsiasi flusso di lavoro. I dipendenti gestiscono i flussi di lavoro con run_workflow, workflow_status, list_workflow_runs, set_workflow_enabled e gli altri strumenti per i flussi di lavoro elencati in Aiutanti e team.