Torna alla pagina principale

Documentazione tecnica

Come funziona OIAR

Flusso completo dall'inizializzazione dell'assessment alla consegna del report — con gate Human-in-the-Loop, interviste parallele e Data Room.

Multi-agent Human-in-the-Loop MAP-REDUCE Parallel interviews Claim & Evidence Audit log
01
Conversazione con l'orchestratore

Il consulente avvia una chat con l'orchestratore OIAR. Insieme definiscono l'obiettivo dell'assessment, la versione Odoo target, i moduli in scope e la lista degli stakeholder da coinvolgere. Quando il consulente è soddisfatto, finalizza la conversazione: l'orchestratore genera il piano strutturato.

Obiettivo Versione Odoo Moduli in scope Stakeholder Orchestratore Chat guidata
HITL-Plan · Plan Approval Gate · Mandatory
Il consulente revisiona il piano generato: obiettivo strutturato, lista stakeholder e traccia di intervista per ciascuno. Approva per avviare il processo oppure rifiuta con note — il sistema incorpora il feedback e ripropone il piano aggiornato.
HITL-PLAN
HITL-Interview · Start Interviews · Mandatory
Il consulente approva l'invio degli inviti email agli stakeholder e la creazione delle chat dedicate. Le cartelle Data Room vengono create solo a questo punto. Rifiutando, è possibile tornare a rivedere il piano e la lista stakeholder.
HITL-INTERVIEW
02
Interviste parallele via chat dedicata

Ogni stakeholder riceve un link email con accesso a una chat privata e isolata. Gli agenti OIAR operano in parallelo — uno per stakeholder — ciascuno nella propria cartella Data Room. Ogni intervistato completa la sessione in autonomia, al proprio ritmo.

IT Manager
infrastructure · customizations · integrations
Running
Business Owner
processes · KPIs · user adoption
Running
CFO / Finance
accounting · reporting · compliance
Running
Operations
warehouse · logistics · inventory
Running
Data Room — storage sotto il controllo dell'utente
Google Drive SharePoint / OneDrive Dropbox Notion Filesystem locale
Chat isolate per stakeholder Agenti in parallelo (MAP) Data Room per agente Documenti caricati dallo stakeholder
03
Sintesi e strutturazione delle evidenze (REDUCE)

Completate le interviste, l'orchestratore esegue la fase REDUCE: aggrega i finding di tutti gli agenti, individua contraddizioni tra stakeholder, classifica le evidenze con il modello Claim & Evidence e struttura processi, requisiti, gap e rischi.

Processi
Mappatura as-is per area Odoo candidata
Requisiti
Tracciati con fonte e stakeholder di riferimento
Gap
Classificati HIGH / MED / LOW con descrizione e azione
Rischi
Migrazione dati, personalizzazioni, integrazioni
Contraddizioni
Evidenziate tra stakeholder diversi per revisione
Domande aperte
Da risolvere nel workshop successivo
MAP-REDUCE Claim & Evidence Cross-stakeholder validation Audit log
HITL-Review · Consultant Approval · Mandatory
Il consulente revisiona il draft strutturato: approva singoli finding, corregge classificazioni, aggiunge note proprie e gestisce le contraddizioni evidenziate. Nessun finding passa nel report finale senza approvazione esplicita.
HITL-REVIEW
04
Generazione del report di pre-assessment

Il sistema compone il report finale a partire dai finding approvati dal consulente. Il report è strutturato, esportabile. Contiene tutte le sezioni necessarie per supportare la stima o la proposta al cliente.

OIAR_PreAssessment_GammaMetalli_v1.pdf
Executive Summary Processi analizzati Aree Odoo candidate Fit preliminare Gap classificati Rischi Domande aperte Complessità per area Prossimi step Note del consulente
Export PDF Condivisibile Consultant-reviewed Audit log allegato
Architettura

Componenti tecnici chiave

Per chi vuole capire cosa c'è sotto il cofano — senza che queste scelte architetturali impattino l'esperienza del consulente.

Orchestrazione
Multi-agent con MAP-REDUCE
Un orchestratore centrale coordina agenti specializzati che operano in parallelo (MAP). I risultati vengono aggregati e sintetizzati nella fase REDUCE.
orchestrator → [agent₁ ‖ agent₂ ‖ agentₙ] → reduce
Controllo
Human-in-the-Loop (HITL)
Il processo prevede tre gate obbligatori di approvazione del consulente: piano, avvio interviste, revisione finding. Nessun gate è bypassabile automaticamente.
HITL-Plan · HITL-Interview · HITL-Review
Evidenze
Claim & Evidence
Ogni finding è tracciato alla fonte: stakeholder, trascrizione, documento di supporto. Nessuna affermazione nel report è senza evidenza verificabile.
finding → [claim, source, evidence_ref, confidence]
Storage
Data Room con scope enforcement
I dati restano nel sistema documentale scelto dall'utente. Il controllo degli accessi garantisce l'isolamento tra agenti e tra assessment distinti.
scope: /assessment/{id}/agent/{n}/
Tracciabilità
Audit log
Ogni decisione di un agente, ogni approvazione HITL e ogni modifica al draft è registrata nell'audit log — allegabile al report o consultabile in autonomia.
timestamp · actor · action · finding_id
Context
Context window management
Le sessioni di intervista sono isolate per evitare context overflow. L'orchestratore riceve summary strutturati dagli agenti, non le trascrizioni raw.
agent → summary(structured) → orchestrator

Interessato alla closed beta?

Testa OIAR su una trattativa Odoo reale. Assessment assistito, report revisionabile, call finale di revisione inclusa.

Candidati per la closed beta →