Descrizione del flusso
Scopo e benefici
Panoramica
Questo workflow implementa un assistente AI basato su Google Sheets, progettato per rispondere alle domande degli utenti utilizzando esclusivamente le informazioni di un Google Sheet fornito. Il sistema garantisce risposte affidabili e ancorate al documento, evitando di introdurre qualsiasi informazione non presente nel foglio fornito. Il workflow è modulare, scalabile e adatto ad automatizzare attività di Q&A e supporto basate su documenti, risultando utile per la gestione della conoscenza, il supporto clienti e le interrogazioni su documenti interni.
Struttura del Workflow
Il workflow è composto dai seguenti componenti principali:
| Nome Nodo | Scopo |
|---|
| Chat Input | Accetta le domande degli utenti e il caricamento di file. |
| Message Widget | Mostra un messaggio di benvenuto (o informativo) all’utente. |
| Chat Output | Mostra risposte, inclusi i messaggi di benvenuto e le risposte generate dall’AI. |
| Chat History | Mantiene una breve memoria degli ultimi messaggi per fornire contesto all’agente AI. |
| Google Sheets Retriever | Recupera il contenuto di un Google Sheet specificato e lo prepara come strumento. |
| Tool Calling Agent | Componente AI che risponde alle domande degli utenti usando solo il Google Sheet come base di conoscenza. |
I collegamenti nel flow connettono questi nodi, assicurando che i dati fluiscano senza problemi dall’input dell’utente, attraverso il recupero del documento e il ragionamento dell’AI, fino all’output utente.
Logica Passo-Passo
Messaggio di Benvenuto & Raccolta Input
- Quando un utente apre l’assistente, un Message Widget mostra un messaggio di benvenuto personalizzabile, invitando a caricare o selezionare un documento e a porre domande.
- Il nodo Chat Input cattura le domande dell’utente (testuali o tramite file) e le inserisce nel workflow.
Recupero Documento
- Il nodo Google Sheets Retriever consente all’utente (o al sistema) di selezionare uno specifico Google Sheet (e tab) da utilizzare come fonte di informazioni. Il nodo recupera il contenuto e lo espone come “tool” per l’agente AI.
Contesto Cronologia Chat
- Il nodo Chat History registra gli ultimi 5 messaggi (fino a 800 token) per fornire contesto, permettendo all’AI di rispondere in modo più coerente e contestualizzato in conversazioni multi-turno.
Ragionamento AI con Restrizioni
- Il Tool Calling Agent è il cuore AI del sistema. Esso:
- Riceve la domanda dell’utente e la cronologia chat rilevante.
- Ha accesso al Google Sheet come unico strumento/base di conoscenza.
- È governato da un prompt di sistema dettagliato che impone:
- Le risposte devono essere esclusivamente basate sul contenuto del foglio.
- Nessuna conoscenza esterna o supposizione è permessa.
- Se la risposta non è presente, l’agente deve dichiararlo.
- È incoraggiata la citazione della sezione rilevante per trasparenza.
Presentazione della Risposta
- La risposta dell’agente AI viene mostrata all’utente tramite un nodo Chat Output.
Diagramma del Flow (Concettuale)
[Input Utente]
↓
[Messaggio di Benvenuto] → [Chat Output (benvenuto)]
↓
[Chat Input]
↓
[Tool Calling Agent] ← [Chat History]
↑
[Google Sheets Retriever]
↓
[Chat Output (risposta)]
Caratteristiche e Vantaggi Principali
Risposte Ancorate al Documento:
Garantisce che tutte le risposte AI siano tracciabili al Google Sheet fornito, fondamentale per compliance, affidabilità e trasparenza.
Scalabile e Riutilizzabile:
Il design modulare consente di collegare diversi documenti, regolare le impostazioni di recupero o sostituire il modello AI secondo necessità.
Consegna Automatica della Conoscenza:
Gli utenti possono ottenere autonomamente risposte su dati documentali senza intervento manuale, riducendo il carico di supporto e scalando l’accesso alle informazioni.
Risposte Contestualizzate:
Sfruttando la cronologia recente della chat, il sistema può gestire domande di follow-up e scambi multi-turno in modo più efficace.
Gestione degli Errori:
Se la risposta non è presente nel documento, l’AI lo comunica chiaramente, prevenendo disinformazione.
Esempi di Utilizzo
- Q&A su Knowledge Base Interna:
I dipendenti possono interrogare documenti di policy, listini prezzi o registri di progetto archiviati in Google Sheets. - Supporto Clienti:
I clienti ricevono risposte precise basate sulla documentazione ufficiale, come specifiche di prodotto o FAQ. - Estrazione Dati Automatica:
Risposte strutturate a richieste di dati estemporanee da fogli operativi.
Conclusione
Questo workflow automatizza il processo di risposta alle domande basandosi esclusivamente sul contenuto di un Google Sheet selezionato. Il suo rigoroso rispetto della conoscenza documentale e il design robusto e scalabile lo rendono uno strumento prezioso per le organizzazioni che cercano un’erogazione di informazioni precisa, tracciabile ed efficiente.
