Flow

Usa questa pagina per consultare input, nodi, archi e budget di esecuzione di un flow.

Il manifest Flow: l'involucro (apiVersion, kind, metadata; vedi Manifest) più spec.

Campi

FlowSpec (spec)

Campo	Tipo	Predefinito	Significato
input	FlowInput	required	L'input da cui parte il ticket.
nodes	dict[str, FlowNode]	required	I nodi del flow, per id.
edges	list[FlowEdge]	required	Gli archi del flow.
requiresWorkspace	none or folder or git	none	Dove lavora il flow.
budget	Budget	Budget()	I tetti di budget del flow.
alerts	list[float]	[0.75, 0.9]	Le frazioni di budget alle quali avvisare una persona.
humanReminder	duration or null	12:00:00	Ricorda una richiesta umana senza risposta dopo questo tempo; null lo spegne.

FlowInput (spec.input)

Campo	Tipo	Predefinito	Significato
artifact	str	required	Lo Schema dell'input del ticket.

FlowNode (spec.nodes)

Campo	Tipo	Predefinito	Significato
type	str	required	Il tipo del nodo: agent, script, human, lane, map o quello di un plugin.
agent	str or null	null	agent: il manifest Agent che il nodo esegue.
run	str or null	null	script: il comando, oppure un nome built-in.
message	str or null	null	human: ciò che il nodo chiede alla persona.
actions	list[str]	[]	human: le risposte che il nodo offre.
requireComment	list[str]	[]	human: le azioni che richiedono un commento con la risposta.
attachFiles	bool	False	human: se la risposta può allegare file.
uses	str or null	null	lane: il manifest Lane che il nodo esegue.
with	dict[str, str]	{}	lane: i parametri passati alla lane, per nome.
over	str or null	null	map: l'artefatto sui cui elementi il nodo ripete.
lane	str or null	null	map: il manifest Lane eseguito una volta per elemento.
itemAs	str or null	null	map: il nome che ogni elemento prende dentro la lane.
maxItems	int or null	null	map: il numero massimo di elementi da eseguire.
maxParallel	int or null	null	map: quanti elementi eseguire insieme.
writes	str or null	null	script/human: lo Schema dell'artefatto che il nodo scrive.

FlowEdge (spec.edges)

Campo	Tipo	Predefinito	Significato
from	str or list[str]	required	Il nodo sorgente, o più di uno per lo stesso target.
to	str or null	null	Il nodo target, quando l'arco va verso uno solo.
when	str or null	null	Un'espressione Python sugli artefatti; l'arco si prende quando è vera.
choose	list[str] or null	null	I nodi tra cui l'agente può scegliere, quando l'arco si dirama.
join	str or null	null	Il nodo dove i rami paralleli si uniscono.
min	int or null	null	Quanti nodi di choose l'agente deve scegliere.
feedback	bool	False	Se il target vede l'artefatto della sorgente come feedback.
newRound	bool	False	Se prendere l'arco inizia un nuovo round.
maxRounds	int or null	null	Il numero massimo di volte che l'arco si può prendere; obbligatorio per un arco di feedback.

Budget (spec.budget)

Campo	Tipo	Predefinito	Significato
tokens	int or null	null	Il tetto di token.
toolCalls	int or null	null	Il tetto di chiamate ai tool.
costUsd	float or null	null	Il tetto di costo in dollari USA.
wallTime	duration or null	null	Il tetto di tempo reale.
maxTurns	int or null	null	Il tetto di turni.

Vedi anche

• Lane per i sotto-flow riutilizzabili.
• Schema per i campi degli artefatti.
• Agent per la configurazione dei nodi agent.