Vai al contenuto

Panoramica tecnica

Modello di implementazione per shell, pack, canali di intake, workflow, overlay di policy, integrazioni, gate di valutazione ed esecuzione governata.

Architettura della piattaforma

  • Gli adattatori di canale normalizzano i payload in entrata in eventi di intake compatibili con i workflow.
  • I motori di workflow producono WorkItem validi rispetto allo schema, con transizioni di stato a passi decisionali.
  • I servizi di evidence allegano citazioni e tracce di retrieval alla generazione di risposte e packet.
  • Il runtime di integrazione esegue le azioni in modo asincrono, con controlli di retry e idempotenza.
  • I flussi di telemetria e audit garantiscono tracciabilità end to end lungo l'intero lifecycle.

Conoscenza e ingestione

Modalità di ingestione supportate

  • Pipeline di aggiornamento per le fonti di conoscenza
  • Pipeline di upload per documenti e bundle di policy
  • Pipeline di sincronizzazione tramite connettore per sistemi esterni gestiti

Comportamento dell'ingestione

  • I job di ingestione emettono stato, latenza e diagnostica dei fallimenti
  • Le pipeline supportano retry sicuri e una strategia di backoff
  • Le policy a livello di asset definiscono il comportamento di freshness e conservazione

Le impostazioni di rendering ed estrazione sono configurabili per ciascun profilo di fonte.

Operazioni di freshness

  • Aggiornamento pianificato e rielaborazione on demand
  • Visibilità delle differenze per valutare le modifiche alle fonti
  • Avvisi di obsolescenza legati al profilo di rischio del workflow

Retrieval delle evidenze

Profili di retrieval: I profili definiscono recall, precision e rigore delle citazioni per workflow e classe di rischio.

Soglie decisionali: Confidenza, disponibilità delle evidenze e controlli di policy determinano se rispondere, mandare in revisione o fare escalation.

Generazione di risposte e packet

I WorkPacket vengono generati a partire dallo stato canonico del WorkItem e dai bundle di evidenze.

I renderer di destinazione mappano il contenuto canonico del packet sulle forme di payload specifiche del canale.

Confini di sicurezza

  • Modalità di citazione rigorosa per i workflow policy-critical
  • Rifiuto ed escalation espliciti quando le evidenze sono insufficienti
  • Gestione attenta ai dati personali e policy di redazione configurabili

Attivazione del canale

Configurazione dell'attivazione: Ogni canale di intake include controlli di attivazione, segnali di stato di salute e binding di sicurezza con scope.

Controlli di attivazione

  • Binding dell'origine e verifica del canale
  • Comportamento di caricamento delle integrazioni attento alle prestazioni
  • Supporto a interazione accessibile e localizzazione

Controlli operativi

  • Abilitare, disabilitare e monitorare i canali di intake per ambiente
  • Applicare override di policy specifici per canale
  • Ispezionare lo stato di salute e la telemetria tramite l'identificatore di canale interno

API di workflow e azioni

I canali di intake API pubblici supportano le operazioni sui WorkItem, l'esecuzione policy-aware e l'export della telemetria.

Autenticazione

  • Credenziali con scope per l'accesso server-to-server
  • Validazione del contesto di ruolo e tenant per ogni richiesta
  • Comportamento fail-closed in assenza di contesto di autorizzazione

Scope di autorizzazione

  • Lettura e gestione dei WorkItem
  • Gestione delle policy e delle transizioni di stato a passi decisionali
  • Esecuzione di azioni governate con permesso esplicito

Gruppi di endpoint principali

  • Operazioni sul lifecycle del WorkItem
  • Operazioni di passo decisionale e approvazione
  • Esecuzione delle integrazioni e operazioni di retry

Modello di risposta

  • Envelope tipizzati di successo e fallimento
  • Reason code leggibili automaticamente per gli esiti delle policy
  • Identificatori di traccia e correlazione per il debug

Dimensioni di telemetria

  • channel identifier e workflow_id
  • work_item_id e policy_version
  • integration_id e stato dell'esito dell'azione

Pattern di orchestrazione delle integrazioni

Le integrazioni possono essere collegate tramite adattatori nativi o middleware dove necessario.

Pattern di esecuzione

  • Creazione e aggiornamento delle risorse di destinazione
  • Allegato del contesto del packet e dei riferimenti alle evidenze
  • Retry con classificazione degli errori e gestione dead-letter

Pattern di ingestione

  • Ricezione di eventi di richiesta da strumenti esterni
  • Normalizzazione nello schema del workflow
  • Instradamento verso passi decisionali e proposte di azione

Controlli di governance

  • Allowlist delle azioni per workflow e ruolo
  • Requisiti di approvazione per profilo di rischio
  • Acquisizione di un evento di audit per ogni mutazione

Modello di sicurezza

I controlli di sicurezza vengono applicati ai livelli di intake, decisioning, esecuzione e telemetria, con confini di responsabilità chiari.

Modello di gestione dei dati

Artefatti conservati

  • Stato del WorkItem e metadati di lifecycle
  • Riferimenti alle evidenze e metadati di rendering dei packet
  • Esiti di esecuzione e record degli eventi di audit

Non conservati per impostazione predefinita

  • Materiale credenziale privo di scope in forma di testo in chiaro
  • Log di payload grezzi senza limiti
  • Stato di richiesta condiviso tra tenant diversi

Conservazione: Le policy di conservazione e archiviazione sono configurabili per scope di policy e classificazione dei dati.

Posizione sull'addestramento dei modelli: Le policy di gestione dei dati devono controllare esplicitamente se gli artefatti dei workflow sono idonei ai processi di miglioramento dei modelli.

FAQ

Possiamo partire con il solo intake web?
Sì. Il web può essere il primo canale, mantenendo le stesse primitive di workflow per i canali futuri.
Le integrazioni possono essere eseguite in modo asincrono?
Sì. L'esecuzione delle integrazioni è asincrona e supporta i retry con classi di errore tracciabili.
Come si traccia un esito fallito?
Usando correlation ID, cronologia del WorkItem, eventi decisionali e log di esecuzione è possibile ricostruire il flusso end to end.