📘 Guida utente Diamond – Introduzione

Benvenuti alla Guida per l'utente di Teemant.

Questa guida è progettata per aiutarti a comprendere come configurare e utilizzare un'area di lavoro Teemant, dalla configurazione di alto livello all'utilizzo quotidiano. Fornisce una panoramica strutturata di ogni sezione della piattaforma e spiega a cosa serve ciascuna funzionalità, senza entrare nei dettagli di implementazione di base.

🎯 Scopo di questa guida

L'obiettivo di questa documentazione è:

fornirti un modello mentale chiaro di come funziona Teemant,
spiegare il ruolo di ciascun componente dell'area di lavoro,
aiutare amministratori, manager e costruttori a navigare sulla piattaforma con sicurezza.

Questo non è un tutorial passo passo. Si concentra invece su concetti, responsabilità e best practice, in modo che la documentazione rimanga facile da gestire e si evolva senza intoppi con il prodotto.

Home (Dashboard)
Contesti di intelligenza artificiale
Guide AI
Messaggi
Eventi
Identificatori
Utensili

Visione
Risultati
Documenti
Modelli di oggetti
Impostazioni dell'area di lavoro
Membri dell'area di lavoro
Utenti dell'agente Workspace

Canali dell'area di lavoro
Trasporti dell'area di lavoro
Attività dell'area di lavoro
Costruttore di agenti di diamanti
Chiamate dell'agente Teemant

👥 A chi è rivolta questa guida

Questa guida è destinata a:

Amministratori dell'area di lavoro che gestiscono la configurazione e l'accesso,
Manager che supervisionano utenti, canali e operazioni,
Costruttori di bot che progettano agenti, flussi e automazioni.

A seconda del ruolo, alcune sezioni potrebbero essere più pertinenti di altre.

🧭 Come leggere questa guida

La guida segue la struttura dell'area di lavoro di Teemant:

Ogni sezione corrisponde a una voce di menu nella piattaforma.
È possibile leggerlo in modo lineare oppure passare direttamente a un argomento specifico utilizzando l'indice qui sotto.
Gli screenshot e le icone vengono utilizzati per aiutarti a riconoscere rapidamente le funzionalità dell'interfaccia.

Per casi d'uso avanzati (integrazioni personalizzate, API o flussi di lavoro complessi), potrebbe essere necessaria ulteriore documentazione o supporto.

🏠 Home (Pannello di controllo)

La scheda Home è la dashboard dell'area di lavoro.

Fornisce una panoramica di alto livello delle attività e dell'utilizzo, ad esempio:

numero di utenti,
numero di bot o agenti attivi,
indicatori di conversione o di completamento,
andamenti delle attività nel tempo.

La dashboard Home viene utilizzata per:

monitoraggio dell'utilizzo della piattaforma,
comprendere i livelli di adozione e di attività,
ottenere una rapida panoramica dello stato senza dover accedere alle schermate di configurazione.

Non contiene funzionalità di configurazione o gestione dei dati.

🗃️ Entità

Le entità rappresentano i database effettivi dei dati sincronizzati esterni all'interno di Teemant.

Vengono solitamente utilizzati per:

dati di riferimento (ad esempio negozi, sedi, unità organizzative),
oggetti aziendali provenienti da sistemi esterni,
set di dati condivisi tra agenti e processi.

Caratteristiche principali:

Le entità sono set di dati strutturati, non elementi conversazionali.
Spesso vengono sincronizzati da o verso sistemi esterni tramite importazioni o attività.
Gli agenti e le guide possono leggere dalle entità per convalidare o arricchire gli input degli utenti.

Insomma:

👉 Le entità sono il luogo in cui risiedono i dati aziendali strutturati all'interno di Teemant.

🛠️ Costruttore

Il Builder è il luogo in cui viene progettata l'intelligenza dei processi.

Viene utilizzato per:

costruire guide (logica, domande, convalide, flussi),
assemblare agenti sulla base di quelle guide,
definire come i diversi elementi interagiscono tra loro.

All'interno del Builder, puoi definire:

come si comporta un agente,
quali dati si aspetta,
quali documenti può gestire (e-mail, file, payload JSON, allegati),
come le informazioni vengono raccolte, convalidate e preparate.

Il Builder è l'area di progettazione principale di Teemant:

Le guide definiscono cosa raccogliere e come,
Gli agenti combinano guide con dati, documenti e logica per eseguire processi reali.

⚙️ Spazio di lavoro

La sezione Area di lavoro contiene impostazioni globali e amministrative.

Viene utilizzato per gestire:

configurazione generale dell'area di lavoro,
amministratori e utenti agenti registrati,
canali di comunicazione (ad esempio WhatsApp, e-mail, altri canali),
impostazioni a livello di ambiente (sviluppo, test, produzione).

Le impostazioni dell'area di lavoro controllano chi può accedere alla piattaforma, tramite quali canali e con quali autorizzazioni.

Qui non viene definita alcuna logica aziendale: è puramente operativa e amministrativa.

🔗 Trasporti

I trasporti definiscono i mezzi tecnici di trasferimento dati tra Teemant e sistemi esterni.

Alcuni esempi:

Push o pull SFTP,
scambi basati su file,
trasferimenti tramite e-mail.

Un trasporto risponde alla domanda:

👉 "Come si spostano fisicamente i dati tra i sistemi?"

Non definisce:

quali dati vengono scambiati,
quando viene scambiato,
o come viene interpretato.

🔄 Compiti

Le attività vengono utilizzate per analizzare, importare o sincronizzare fonti di dati esterne.

In genere:

monitorare database esterni o posizioni di file,
innescare le importazioni,
aggiornare le entità con dati nuovi o modificati.

Le attività si concentrano sull'acquisizione e la sincronizzazione dei dati, non sull'interazione dell'utente.

Torna all'inizio

🧠 Contesti AI

I contesti dell'IA definiscono l'ambiente comportamentale e semantico in cui opera l'IA.

Forniscono all'IA informazioni di base, intenti e regole di comunicazione, garantendo che le interazioni rimangano coerenti, pertinenti e allineate alle aspettative aziendali.

I contesti AI vengono utilizzati da entrambi:

agenti conversazionali (chatbot),
e processi di automazione della posta elettronica.

🌐 Contesti globali

I contesti globali descrivono informazioni generali e trasversali che si applicano all'intera organizzazione o all'intera area di lavoro.

In genere includono:

descrizione dell'azienda o dell'organizzazione,
regole aziendali generali o terminologia,
tono generale e stile comunicativo,
vincoli o ipotesi comuni.

I contesti globali fungono da base condivisa che può essere riutilizzata su più agenti e processi, garantendo coerenza a livello di piattaforma.

🤖 Contesti degli agenti

I contesti degli agenti sono specifici di un determinato agente o caso d'uso.

Definiscono:

cosa ci si aspetta che l'agente faccia (ad esempio raccogliere i dati della dichiarazione di incidente),
chi sono gli utenti (dipendenti, clienti, partner, team interni),
come l'agente dovrebbe comunicare (tono, livello di formalità, requisiti di chiarezza),
eventuali vincoli specifici del ruolo o del processo.

I contesti degli agenti consentono all'IA di adattare il proprio comportamento in base al processo aziendale supportato.

🧩 Ruolo dei contesti AI nelle guide

Quando si creano guide AI, il costruttore deve selezionare il contesto agente appropriato.

Il contesto selezionato è quindi:

applicato durante ogni conversazione, o
utilizzato durante i flussi di lavoro di elaborazione delle e-mail.

Il contesto assicura che

l'IA comprende il suo ruolo,
le interazioni rimangono allineate con il processo previsto,
le risposte sono coerenti su tutti i canali.

Insomma:

👉 I contesti dell'IA definiscono il modo in cui l'IA pensa e comunica, mentre le guide definiscono cosa fa l'IA.

Torna all'inizio

🧩 Guide AI

Le guide AI definiscono le istruzioni utilizzate dall'IA durante:

conversazioni in diretta (chatbot),
e l'elaborazione delle e-mail (Email Automation).

Una guida descrive quali informazioni devono essere raccolte o elaborate, come dovrebbe comportarsi l'IA e come sono strutturati i dati, ma non definisce la logica di trasporto o di integrazione.

Le guide AI vengono eseguite dagli agenti e operano sempre all'interno di un contesto AI definito.

Tipi di guida

Teemant fornisce diversi tipi di guide AI, ciascuna delle quali svolge uno scopo specifico all'interno di un processo.

📥 Guide alla raccolta dati

Le guide per la raccolta dati vengono utilizzate per raccogliere informazioni strutturate in base a un modello di dati predefinito.

Una volta definito un modello di dati (campi, formati, vincoli), è possibile creare una guida con l'assistenza dell'intelligenza artificiale.

Ogni fase di una Guida alla raccolta dati definisce in genere:

un nome visualizzato (leggibile dall'uomo),
un nome di campo tecnico,
un tipo di campo (stringa, numero, indirizzo, data, ecc.),
istruzioni del bot che spiegano come l'IA dovrebbe raccogliere o convalidare le informazioni,
istruzioni utente facoltative quando è richiesta un'azione specifica.

Le istruzioni del bot possono includere:

convalide,
dipendenze da valori raccolti in precedenza,
comportamento condizionale.
Le guide alla raccolta dati vengono utilizzate sia nei flussi conversazionali che nell'automazione delle e-mail.

✅ Guide alla checklist

Le guide di controllo sono simili alle guide di raccolta dati, ma sono progettate per domande chiuse.

In genere definiscono:

la domanda visualizzata,
scelte disponibili (Sì / No o simili),
istruzioni del bot,
istruzioni per l'utente facoltative,
se è richiesto un commento (vero/falso).

Le guide di controllo sono comunemente utilizzate per:

controlli di conformità,
fasi di convalida,
conferme procedurali.

🧮 Guide ai campi calcolati

Le guide ai campi calcolati definiscono i campi che vengono calcolati automaticamente in base ai valori raccolti in precedenza.

Essi:

affidarsi solo alle istruzioni del bot,
non richiedono mai l'input dell'utente,
non vengono visualizzati agli utenti.

I campi calcolati possono essere utilizzati in diverse fasi di un processo per:

valori aggregati,
calcolare i totali,
ricavare risultati intermedi.
Questi campi sono interni al processo ma possono essere utilizzati in seguito per output o integrazioni.

Struttura dell'interfaccia della guida

Ogni guida AI è organizzata in tre schede principali:

📄 Dettagli

La scheda Dettagli contiene le impostazioni generali della guida, come:

nome da visualizzare,
tipo di guida,
contesto AI associato,
agente collegato,
descrizione.

Questa scheda definisce di cosa si tratta.

🛠️ Costruisci

Nella scheda Build viene definita la logica della guida.

Visualizza:

l'elenco dei campi o delle domande a sinistra,
il prompt assistito dall'intelligenza artificiale e le istruzioni generate sulla destra.
Questa scheda definisce il comportamento della guida.

✉️ Risposta (solo automazione e-mail)

La scheda Risposta viene utilizzata solo per l'automazione delle e-mail.

Permette la configurazione di:

un modello di risposta via email,
file modello allegati,
firma e-mail.
Questa scheda definisce il modo in cui l'IA risponde tramite e-mail una volta completata l'elaborazione o quando sono necessarie informazioni aggiuntive.

Riepilogo

Insomma:

I contesti dell'IA definiscono il modo in cui l'IA pensa e comunica,
Le guide AI definiscono cosa l'IA deve raccogliere, calcolare o convalidare,
Gli agenti eseguono le guide all'interno di un processo,
I modelli di risposta si applicano solo alle interazioni basate su e-mail.

Se vuoi, possiamo anche:

abbreviare per una versione "panoramica rapida",
oppure allineare esattamente la formulazione con le etichette dei menu per garantire la coerenza tra le pagine della Guida.

Torna all'inizio

💬 Messaggi

I messaggi sono messaggi predefiniti, non basati sull'intelligenza artificiale, che possono essere inviati durante una conversazione.

Si tratta di messaggi hard-coded, ovvero:

non sono generati dall'IA,
non usano il ragionamento o il contesto dell'IA,
non vengono tradotti automaticamente.

I messaggi vengono solitamente utilizzati per punti di comunicazione fissi in un processo.

Scopo dei messaggi

I messaggi sono progettati per:

inviare conferme (ad esempio conferma di fine conversazione),
visualizzare informazioni standardizzate,
garantire una formulazione esatta laddove non si desidera variabilità.

Offrono un modo per trasmettere messaggi controllati e deterministici insieme a interazioni guidate dall'intelligenza artificiale.

Come vengono utilizzati i messaggi

I messaggi possono essere attivati:

in fasi specifiche di una conversazione,
alla fine di un processo,
come notifiche di sistema durante un'interazione.

Vengono comunemente utilizzati insieme a:

Guide AI (che gestiscono la logica dinamica),
Agenti (che orchestrano il flusso).

Caratteristiche principali

I messaggi sono statici.
Sono specifici per ogni lingua e, se necessario, devono essere creati separatamente per ogni lingua.
Garantiscono il pieno controllo sulla formulazione, sul tono e sul testo legale o conforme alle normative.

Insomma:

👉 I messaggi integrano le interazioni dell'IA fornendo blocchi di comunicazione fissi e affidabili in cui la variabilità non è accettabile.

Torna all'inizio

⚡ Eventi

Gli eventi rappresentano eventi interni al sistema generati durante l'esecuzione dei processi.

Sono pensati per catturare momenti significativi del ciclo di vita di una conversazione, dell'esecuzione di un agente o di un flusso di elaborazione dati. Gli eventi possono essere attivati automaticamente dalla piattaforma in base a condizioni predefinite o all'attività del sistema.

Questa sezione verrà utilizzata in seguito per descrivere come gli eventi vengono definiti, registrati e sfruttati all'interno di Teemant per supportare scenari di monitoraggio, automazione o integrazione.

In questa fase, gli eventi dovrebbero essere considerati come indicatori tecnici che riflettono ciò che accade all'interno della piattaforma durante l'esecuzione del processo.

Torna all'inizio

🔑 Identificatori

Gli identificatori sono numeri di riferimento cronologici univoci generati da Teemant per identificare ogni interazione elaborata.

Vengono utilizzati per tracciare:

conversazioni,
flussi di elaborazione della posta elettronica,
e i registri aziendali risultanti vengono scambiati con sistemi esterni.

Un identificatore funge da riferimento tecnico di un'istanza di processo dall'inizio alla fine.

Scopo degli identificatori

Gli identificatori vengono utilizzati per:

identificare in modo univoco una conversazione o un'istanza di elaborazione di posta elettronica,
garantire la tracciabilità lungo l'intero ciclo di vita del processo,
fare riferimento allo stesso caso nei sistemi informativi esterni,
facilitare audit, monitoraggio e risoluzione dei problemi.

Forniscono una chiave di riferimento stabile condivisa tra Teemant, utenti e sistemi esterni.

Struttura dell'identificatore

Un identificatore viene definito utilizzando una maschera, che può includere:

un contatore incrementale,
elementi di data o timestamp,
un prefisso fisso che identifica il processo o l'ambiente.

Esempio di struttura:

prefisso (ad esempio DEMO),
numero incrementale,
anno o marca temporale.

Ciò consente agli identificatori di essere:

leggibile,
ordinabile,
e unico nel tempo.

Quando vengono generati gli identificatori

Gli identificatori vengono generati alla fine di un processo, subito prima di:

vengono inviate notifiche via email,
i dati vengono esportati verso sistemi informativi esterni,
vengono recapitati i messaggi di conferma finale.

Ciò garantisce che:

tutti i dati raccolti o elaborati sono finalizzati,
l'identificatore riflette un processo completato,
lo stesso identificatore può essere riutilizzato in modo coerente in output, notifiche e integrazioni.

Ruolo nel monitoraggio dei processi

Una volta generato, l'identificatore può essere:

inclusi nelle e-mail o nelle notifiche,
incorporato nei file esportati o nei payload,
memorizzato in sistemi esterni come chiave di riferimento.

Insomma:

👉 Gli identificatori rendono ogni interazione tracciabile, verificabile e collegabile tra i sistemi.

Torna all'inizio

🧰 Strumenti

Gli strumenti sono applicazioni esterne che possono essere attivate da Teemant durante un processo.

Consentono a Teemant di ampliare le proprie capacità delegando azioni specifiche ad applicazioni specializzate di terze parti, mantenendo al contempo l'intero processo orchestrato da Teemant.

Scopo degli strumenti

Gli strumenti vengono utilizzati quando un processo richiede un'azione che:

non può essere eseguito direttamente dall'IA,
deve essere gestito da un sistema esterno certificato o specializzato,
richiede l'interazione dell'utente al di fuori dell'interfaccia conversazionale.

I casi d'uso tipici includono:

acquisizione di foto certificate e crittografate,
raccogliere una firma digitale su uno smartphone,
esecuzione di azioni regolamentate o sensibili alla conformità.

Come vengono utilizzati gli strumenti nei processi

Uno strumento può essere:

attivato in un passaggio specifico durante una conversazione,
richiamato come parte di un processo basato sulla posta elettronica,
incorporato nel flusso di lavoro di un agente.

Una volta attivato, l'utente viene reindirizzato o guidato all'applicazione esterna e il risultato viene quindi restituito a Teemant per continuare il processo.

Integrazione e partner

Tutti gli strumenti richiedono:

un'integrazione tecnica con Teemant,
e sono forniti da partner certificati Teemant.

Ciò garantisce:

sicurezza e integrità dei dati,
conformità ai requisiti normativi,
scambio affidabile di informazioni tra sistemi.

Nel tempo è possibile integrare più applicazioni esterne, a seconda delle esigenze aziendali e delle soluzioni dei partner disponibili.

Riepilogo

Insomma:

👉 Gli strumenti consentono a Teemant di interagire con applicazioni esterne per eseguire azioni specializzate che vanno oltre l'intelligenza artificiale conversazionale, pur rimanendo completamente integrate nel flusso di processo generale.

Torna all'inizio

👁️ Vision

Visione – Documenti e immagini intelligenti

Il modulo Vision gestisce l'estrazione di informazioni da documenti e immagini all'interno di Teemant.

Una Vision è un agente di intelligenza artificiale indipendente, specializzato nella lettura, analisi e interpretazione di documenti o immagini al fine di produrre dati strutturati e utilizzabili.

Vision va oltre l'OCR di base: combina l'estrazione visiva con la comprensione e la convalida basate sull'intelligenza artificiale.

Visione come agente AI specializzato

Ogni Vision è configurata come un agente AI dedicato con i propri:

Scopo,
Contesto del documento,
Modello di estrazione,
Logica di elaborazione dell'intelligenza artificiale.

L'agente Vision è responsabile di:

Leggere documenti o immagini (PDF, scansioni, foto),
Estrazione di informazioni grezze tramite OCR o analisi delle immagini,
Applicazione della logica di intelligenza artificiale di Teemant ai dati estratti per interpretarli, normalizzarli e strutturarli.

Questo ulteriore livello di elaborazione dell'intelligenza artificiale consente a Vision di gestire layout complessi, contenuti scritti a mano e informazioni ambigue.

Contesto del documento

Ogni Visione è associata a un Contesto del Documento.

Il contesto del documento definisce:

Il tipo di documento in elaborazione (ad esempio rapporto di incidente, certificato, fattura, modulo manoscritto),
Il significato semantico del documento,
La struttura prevista e la logica aziendale.

Questo contesto guida l'agente Vision in modo che sappia:

Quali informazioni cercare,
Come interpretare i valori estratti,
Come applicare regole specifiche del dominio durante l'elaborazione.

Flusso di estrazione, elaborazione e convalida

Il flusso di lavoro di Vision segue sempre lo stesso principio:

Estrazione Il testo grezzo e le informazioni visive vengono estratti dal documento o dall'immagine utilizzando un OCR o un motore di visione.
Process Teemant AI elabora il contenuto estratto campo per campo:

Mappa i dati in campi strutturati,
Applica la formattazione e la normalizzazione,
Interpreta valori ambigui o parziali.

Convalida (facoltativo) Durante una conversazione, l'agente Vision può interagire con l'utente per:

Conferma i valori estratti,
Richiedi informazioni mancanti,
Correggere o perfezionare i dati.

Questa fase di convalida è particolarmente utile per documenti scritti a mano o scansioni di bassa qualità.

Fornitori di servizi visivi

Teemant supporta più backend Vision a seconda del caso d'uso:

Microsoft Document Intelligence Utilizzato in genere per documenti complessi, strutturati o scritti a mano, con modelli addestrati personalizzati.

Mistral OCR OCR diretto tramite API, più facile da integrare ma generalmente meno affidabile per i documenti complessi.

In futuro potranno essere integrate ulteriori piattaforme Vision.

Indipendentemente dal fornitore, la logica di Vision rimane la stessa: estrazione → elaborazione con IA → convalida facoltativa con l'utente.

Visione nei processi end-to-end

Gli agenti Vision sono progettati per essere integrati in flussi di lavoro Teemant più ampi, tra cui:

Guide alla raccolta dati,
Dichiarazioni di incidenti o reclami,
Automazione delle e-mail,
Esportazioni strutturate verso sistemi informativi.

Trasformando documenti non strutturati in dati strutturati e convalidati, Vision svolge un ruolo fondamentale nell'automazione dei processi che richiedono molti documenti all'interno di Teemant.

Torna all'inizio

📤 Uscite

Il modulo Output gestisce tutti i flussi in uscita da Teemant. Definisce come dati, documenti e notifiche prodotti dagli agenti di intelligenza artificiale vengono consegnati a sistemi, applicazioni e utenti esterni.

Gli output possono includere:

Notifiche e-mail con contenuti strutturati o non strutturati
Esportazioni di file (JSON, file multimediali, archivi ZIP, documenti generati)
Trasferimenti SFTP
API, webhook e altri connettori in uscita utilizzati per integrare Teemant con i sistemi informativi aziendali

Ogni configurazione di output consente di definire:

Il meccanismo di trasporto (server di posta elettronica, SFTP, endpoint API, webhook, ecc.)
I documenti e i formati dei dati da inviare
Il contenuto e la struttura delle notifiche o dei payload esportati
Se viene utilizzato il server di posta Teemant predefinito o un trasporto dedicato

Gli output vengono in genere attivati al termine di un processo, una volta completate la raccolta dei dati, l'elaborazione tramite intelligenza artificiale, le convalide e la generazione degli identificatori. Garantiscono che i risultati siano forniti in modo affidabile, tracciabile e pronto per l'integrazione.

Questo modulo rappresenta il livello di distribuzione finale di Teemant, consentendo una comunicazione fluida tra flussi di lavoro basati sull'intelligenza artificiale e sistemi esterni.

Torna all'inizio

📄 Documenti

La sezione Documenti centralizza tutti i contenuti prodotti, inviati o gestiti da Teemant durante un processo. Comprende email, documenti tecnici (come JSON) e file multimediali (foto, allegati, documenti generati).

I documenti vengono in genere utilizzati dagli output (notifiche e-mail, esportazioni SFTP, API, webhook, connettori in uscita) e possono includere variabili dinamiche provenienti da conversazioni, elaborazione AI e logica aziendale.

✉️ E-mail

Le e-mail sono il tipo di documento più comune in Teemant.

Sono utilizzati per:

avvisare gli utenti finali,
confermare una dichiarazione o un'azione,
comunicare con i team interni,
o trasmettere informazioni ai partner.

Ogni documento di posta elettronica definisce:

destinatari (A / Cc / Ccn),
un soggetto dinamico (ad esempio utilizzando {app.identifier} ),
un corpo di contenuto personalizzabile,
e un motore di creazione di template.

Motori di template disponibili

Freemarker Un motore di creazione modelli standard e potente, ideale per email complesse con condizioni, cicli e formattazione HTML avanzata.
Motore di modelli Teemant Un motore interno più semplice, progettato per creare rapidamente e-mail chiare e facili da gestire con un inserimento semplice delle variabili.

Le variabili (ad esempio {app.accidentDate}, {user.email} …) vengono risolte automaticamente al momento dell'invio, in base ai dati raccolti ed elaborati da Teemant.

🧾 JSON e contenuti tecnici

I documenti non si limitano alle e-mail.

Teemant gestisce anche i documenti JSON utilizzati per:

immissione di dati nei sistemi informativi,
esportazioni strutturate,
integrazioni tramite API, webhook e connettori in uscita.

Questi documenti strutturati garantiscono scambi di dati affidabili, coerenti e standard con sistemi esterni.

📎 Media e file

La categoria Media raggruppa tutti i file gestiti durante un processo:

foto,
documenti caricati dall'utente,
file generati automaticamente,
output da Vision (OCR, analisi delle immagini),
allegati inviati via e-mail o esportati.

I file multimediali possono essere:

immagazzinato,
analizzato,
esportati tramite Output (email, SFTP, API, webhook, ecc.),
o collegato a una conversazione, un identificatore o un processo aziendale.

🎯 Riepilogo

La sezione Documenti è la base per tutti i contenuti in uscita e tecnici di Teemant.

Ti consente di:

centralizzare e-mail e documenti,
standardizzare i formati,
iniettare dinamicamente dati generati dall'intelligenza artificiale e dati conversazionali,
e garantire un'integrazione perfetta con i sistemi esterni.

Torna all'inizio

🧱 Modelli di oggetti

I modelli a oggetti definiscono il livello di dati strutturati di Teemant. Vengono utilizzati per modellare dati di riferimento, dati operativi e oggetti di configurazione specifici dell'area di lavoro condivisi tra agenti, processi e integrazioni.

Hanno due scopi principali.

1️⃣ Modelli di dati di riferimento e aziendali (sincronizzazione dei dati)

I modelli di oggetti vengono utilizzati per creare database strutturati che rappresentano dati di riferimento o aziendali richiesti dai processi Teemant, ad esempio:

Negozi, agenzie, filiali
Veicoli, prodotti, contratti, polizze
Qualsiasi set di dati di riferimento esterno utilizzato durante le conversazioni, l'elaborazione dei documenti o l'instradamento

Questi modelli possono quindi essere:

Sincronizzato con sistemi informativi esterni
Tenuto aggiornato tramite:
Trasporti → modalità di scambio dei dati (SFTP, API, connettori, ecc.)
Attività → quando e con quale frequenza viene eseguita la sincronizzazione (su richiesta, pianificata, incrementale, ecc.)

Ciò consente a Teemant di lavorare con dati aziendali affidabili e in tempo reale e garantisce che gli agenti di intelligenza artificiale possano sempre contare su informazioni coerenti e aggiornate.

2️⃣ Oggetti di configurazione dell'area di lavoro (proprietà dinamiche dell'area di lavoro)

I modelli di oggetti possono anche definire proprietà personalizzate a livello di area di lavoro.

Non si tratta di set di dati di riferimento, ma di oggetti di configurazione allegati a un'area di lavoro, come ad esempio:

Destinatari di posta elettronica speciali (ad esempio e-mail RC, e-mail di escalation, e-mail del partner)
Identificatori, codici o parametri aziendali specifici di un'area di lavoro
Qualsiasi proprietà personalizzata che dovrebbe apparire nelle Impostazioni dell'area di lavoro

Una volta definito:

Questi campi diventano automaticamente disponibili nella configurazione dell'area di lavoro
Possono essere riutilizzati in:
Documenti e notifiche
Risultati
Guide AI
Automazioni e logica di routing

Ciò rende i modelli di oggetti un modo potente per estendere Teemant senza codice personalizzato, semplicemente modellando nuove proprietà strutturate.

Tipi di campo supportati

I modelli di oggetti supportano un set controllato di tipi di campo per garantire coerenza e interoperabilità, tra cui:

corda
intero
numero
e-mail
data
posizione
contenuto

Questi tipi sono progettati per essere completamente compatibili con l'elaborazione AI, la creazione di modelli di documenti, le esportazioni e le integrazioni.

Perché i modelli di oggetti sono importanti

I modelli di oggetti sono il fondamento dell'architettura dei dati di Teemant:

Strutturano il modo in cui i dati vengono archiviati, condivisi e sincronizzati
Collegano gli agenti di intelligenza artificiale con i sistemi aziendali
Consentono di personalizzare gli spazi di lavoro in modo pulito e scalabile

In breve, i modelli di oggetti trasformano Teemant in una piattaforma di intelligenza artificiale basata sui dati, non solo su conversazioni.

Torna all'inizio

🧱 Impostazioni dell'area di lavoro

Un'area di lavoro rappresenta un tenant logico in Teemant. Definisce i confini funzionali, tecnici e organizzativi entro cui operano agenti, dati, integrazioni e utenti. In pratica, un'area di lavoro solitamente è associata a un ambiente (sviluppo, test, produzione) o a una specifica unità aziendale o cliente.

Ambiente e governance (principale)

La scheda Principale centralizza la configurazione principale dell'area di lavoro:

Nome, impostazioni locali e fuso orario

Queste impostazioni definiscono il modo in cui il contenuto viene localizzato (lingua, formati di data) e il modo in cui viene valutata la logica basata sul tempo (eventi, attività, notifiche).

Best Practice: più spazi di lavoro

Si consiglia vivamente di creare spazi di lavoro separati per:

Sviluppo (sperimentazione e configurazione),
Test / UAT (validazione e approvazione aziendale),
Produzione (operazioni in tempo reale, utenti finali). Ciò garantisce isolamento, sicurezza e distribuzioni controllate.

Spazio di lavoro pubblico

Quando un'area di lavoro è contrassegnata come Pubblica, diventa accessibile agli utenti finali a seconda del canale:

WhatsApp: qualsiasi utente con un account Meta WhatsApp,
Microsoft Teams / Google Chat: utenti autorizzati a installare l'app Teemant. Questa funzionalità è particolarmente utile per scenari utente aperti o su larga scala.

Email di contatto predefinite Gli indirizzi email di contatto definiti qui fungono da destinatari di fallback globali per notifiche e output (email, avvisi, esportazioni) quando non è configurata alcuna destinazione più specifica.

Fornitori e servizi di intelligenza artificiale

La scheda Provider è il punto in cui l'area di lavoro si collega al suo ecosistema tecnologico:

Qui vengono configurate le chiavi API per LLM, motori OCR, Vision/Document AI e altri servizi di intelligenza artificiale.
I clienti possono:
portare le proprie chiavi API, oppure
fare affidamento sulle chiavi fornite da Teemant, a seconda della configurazione e dell'accordo.
Questa configurazione si applica all'intera area di lavoro e viene riutilizzata dagli agenti, da Vision, dall'elaborazione dei documenti e dalle funzionalità di automazione.

Impostazioni aziendali specifiche dell'area di lavoro (modelli di oggetti)

La terza scheda (ad esempio "Auchan Gestionnaires" negli screenshot) illustra come vengono utilizzati i modelli di oggetti a livello di area di lavoro:

Questi oggetti definiscono proprietà personalizzate dell'area di lavoro stessa, come ad esempio:
indirizzi email di destinatari speciali (ad esempio email RC, email DAB),
campi di configurazione specifici dell'azienda,
tutti i metadati specifici del dominio richiesti dai flussi di lavoro o dagli output.

Una volta definiti, questi campi vengono visualizzati direttamente nelle impostazioni dell'area di lavoro e possono essere consultati tramite:
agenti,
documenti e modelli,
output (email, API, esportazioni),
integrazioni.

In breve, l'area di lavoro non è solo un contenitore: è il livello di configurazione centrale che collega ambienti, utenti, provider di intelligenza artificiale, regole aziendali e integrazioni, garantendo coerenza e controllo sull'intera piattaforma Teemant.

Torna all'inizio

👥 Membri dello spazio di lavoro

I membri dell'area di lavoro sono gli amministratori di un'area di lavoro (tenant). Sono responsabili della configurazione, della gestione e del controllo dell'utilizzo di Teemant all'interno di un determinato ambiente.

I membri sono utenti interni (i tuoi team, partner o integratori), non utenti finali che interagiscono con chatbot o e-mail.

Ruoli e permessi

Ogni membro dell'area di lavoro può avere uno o più dei seguenti ruoli:

Amministratore
Accesso completo alla configurazione dell'area di lavoro
Può gestire impostazioni, provider, utenti, canali, output, documenti, ecc.
Impossibile creare agenti di intelligenza artificiale
Manager
Può gestire utenti, canali, configurazioni e impostazioni operative
Impossibile creare agenti di intelligenza artificiale
Costruttore di bot
Può solo creare e configurare agenti AI (guide AI, contesti, flussi)
Nessun accesso all'amministrazione a livello di area di lavoro

Questa separazione dei ruoli garantisce una governance chiara, sicurezza e distribuzioni controllate.

Migliori pratiche

Area di sviluppo
Concedi tutti i ruoli (Amministratore, Manager, Bot Builder)
Questo è l'unico posto in cui gli agenti di intelligenza artificiale sono progettati e configurati
Spazi di lavoro di test e produzione
Solo ruoli di amministratore e/o gestore delle sovvenzioni
Non è consentito l'edificio dell'agente
Gli agenti vengono distribuiti qui, non creati
Un'area di lavoro per applicazione client
Si consiglia vivamente di mantenere le configurazioni isolate
Migliora la sicurezza, la manutenibilità e la chiarezza della distribuzione

Perché questo è importante

Questo approccio:

Previene modifiche accidentali nella produzione
Impone un ciclo di vita pulito build → test → distribuzione
Rende molto più semplici gli audit, il supporto e la risoluzione dei problemi
Si allinea con le pratiche IT e DevOps di livello aziendale

I membri dell'area di lavoro definiscono chi può fare cosa, mentre gli agenti AI definiscono cosa fa il sistema.

Torna all'inizio

👥 Utenti dell'agente Workspace (utenti finali)

Gli utenti agente sono gli utenti finali che possono accedere e interagire con gli agenti Teemant (chatbot, automazione delle e-mail, ecc.) all'interno di un'area di lavoro.

Non sono amministratori e non configurano la piattaforma. Il loro ruolo è semplicemente quello di utilizzare gli agenti attraverso i canali di interazione abilitati.

🔐 Regole di accesso

L'accesso agli agenti dipende dalla visibilità dell'area di lavoro:

Area di lavoro privata (predefinita) Solo gli utenti definiti esplicitamente come Utenti agente possono vedere e interagire con gli agenti.

Area di lavoro pubblica Tutti gli utenti che possono accedere al canale possono interagire con gli agenti:
WhatsApp: qualsiasi utente autenticato su Meta WhatsApp
Microsoft Teams: utenti autorizzati a installare/utilizzare l'app Teemant
Google Chat: utenti autorizzati all'interno di Google Workspace

Ogni utente agente può essere:

Abilitato o disabilitato
Associato a uno o più canali
Configurato con impostazioni locali e dettagli di contatto

📱 Best practice specifiche per canale

Il controllo degli accessi dovrebbe seguire la logica di ciascun canale:

La gestione degli accessi a Microsoft Teams/Google Chat/email è solitamente gestita a monte, dal fornitore IT o di identità del cliente (Azure AD, Google Workspace, sistemi di posta, ecc.).

WhatsApp Poiché WhatsApp è generalmente aperto al pubblico, l'autenticazione deve essere gestita all'interno del processo, ad esempio:
ID dipendente o agente
Numero di targa del veicolo
Numero di polizza o contratto
Verifica basata su documenti (documento d'identità, modulo, foto, ecc.)

Questa logica di autenticazione viene in genere implementata all'interno della Guida AI e del flusso di conversazione, non a livello di canale.

✅ Pratiche consigliate

Mantenere gli utenti dell'agente rigorosamente separati dai membri dell'area di lavoro (amministratori, gestori, costruttori).
Utilizzare spazi di lavoro privati per distribuzioni controllate.
Delegare, ove possibile, il controllo dell'identità e degli accessi ai sistemi del cliente.
Progettare passaggi di autenticazione espliciti nei flussi di conversazione, in particolare per i canali pubblici come WhatsApp.

In breve, gli utenti agente definiscono chi può comunicare con l'IA, mentre i membri dell'area di lavoro definiscono chi può configurarla.

Torna all'inizio

🔌 Canali dell'area di lavoro

I canali definiscono il modo in cui gli utenti interagiscono con gli agenti Teemant e dove vengono ricevuti e inviati messaggi, e-mail o conversazioni.

Ogni canale rappresenta un'integrazione concreta con una piattaforma di comunicazione esterna come WhatsApp, Microsoft Teams, Google Chat, sistemi di posta elettronica o strumenti di chat live.

Un'area di lavoro può avere più canali abilitati contemporaneamente, consentendo agli stessi agenti di intelligenza artificiale di operare in modo coerente su diversi punti di contatto.

💬 Canali di chat (conversazionali)

📱 WhatsApp

I canali WhatsApp collegano Teemant agli account Meta WhatsApp Business tramite un numero di telefono dedicato.

Come funziona:

Qualsiasi utente autenticato su WhatsApp può contattare il bot tramite il numero configurato.
La visibilità dell'area di lavoro (pubblica o privata) determina se è necessario un controllo di accesso aggiuntivo.
Nella maggior parte dei casi d'uso reali, l'autenticazione viene gestita all'interno del flusso di intelligenza artificiale e non da WhatsApp stessa (ad esempio ID dipendente, numero di badge, targa, ID documento, ecc.).
WhatsApp è solitamente utilizzato da utenti esterni o da un pubblico ampio.

Buone pratiche:

Utilizzare l'autenticazione conversazionale all'interno della logica dell'agente quando sono coinvolti dati sensibili.

💼 Microsoft Teams

I canali Microsoft Teams consentono agli agenti Teemant di operare all'interno di un tenant Microsoft.

Come funziona:

L'accesso è limitato agli utenti autenticati nel tenant Teams configurato.
L'ID tenant di Teams definisce l'ambito degli utenti autorizzati.
Ideale per casi d'uso interni (supporto IT, risorse umane, operazioni, assistenti interni).

Buone pratiche:

Lascia che i team gestiscano identità e accessi; evita di duplicare la logica di autenticazione all'interno del bot, a meno che non sia necessario.

💬 Google Chat

I canali di Google Chat collegano Teemant a un dominio Google Workspace.

Come funziona:

Solo gli utenti autenticati all'interno del dominio Google configurato possono accedere al bot.
Il controllo degli accessi è gestito naturalmente dalle autorizzazioni di Google Workspace.
Adatto per assistenti aziendali interni.

🧑‍💻 Chat dal vivo (Chawoot)

I canali LiveChat collegano Teemant a piattaforme di chat di terze parti, come Chatwoot.

Come funziona:

Teemant funge da livello di intelligenza artificiale dietro il sistema di chat dal vivo.
L'intelligenza artificiale può automatizzare le risposte di primo livello, la raccolta dei dati e il triage.
Quando necessario, gli agenti umani possono prendere in carico le conversazioni.

Buone pratiche:

Utilizza le integrazioni LiveChat per flussi di lavoro ibridi di intelligenza artificiale e supporto umano.

📧 Canali e-mail

📩 Google Mail

I canali Google Mail consentono a Teemant di leggere, classificare e rispondere alle email provenienti da una casella di posta di destinazione.

Concetti chiave:

Sono richieste le credenziali OAuth (ID client, segreto, token di aggiornamento).
Le e-mail vengono elaborate da agenti di intelligenza artificiale per la classificazione, l'estrazione dei dati e la stesura delle risposte.
La gestione del consenso garantisce il rispetto dell'autorizzazione dell'utente.

📬 Microsoft Mail

I canali di Microsoft Mail si integrano con le caselle di posta di Microsoft 365.

Come funziona:

Le email vengono acquisite, analizzate e indirizzate all'agente di intelligenza artificiale appropriato.
Gli agenti possono estrarre dati strutturati, aggiornare il sistema informativo e generare risposte.
Prima di attivare l'elaborazione dell'IA è necessario il consenso esplicito dell'utente.

Casi d'uso tipici:

Automazione delle e-mail
Dichiarazioni di incidente
Richieste dei clienti o dei partner
Automazione dei processi di back-office

⚙️ Principi di configurazione del canale

Ogni canale ha:
Uno stato (abilitato/disabilitato)
Una descrizione per documentazione e chiarezza
Una modalità bozza per configurare in modo sicuro prima di andare in onda

I canali possono essere aggiunti in modo indipendente e attivati progressivamente.
La stessa logica dell'agente può essere riutilizzata su più canali.

✅ Buone pratiche

Ambienti separati (Sviluppo / Test / Produzione) dovrebbero avere i propri canali.
Preferisci l'autenticazione tramite piattaforma nativa (Teams, Google Chat, Mail).
Per canali aperti come WhatsApp, implementare l'autenticazione all'interno della conversazione AI.
Mantenere la configurazione del canale al minimo; la complessità dovrebbe risiedere nelle guide AI e nella logica dell'agente, non nel canale stesso.

Torna all'inizio

🔁 Trasporti nell'area di lavoro

I trasporti definiscono il modo in cui i dati e i documenti vengono esportati da Teemant ai sistemi esterni.

Rappresentano il ponte tecnico tra Teemant e i tuoi sistemi informativi, data lake, ERP, CRM o strumenti operativi.

In genere, un trasporto viene utilizzato dalle attività per determinare quando, come e dove vengono inviati i dati.

📦 A cosa servono i trasporti

I trasporti consentono di:

Esporta dati strutturati (JSON, metadati, modelli di oggetti)
Esporta documenti (PDF, immagini, archivi ZIP)
Sincronizzare i database di riferimento con sistemi esterni
Invia i dati automaticamente o secondo una pianificazione

Sono più comunemente utilizzati per:

Integrazioni di sistema
Sincronizzazione dei dati
Reporting e archiviazione
Automazione operativa

📁 Trasferimento file (SFTP / FTP) 📤

I trasporti di trasferimento file vengono utilizzati per inviare file a server esterni, in genere backend aziendali.

Caratteristiche principali:

Supporta SFTP / FTP
I dati possono essere esportati come:
JSON
Documenti
Archivi ZIP (consigliati per esportazioni batch)
Autenticazione sicura tramite account e password
Percorso di destinazione configurabile

Casi d'uso tipici:

Esportare set di dati giornalieri o orari in un ERP
Sincronizzare i database di riferimento
Invia dati strutturati ai sistemi legacy
Pipeline di elaborazione batch

Esempio:

Esportare tutti i documenti elaborati e i metadati come file ZIP su un server SFTP ogni notte.

✉️ Trasporto e-mail

I trasporti e-mail consentono a Teemant di inviare dati o documenti tramite e-mail.

Caratteristiche principali:

Configurazione SMTP (host, porta, crittografia)
Autenticazione tramite account di posta elettronica
Supporta gli allegati
Può essere utilizzato per notifiche o consegna dati

Casi d'uso tipici:

Invia report o esportazioni agli utenti aziendali
Avvisa i team quando i dati vengono aggiornati
Integrazioni leggere senza sistema backend

🌐 Webhook 🔔

I webhook consentono di inviare notifiche push in tempo reale a sistemi esterni.

Caratteristiche principali:

Endpoint HTTP(S)
Consegna basata sugli eventi
Payload inviati in JSON
Autenticazione sicura (intestazioni, token)

Casi d'uso tipici:

Attivare flussi di lavoro su piattaforme esterne
Notificare immediatamente i sistemi a valle
Integrazione con strumenti di automazione (Zapier, Make, API personalizzate)

Esempio:

Quando un documento viene elaborato, avvisare immediatamente un sistema esterno con i relativi metadati.

🔌 API REST 🧩

I trasporti REST API consentono ai sistemi esterni di estrarre o ricevere dati a livello di programmazione.

Caratteristiche principali:

Endpoint REST standard
Autenticazione sicura (chiavi API, OAuth, token)
Supporta lo scambio di dati strutturati
Progettato per integrazioni scalabili

Casi d'uso tipici:

Integrazione sistema-sistema in tempo reale
Applicazioni esterne che interrogano i dati di Teemant
Orchestrazione e automazione avanzate

🧠 Come funzionano i trasporti con modelli di oggetti e attività

I trasporti non vengono utilizzati da soli:

I modelli di oggetti definiscono quali dati esistono
I trasporti definiscono come e dove vengono inviati i dati
Le attività definiscono quando e con quale frequenza i dati vengono sincronizzati

Insieme, formano una pipeline completa di sincronizzazione dei dati.

✅ Buone pratiche

✔ Utilizza SFTP ZIP per esportazioni di dati di grandi dimensioni o in batch✔ Utilizza Webhook per integrazioni in tempo reale✔ Utilizza API REST per sistemi avanzati o interattivi✔ Separa i trasporti per ambiente (Sviluppo / Test / Produzione)✔ Testa sempre i trasporti prima di pubblicarli in produzione

🧭 Riepilogo

I trasporti sono la spina dorsale delle integrazioni di Teemant.

Garantiscono che i dati prodotti all'interno di Teemant fluiscano in modo affidabile, sicuro e automatico nel tuo ecosistema aziendale.

Sono progettati per essere:

Flessibile
Scalabile
Pronto per l'impresa

Torna all'inizio

⏱️ Attività dell'area di lavoro

Le attività dell'area di lavoro vengono utilizzate per configurare operazioni automatizzate o on-demand eseguite a livello di area di lavoro. In genere, vengono utilizzate per importare o esportare dati, sincronizzare dati di riferimento o eseguire processi tecnici ricorrenti collegati al sistema informativo.

🔁 Cos'è un'attività?

Un'attività rappresenta un'azione ripetibile eseguita da Teemant, solitamente basata su:

un ambito dati (entità, modello oggetto, documenti, ecc.)
un trasporto (SFTP, e-mail, API, webhook, …)
un programma o un trigger

Esempio mostrato nello screenshot:

Negozio di importazione
Entità: Negozio
Trasporto: importazione SFTP
Pianificatore: ABILITATO

Ciò significa che Teemant importerà periodicamente i dati del negozio (magazzino) da un sistema esterno tramite SFTP.

🧩 Casi d'uso tipici

I compiti vengono comunemente utilizzati per:

📥 Importazione dati
Dati di riferimento (negozi, prodotti, utenti, contratti, ecc.)
Configurazione o dati master provenienti da sistemi esterni
📤 Esportazioni di dati
Output strutturati (JSON, ZIP, documenti)
Invio dei dati raccolti o elaborati dall'IA al SI
🔄 Lavori di sincronizzazione
Mantenere i modelli di oggetti Teemant allineati con i database esterni
Aggiornamento periodico dei dati condivisi
⚙️ Altre operazioni programmate
Elaborazione batch
Pulizia, consolidamento o futuri lavori automatizzati

Il sistema è progettato per essere estensibile, in modo che nel tempo possano essere aggiunti altri tipi di attività ricorrenti o attivate.

🧠 Come funzionano le attività con i trasporti

Le attività non spostano i dati da sole, ma si basano sui trasporti:

Un trasporto definisce come vengono scambiati i dati (SFTP, e-mail, API, webhook, ecc.)
Un'attività definisce quando e cosa viene scambiato

Questa separazione consente:

Riutilizzo dello stesso trasporto in più attività
Modifica degli orari senza toccare le impostazioni di connettività

▶️ Esecuzione manuale vs. pianificata

I compiti possono essere:

Programmato (esecuzione regolare, a seconda della configurazione)
Attivato manualmente (tramite l'azione Esegui)

Ciò è particolarmente utile per:

Test di importazione/esportazione
Sincronizzazioni una tantum
Risoluzione dei problemi di produzione

Migliori pratiche

🔧 Configurare le attività principalmente negli spazi di lavoro di sviluppo
🧪 Convalida il comportamento negli spazi di lavoro di prova
🚀 Mantieni le attività di produzione limitate, stabili e monitorate
📦 Utilizza un'area di lavoro per ogni applicazione client per isolare attività e flussi di dati

Torna all'inizio

🧠 Teemant Agents Builder — Panoramica

Teemant Agents Builder è l'ambiente di progettazione principale della piattaforma. È qui che gli agenti di intelligenza artificiale vengono creati, strutturati, orchestrati e pubblicati.

Un agente Teemant non è solo un chatbot.

👉 Si tratta di un processo di intelligenza artificiale di livello aziendale, in grado di guidare gli utenti, applicare la logica aziendale, interagire con i sistemi e produrre output strutturati.

🧩 Tipi di agenti: processi vs navigatori

⚙️ Processi (Processi aziendali)

I processi sono agenti completi e autonomi progettati per:

Raccogliere informazioni strutturate
Guida gli utenti passo dopo passo
Applicare regole aziendali e calcoli
Genera output (JSON, documenti, esportazioni, e-mail, ecc.)

Casi d'uso tipici

Dichiarazione di incidente o sinistro
Segnalazione danni
Dichiarazione di responsabilità o di assunzione di responsabilità

I processi rappresentano flussi aziendali end-to-end.

🧭 Navigatori (Altri)

I navigatori sono agenti di orchestrazione.

Non finalizzano un processo aziendale ma vengono utilizzati per:

Qualificare la situazione dell'utente
Autenticare o identificare gli utenti
Indirizzare gli utenti al sottoprocesso corretto
Flussi divisi in base a condizioni o scelte

Casi d'uso tipici

Verifica della polizza assicurativa
Scelta del tipo di incidente
Instradamento tra scenari “con terze parti / senza terze parti”

💡 In un'applicazione completa, i Navigatori fungono da elementi costitutivi che collegano e organizzano più processi.

🧱 Scheda principale — Configurazione agente

La scheda Principale definisce l'identità e il comportamento di un agente.

📛 Identificazione

Nome: identificatore tecnico (univoco, stabile)
Nome visualizzato: nome leggibile dall'uomo mostrato nei canali e nell'interfaccia utente

✅ Buone pratiche:

Utilizzare convenzioni di denominazione rigorose, tra cui ambito, versione e scopo.

🌍 Contesti AI

Contesto globale Definisce l'ambiente generale:
azienda o organizzazione
vocabolario e terminologia
regole globali
tono generale

Contesto dell'agente Definisce la missione specifica dell'agente:
ciò che l'agente deve realizzare
chi sono gli utenti
tono di comunicazione
dati da raccogliere

👉 Questi contesti influenzano direttamente il comportamento dell'IA durante le conversazioni e l'elaborazione delle e-mail.

🚀 Modalità di avvio

FLOW_ONLY L'agente viene utilizzato solo all'interno di un altro processo → non direttamente visibile agli utenti finali

DIRETTO L'agente è accessibile direttamente da un canale → visibile come punto di ingresso per gli utenti

💡 Questa impostazione determina se l'agente è:

un componente interno
o un punto di ingresso rivolto all'utente

🧬 Scheda Flusso — Orchestrazione dei processi

La scheda Flusso fornisce una rappresentazione visiva della logica dell'agente.

Ogni blocco rappresenta:

un altro agente
un navigatore
un passaggio di calcolo
un identificatore
un messaggio finale
un'azione di esportazione o di posta elettronica

🔗 Logica di flusso

Passaggi sequenziali
Rami condizionali
Alberi decisionali complessi

👉 È qui che la business intelligence e l'orchestrazione trovano reale applicazione.

📡 Pubblicazione e disponibilità

📤 Pubblica / Annulla pubblicazione

Pubblica: attiva l'agente
Annulla pubblicazione: lo disabilita immediatamente

Una volta pubblicato, l'agente diventa accessibile:

attraverso i canali configurati
in base alla sua modalità di lancio
rispettare le regole di accesso all'area di lavoro

📦 Esporta / Importa (file .tee)

Gli agenti possono essere:

esportati come file .tee
importati in altri spazi di lavoro

Ciò consente:

modelli e riutilizzo
controllo di versione
standardizzazione interprogetto
distribuzioni più rapide

💡 I file .tee sono una risorsa fondamentale dell'ecosistema Teemant.

🧠 Buone pratiche

🏷️ Convenzioni di denominazione rigorose

Includi sempre:

ambito funzionale
versione
ruolo di agente

Ciò è fondamentale per:

manutenzione
scalabilità
leggibilità dei flussi complessi

🧩 Architettura modulare

Mantenere gli agenti piccoli e specializzati
Riutilizza i navigatori
Centralizzare la logica condivisa

👉 Quanto più semplice è ciascun agente, tanto più robusto diventa il sistema nel suo complesso.

🧩 Riepilogo

Teemant Agents Builder ti consente di:

progettare processi aziendali complessi basati sull'intelligenza artificiale
orchestrare percorsi utente intelligenti
collegare l'intelligenza artificiale ai sistemi aziendali
distribuire su più canali
industrializzare e replicare i casi d'uso dell'IA

👉 Si tratta di una piattaforma di progettazione di processi aziendali basata sull'intelligenza artificiale, non solo di un generatore di chatbot.

Torna all'inizio

📞 Chiamate dell'agente Teemant (processi riutilizzabili)

🔍 Panoramica

Le chiamate agli agenti Teemant sono processi richiamabili progettati per essere riutilizzati su uno o più agenti. Rappresentano blocchi di processo autonomi che possono essere richiamati da flussi diversi anziché essere duplicati.

Considerateli come una logica aziendale condivisa che può essere richiamata ogni volta che è necessario.

🧩 Perché le chiamate degli agenti sono importanti

Le chiamate degli agenti sono particolarmente utili quando:

🔁 Lo stesso processo deve essere eseguito più volte
🧠 La logica è complessa e dovrebbe risiedere in un unico posto
🧱 Desideri architetture di agenti pulite e gestibili
🔄 Più agenti o flussi si basano sulla stessa regola aziendale

Esempi tipici:

Fasi di autenticazione o identificazione
Verifica della polizza assicurativa
Logica di qualificazione del danno
Controlli di idoneità
Circostanze (amichevole vs. responsabilità, ecc.)

🏗️ Come funzionano le chiamate degli agenti

Una chiamata dell'agente è:

Un processo, non un agente conversazionale completo
Non esposto direttamente agli utenti
Attivato da un altro agente o flusso
Eseguito con il contesto corrente

📌 Si comporta come una chiamata di funzione all'interno di un flusso di lavoro conversazionale più ampio.

🧠 Modello di esecuzione

Un agente principale raggiunge un punto in cui è richiesta una logica condivisa
Chiama un agente di chiamata
La chiamata dell'agente:
Utilizza il contesto corrente
Esegue il suo processo interno
Il controllo viene restituito all'agente chiamante

➡️ Nessuna interruzione per l'utente, nessuna logica duplicata.

🧭 Casi d'uso tipici

Caso d'usoPerché utilizzare una chiamata agente🔐 AutenticazioneStessa verifica utilizzata in molti flussi🧾 Ricerca policyCondivisa tra più tipi di reclamo🚗 CircostanzeLogica amichevole vs di terze parti📄 Validazione del documentoRegole di convalida riutilizzabili🔁 Controlli in più fasiLogica decisionale centralizzata

🧱 Migliori pratiche di architettura

✅ Una chiamata all'agente = una responsabilità

Mantieni le chiamate degli agenti focalizzate
Evitare di mischiare la navigazione dell'interfaccia utente e la logica di base
Nominali in modo molto esplicito

📌 Esempio di convenzione di denominazione:

FLOT6x-AMIABLE-CALL
FLOT6x-CIRCUMSTANCE-CALL
FLOT1.0-IDENTIFICATORE-POLICY

Quando i flussi diventano grandi, è fondamentale assegnare nomi chiari.

🔄 Relazione con gli agenti Teemant

ComponentRole🤖 Teemant AgentAgente rivolto all'utente o agente di orchestrazione🧭 NavigatorGuida gli utenti ai sottoprocessi📞 Agent CallProcesso richiamabile riutilizzabile

➡️ I navigatori decidono dove andare ➡️ Le chiamate degli agenti eseguono la logica condivisa

🚀 Distribuzione e disponibilità

Le chiamate degli agenti sono:
📦 Pubblicato come agenti regolari
🔌 Disponibile per qualsiasi agente nell'area di lavoro
Una volta pubblicati, possono essere riutilizzati immediatamente
Gli aggiornamenti si applicano automaticamente ovunque vengano utilizzati

🧠 Punti chiave

📞 Chiamate dell'agente = Blocchi di processo riutilizzabili
🔁 Evita le duplicazioni, migliora la coerenza
🧩 Essenziale per sistemi di agenti complessi e su larga scala
🏗️ Un pilastro delle architetture pulite di Teemant

Torna all'inizio