Passa al contenuto principale

Semantica dei flow

Cos'è un ticket, e come il motore guida il turno di un agente senza mai parlare da sé con un modello.

Un ticket è un'esecuzione di un flow. Il motore lo avvia dall'ingresso del flow, esegue i nodi seguendo gli archi e si ferma quando il flow arriva a END o quando serve una persona.

Agenti e harness​

Il motore non parla mai direttamente con un modello. Per ogni turno di un agente manda a un harness una richiesta con:

  • il prompt dell'agente, seguito da un preambolo del motore.
  • gli artefatti che l'agente dichiara in reads.
  • il feedback indirizzato a lui.
  • il JSON Schema di ciò che deve scrivere.

L'harness riporta ogni chiamata al modello e ogni tool call al ledger del motore, che risponde continue, hold, pause o stop. Quando un turno va in pausa, il motore lo riprende più avanti dal token di ripresa dell'harness, così nessuna chiamata già pagata viene ripetuta.

Lane e map​

  • Un nodo lane esegue un sotto-flusso su una lavagna tutta sua. I suoi output escono con i nomi esterni (impl.{scope} → impl.api).
  • Un nodo map esegue una lane una volta per ogni elemento di una lista, fino a maxItems elementi e non più di maxParallel alla volta. Gli artefatti di ogni ramo escono come nome.0, nome.1…, e un agente li legge tutti con nome.*.

Vedi anche​