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
| Campo | Significato |
|---|---|
trigger | Obbligatorio. Quando viene eseguito il flusso di lavoro. Vedi Trigger. |
description | A cosa serve il flusso di lavoro. |
activities | I passaggi. Vedi Attività. |
connections | Archi {from, to, label} che trasformano le attività in un grafo. __trigger__ è l'inizio e __emit__ la fine. |
emit | Eventi che questo flusso di lavoro annuncia quando termina: un elenco, oppure una stringa separata da virgole. Vedi Eventi. |
inputs | Valori 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. |
case | Rende 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.
| Input | Presente 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. |
inputs | Sempre. 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.
| Campo | Significato |
|---|---|
key | Obbligatorio. Percorsi puntati separati da virgole nei dati del trigger che identificano il soggetto, come contactEmail,email,phone. |
type | Il tipo di caso, come lead. I flussi di lavoro con lo stesso tipo condividono i casi. Predefinito il nome del flusso di lavoro. |
default_wait | Quanto 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.maxIterationsindichi 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_budgetdi 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.