Canvas — Agent Builder
Il Canvas e il costruttore visuale di Queria per creare pipeline di agenti AI. Con un'interfaccia drag-and-drop puoi collegare componenti funzionali — recupero documenti, ragionamento AI, routing logico, interazione utente — per costruire flussi di lavoro automatizzati senza scrivere una riga di codice.
Il risultato e un agente AI personalizzato che puoi pubblicare come assistente dedicato per la tua organizzazione o per un team specifico.
Canvas vs Chat Diretta
Non tutto richiede un Canvas. La chat diretta e rapida e flessibile; il Canvas serve quando hai bisogno di logica strutturata e ripetibile.
| Situazione | Usa la Chat | Usa il Canvas |
|---|---|---|
| Domanda estemporanea su un documento | Si | No |
| Analisi guidata con step predefiniti | No | Si |
| Risposta semplice in linguaggio naturale | Si | No |
| Routing automatico per tipo di richiesta | No | Si |
| Flusso con modulo di input strutturato | No | Si |
| Confronto di documenti al volo | Si | No |
| Processo aziendale ripetibile (es. analisi sinistri) | No | Si |
| Integrazione multi-sorgente automatizzata | No | Si |
| Iterazione su liste di elementi | No | Si |
| Conversazione generica con memoria | Si | No |
Concetti Fondamentali
Nodo (Componente)
Un nodo e un blocco funzionale con un ruolo preciso: eseguire una chiamata LLM, recuperare documenti, valutare una condizione, raccogliere input dall'utente. Ogni nodo ha parametri configurabili e produce uno o piu valori in uscita (output).
Arco (Edge)
Un arco e il collegamento tra due nodi. Definisce l'ordine di esecuzione e il percorso dei dati: l'output di un nodo diventa disponibile per i nodi successivi tramite riferimenti variabile.
DAG (Grafo Diretto Aciclico)
Il Canvas esegue i nodi seguendo un DAG: ogni nodo parte solo quando tutti i suoi predecessori hanno terminato. Il motore gestisce automaticamente la parallelizzazione dove possibile.
Variabili
Le variabili sono riferimenti ai valori prodotti dai nodi, con la sintassi {{componente.chiave}}. Ad esempio, {{retrieval_1.formalized_content}} contiene il testo recuperato dal primo nodo Retrieval. Le variabili si usano nei prompt, nelle condizioni e nelle configurazioni di qualsiasi nodo successivo.
Esecuzione Streaming
Il Canvas trasmette i risultati in tempo reale tramite SSE (Server-Sent Events). L'utente vede le risposte token per token, esattamente come nella chat diretta, anche all'interno di flussi articolati con piu componenti LLM.
Sessione e Sospensione
Alcuni componenti (come UserFillUp) possono sospendere l'esecuzione in attesa di input aggiuntivi dall'utente. La sessione viene ripresa in modo trasparente quando l'utente fornisce le informazioni richieste.
Componenti Disponibili
Il Canvas mette a disposizione 15 componenti suddivisi in sei categorie:
| Categoria | Componenti |
|---|---|
| Flusso Base | Begin, Message, Switch |
| Intelligenza Artificiale | LLM, Retrieval, Categorize, Agent |
| Interazione Utente | UserFillUp |
| Manipolazione Dati | VariableAssigner, VariableAggregator, DataOperations |
| Cicli | Iteration, Loop, ExitLoop |
| Composizione | Invoke |
Per la documentazione completa di ogni componente, consulta la pagina Componenti.
Template Settoriali
Queria include 6 template pronti all'uso, uno per ciascun settore supportato. Ogni template e un punto di partenza che puoi personalizzare:
| Settore | Template | Componenti Principali |
|---|---|---|
| Assicurativo | Analisi Sinistro | Begin, Categorize, Retrieval, LLM, Switch, UserFillUp, Message |
| Legale | Ricerca Normativa Assistita | Begin, Retrieval, LLM, Message |
| Alimentare | Verifica Conformita Prodotto | Begin, Retrieval, LLM, Message |
| Chimico | Analisi Scheda Sicurezza | Begin, Retrieval, LLM, Message |
| Farmaceutico | Ricerca Trial Clinici | Begin, Retrieval, DataOperations, LLM, Message |
| Fiscale | Assistente Adempimenti Fiscali | Begin, Categorize, Retrieval, LLM, Message |
Per i dettagli su ogni template, consulta la pagina Template Settoriali.
Sezioni della Guida Canvas
- Primo Workflow -- Crea il tuo primo Canvas in pochi minuti: dall'interfaccia editor al flusso RAG di base.
- Componenti -- Documentazione completa di tutti i 15 componenti con parametri, output e casi d'uso.
- Variabili e Riferimenti -- Come usare la sintassi
{{namespace.path}}per collegare i nodi e passare dati tra componenti. - Esempi Pratici -- Tre esempi progressivi: RAG semplice, Smart Router e Analisi Sinistro Assicurativo completo.
- Template Settoriali -- I 6 template predefiniti con schema del flusso, fonti dati e consigli di personalizzazione.
Inizia dai template
Se stai muovendo i primi passi, parti da un template settoriale anziche da zero. In pochi clic hai un flusso funzionante da esaminare e adattare alle tue esigenze.
Queria v3.1.2 -- Canvas Agent Builder