Glossario

Calybron

Piattaforma per la governance delle informazioni tramite intelligenza artificiale.

Scope

Lo scope è un raggruppamento orizzontale di vari intenti. Il suo scopo è quello di perimetrare diversi intenti per evitare collisioni di funzionalità tra i diversi clienti attivi. Formato dello scope \[a-zA-Z0-9\\/]

Channel

I Channel sono i componenti logici attraverso i quali utenti e sistemi esterni interagiscono con Calybron.

Ogni Channel implementa i protocolli necessari per il proprio tipo di comunicazione (ad esempio chat, telegram, mail), mentre la connessione tra il Channel e Calybron avviene sempre tramite una comunicazione sicura WebSocket (wss) utilizzando il CIP (Channel Interaction Protocol).

La sicurezza complessiva di Calybron dipende anche dalla sicurezza dei Channel, poiché costituiscono il punto di ingresso principale dal mondo esterno.

L’autenticazione dell’utente o del sistema interlocutore avviene a livello di Channel, secondo le logiche e le tecniche più adatte al canale specifico; l’esito dell’autenticazione viene poi comunicato a Calybron tramite CIP. Le Capabilities dell’utente vengono invece definite e gestite direttamente da Calybron.

Channel Gateway

Il Channel Gateway è il componente software che funge da punto di interfaccia tra tutti i Channel e Calybron.

La comunicazione avviene tramite connessione sicura WebSocket (wss) e protocollo CIP, attraverso cui il Gateway:

• verifica la validità di ogni canale controllandone il CIP Token,

• riceve le interazioni dai Channel e le instrada verso Calybron,

• pubblica le richieste dei Channel in una coda RabbitMQ (askChannel),

• riceve le risposte da Calybron tramite la coda RabbitMQ (responseChannel).

Il Channel Gateway gestisce inoltre l’associazione tra ogni richiesta e la relativa sessione, garantendo la continuità e il corretto instradamento delle conversazioni.

CIP - Channel Interaction Protocol

Il Channel Interaction Protocol (CIP) è il protocollo di comunicazione sicura, basato su WebSocket (wss), utilizzato per collegare ogni Channel al Channel Gateway.

Attraverso il CIP Token, il protocollo:

• identifica il canale che si sta connettendo,

• lo associa alla sua Organization,

• verifica l’eventuale autenticazione richiesta dal canale,

• avvia e mantiene la comunicazione tra il Channel e il Channel Gateway.

Oltre alla fase di autenticazione, il CIP supporta modalità di interazione sia passive (utente che avvia la comunicazione) sia attive (invio di notifiche o messaggi dal sistema verso l’utente), oltre a meccanismi di keepalive per garantire la stabilità della connessione.

CIP Token

Il CIP Token è la credenziale di autenticazione utilizzata dal Channel Interaction Protocol per riconoscere e validare un Channel.

Quando un Channel si connette, il CIP Token viene verificato dal sistema, che attraverso di esso:

• identifica il canale e lo scope di appartenenza,

• associa il canale alla sua Organization,

• recupera le informazioni di configurazione (come CIDR Whitelist e altre restrizioni di sicurezza) dal sistema di gestione,

• conferma che la connessione provenga da una rete autorizzata e sia conforme alle impostazioni previste.

Questo meccanismo assicura che un Channel possa operare solo all’interno del proprio scope e dalle reti autorizzate, anche in caso di tentativi di manomissione o uso improprio del token.

Permission

Le Permission definiscono i diritti di accesso agli intent e determinano quali operazioni un utente può eseguire.

Oltre a essere collegate e utilizzate a livello di Intent, la lista di Permission associata a una sessione può esistere solo se l’utente è autenticato.

I permessi non vengono generati da Calybron, ma trasmessi dal sistema che gestisce l’autenticazione, secondo uno standard condiviso. Calybron li riceve e li applica in modo passivo, utilizzandoli unicamente per determinare quali intent siano disponibili all’utente all’interno dello scope corrente.

Capability

Le Capability rappresentano l’insieme delle Permission possedute da un utente e determinano, in modo indiretto, gli intent accessibili all’interno di uno scope.

Poiché le Permission di una sessione esistono solo in presenza di autenticazione, anche le Capability sono disponibili unicamente per utenti autenticati.

Le Capability non vengono calcolate da Calybron, ma derivate direttamente dalle Permission fornite dal sistema di autenticazione. Calybron le utilizza in modo passivo per verificare, su ciascun Intent, se l’utente possiede i permessi necessari all’esecuzione dell’operazione.

Intent

Un Intent rappresenta la definizione della volontà espressa a Calybron e identifica univocamente la tipologia di operazione richiesta. È identificato da una stringa /[a-zA-Z0-9]/ denominata intentSlug e appartiene sempre a uno specifico Scope.

Gli intenti si dividono in due tipologie principali:

• Catalog Intent – Rappresentano le informazioni di contesto di Calybron, ovvero ciò che il sistema “sa” su un determinato argomento, i limiti entro cui può operare, il tipo di comunicazione da adottare e il ruolo da mantenere. Non richiedono, né avviano autonomamente, flussi o azioni operative: servono a definire la base di conoscenza e il comportamento di Calybron.

• Dynamic Intent – Rappresentano l’elemento operativo di Calybron. Sono in grado di avviare flussi, processi o azioni, interagendo dinamicamente con sistemi esterni o con altre componenti interne. Possono anche reagire a input contestuali o a sequenze di interazioni.

Ogni Intent può essere associato a una o più Permission, necessarie per consentire all’utente l’accesso a quella specifica funzionalità.

Catalog Intent

I Catalog Intent definiscono il contesto di conoscenza di Calybron. Contengono informazioni statiche o semi-statiche come:

• ciò che Calybron conosce su un determinato argomento,

• i limiti entro cui può fornire risposte,

• il registro comunicativo da utilizzare,

• il ruolo che deve assumere durante l’interazione.

Non eseguono azioni operative né attivano flussi di lavoro: servono a fornire a Calybron le linee guida e il quadro di riferimento entro cui interpretare e rispondere alle richieste.

Dynamic Intent

I Dynamic Intent sono l’elemento operativo e interattivo di Calybron. Possono:

• avviare processi o azioni,

• interagire con sistemi esterni,

• generare nuove richieste verso l’utente,

• adattarsi al contesto della conversazione,

• integrare informazioni dinamiche provenienti da fonti in tempo reale.

Sono iniettati nel sistema tramite il IIP (Intent Injection Protocol) e permettono di estendere o modificare in modo flessibile le funzionalità di Calybron in base allo scope di appartenenza.

IIP - Intent Injection Protocol

L’Intent Injection Protocol (IIP) è un protocollo di comunicazione sicura basato su WebSocket (wss) che consente a sistemi esterni di iniettare Dynamic Intent all’interno di Calybron.

Attraverso l’IIP è possibile:

• registrare nuovi Dynamic Intent in uno scope specifico,

• ricevere dal sistema le interazioni dell’utente che corrispondono a tali intenti,

• inviare a Calybron le risposte o le azioni generate dal sistema esterno.

Ogni token è univocamente associato a un DIM (Dynamic Intent Module) e può essere utilizzato solo da quest’ultimo per garantire sicurezza e tracciabilità.

DIM - Dynamic Intent Module

Con il termine DIM si intente qualsiasi componente software che inietti intenti dinamici a Calybron e che implementi il protocollo IIP.

Rounded Response

Le Rounded Response sono un sistema che genera, in modo dinamico, lievi variazioni per le risposte ricorrenti prodotte dai Dynamic Intent Module (DIM). L’obiettivo è umanizzare le risposte standard, rendendo l’interazione con Calybron più naturale e meno ripetitiva.

Sono disponibili per tutti i DIM, ma possono essere disattivate se si desidera mantenere risposte completamente standard.

Non modificano il contenuto informativo dell’intento, ma ne variano tono, formulazione e piccole sfumature linguistiche.

Favoriscono un’esperienza utente più naturale, simulando la varietà di risposte tipica di un interlocutore umano.

Logical Subject

Il Logical Subject rappresenta il concetto centrale o l’entità principale a cui si riferisce un’interazione o un intento. Serve a categorizzare e raggruppare le informazioni all’interno del sistema, facilitando il riconoscimento del contesto e la gestione coerente delle sessioni.

Subject Type

Il Subject Type definisce la tipologia del Logical Subject, specificandone la natura e le caratteristiche principali. Consente a Calybron di distinguere tra diverse classi di entità e di applicare regole, permessi e comportamenti differenti in base al tipo di soggetto trattato.

Context

Logicamente in una sessione, appena avviene emesso un Logic Subject, tutti gli intenti ingaggiati da quel momento fanno parte di un Context.

Un contesto non è altro che una serie di intenti che condividono un soggetto logico.

Session

Una sessione è il raggruppamento delle interazioni di un utente con Calybron, ed è contestualizzato dall'organization con cui interagisce e dal Channel utilizzato.

Esso raggruppa tutte le espressioni, tutti gli intenti invocati e tutte le risposte fornite.

La modalità di attivazione e aggregazione delle interazioni in una sessione è rimandata alla interazione tra ciascun Channel e il Channel Gateway.

User

Uno User è qualsiasi interlocutore con un Channel.

Uno User che non viene riconosciuto tramite authentication viene di default definito un Guest.

Se disponibili, le informazioni dello User sono presenti nella Sessione.

Authentication

L'authentication è il sistema con il quale uno User viene riconosciuto da Calybron.

Questa attività è in carico ai Channel che utilizzano tecnche e logiche specifiche del Channel stesso per determinare l'interlocutore.

L'authentication fa parte del protocollo CIP. Successivamente al processo di autenticazione verranno applicate le capabilties dell'utente.

Guest

I Guest sono tutti gli User che non hanno effettuato ancora il processo di Autentication o che non ne soddisfano i requisiti. In un canale base sprovvisto di autenticazione, ogni sessione appartiene ad utenti Guest.

Smart Center

Dashboard di gestione di Calybron.