Agents

Agents è lo spazio di lavoro per runtime e release in /workflow-runtime. L'accesso alla route richiede workflow:read, salvo un ruolo con accesso completo.

Cosa gestisce

• Identità, proprietario, modello, autorizzazioni degli strumenti, contratto di input e contratto di output dell'agente.
• Configurazione dell'agente in bozza e Release immutabili.
• Rollout specifici per ambiente e Rollback verso una Release pubblicata.
• Esecuzioni runtime, stato, binding delle policy, configurazione del campionamento e punteggio di assurance dell'agente.
• Schede del dettaglio dell'agente: Definition, Releases, Runs, Log, Sampling e Policy.
• Diagnostica in sola lettura del workflow compilato per specifiche di Process pubblicate.

L'esecuzione in produzione richiede una Release pubblicata, un Rollout attivo e un binding di governance. L'API di esecuzione rifiuta un run di produzione privo di uno di questi tre elementi. L'esecuzione non governata è limitata a un percorso sandbox esplicitamente contrassegnato; ogni run che lo spazio di lavoro può avviare oggi è un run sandbox.

La scheda Releases offre controlli per pubblicare una bozza, promuovere una Release pubblicata in produzione e riportare la produzione a una Release precedente. Ogni controllo apre una finestra di conferma e chiama una mutazione API dedicata, con le relative regole di autorizzazione e ciclo di vita. Promozione e Rollback richiedono un binding di governance di produzione. Una modifica di produzione che sostituisce una Release in servizio attende anche un confronto dei manifest disponibile. Il Rollback richiede una motivazione. Una Release pubblicata resta immutabile nel database.

Una richiesta di modifica del campionamento in attesa viene approvata o respinta tramite approveSamplingChange. La procedura richiede l'autorizzazione update sull'Agent e nega l'approvatore la cui identità coincide con il richiedente. La procedura di aggiornamento del campionamento non offre alcun override per applicare immediatamente una modifica in attesa.

Ciclo di vita della Release

flowchart LR
  D["Configurazione in bozza"] --> V["Convalida"]
  V --> R["Pubblica Release immutabile"]
  R --> O["Rollout nell'ambiente"]
  O --> X["Record di esecuzione"]
  O --> B["Rollback a una Release precedente"]

Ogni esecuzione conserva gli identificatori di Release e Rollout necessari a Lineage Explorer ed Evidence Room. Una modifica successiva produce una nuova Release.

Confini

Processes gestisce fasi multi-step, handler, handoff tipizzati, checkpoint e pubblicazione. Il pannello del workflow compilato in Agents è una diagnostica tecnica senza controlli di creazione, modifica, pubblicazione o deployment.

Le azioni mutanti applicano l'autorizzazione della risorsa oltre al gate di lettura a livello di route.