Agents

Agents è l'area runtime e release in /workflow-runtime. L'accesso alla route richiede workflow:read, salvo un ruolo con accesso completo.

Gestisce identità dell'Agent, contratti, strumenti, Releases immutabili, Rollouts, Rollback, esecuzioni, stato, collegamento alla policy e configurazione del campionamento. Il dettaglio dell'Agent ha le schede Definition, Releases, Runs, Log, Sampling e Policy.

flowchart LR
  D["Configurazione bozza"] --> V["Validazione"]
  V --> R["Release immutabile"]
  R --> O["Rollout"]
  O --> E["Esecuzioni"]
  O --> B["Rollback"]

L'esecuzione in produzione richiede una Release pubblicata, un Rollout attivo e un collegamento di governance. Il percorso non governato è limitato a una sandbox chiaramente indicata e oggi ogni esecuzione avviabile dall'area di lavoro è un'esecuzione sandbox.

La scheda Releases offre i comandi per pubblicare un Draft, promuovere una Release pubblicata in produzione e riportare la produzione a una Release precedente. Ogni comando apre una finestra di conferma e chiama la propria mutazione API, applicandone le regole di autorizzazione e ciclo di vita. La promozione e il Rollback richiedono un collegamento di governance alla produzione. Una modifica in produzione che sostituisce una Release in uso attende inoltre che sia disponibile un confronto tra manifest. Il Rollback richiede un motivo. Una Release pubblicata rimane immutabile nel database.

Una richiesta in sospeso di modifica del campionamento viene approvata o rifiutata tramite approveSamplingChange. La procedura richiede l'autorizzazione update dell'Agent e nega l'approvazione a chi ha un'identità coincidente con quella del richiedente. La procedura di aggiornamento del campionamento non consente più di applicare immediatamente una modifica in sospeso.

Processes gestisce fasi, passaggi tipizzati, checkpoint e pubblicazioni multi-step. La diagnostica workflow in Agents è in sola lettura.