Primo Workflow

In questa guida costruirai il tuo primo Canvas da zero: un semplice flusso RAG che recupera documenti e genera una risposta. Al termine saprai navigare l'editor, configurare i nodi fondamentali e pubblicare il flusso come assistente.

Accedere al Canvas

Dalla sidebar sinistra clicca su Canvas (icona nodi). Si apre la lista dei tuoi Canvas. Hai due strade:

1. Da template: clicca Nuovo da Template, scegli uno dei 6 template settoriali e clicca Usa questo template.
2. Da zero: clicca Nuovo Canvas, assegna un nome (ad esempio "RAG Base") e clicca Crea.

Questa guida parte da zero.

L'Interfaccia Editor

L'editor si divide in tre zone:

┌────────────┬─────────────────────────────┬──────────────────┐
│  Palette   │        Workspace            │  Pannello Config │
│  (sinistra)│        (centro)             │   (destra)       │
│            │                             │                  │
│ ○ Begin    │    [Begin] ──→ [Retrieval]  │  Componente:     │
│ ○ LLM      │       ↓                     │  Retrieval       │
│ ○ Retrieval│    [LLM] ──→ [Message]      │  topK: 10        │
│ ○ Message  │                             │  ...             │
│ ○ Switch   │                             │                  │
│ ...        │                             │                  │
└────────────┴─────────────────────────────┴──────────────────┘

Zona	Funzione
Palette (sinistra)	Lista di tutti i 15 componenti. Trascina un componente nel workspace per aggiungerlo al flusso.
Workspace (centro)	Area di lavoro principale. Puoi spostare i nodi, tracciar archi tra porte di output e input, zoomare con la rotella del mouse.
Pannello Config (destra)	Cliccando su un nodo si apre la sua scheda di configurazione. Tutti i parametri del componente sono editabili qui.

Navigazione nel workspace:

• Trascinamento: tieni premuto e trascina per spostare la vista.
• Zoom: rotella del mouse o pulsanti +/- in basso a destra.
• Seleziona nodo: click singolo per selezionarlo e aprire la config.
• Sposta nodo: trascina il nodo nella posizione desiderata.
• Crea arco: clicca sulla porta di output di un nodo (punto sul bordo destro), tieni premuto e trascina fino alla porta di input del nodo successivo.
• Elimina arco: clicca sull'arco e premi il tasto Canc.

Costruire il Flusso RAG di Base

Il flusso che costruirai e:

Begin → Retrieval → LLM → Message

E il flusso minimo per un assistente RAG: raccoglie la domanda, recupera i documenti pertinenti, genera una risposta e la mostra all'utente.

Passo 1 — Nodo Begin

Il nodo Begin e gia presente nel workspace quando crei un Canvas. Cliccalo per aprire la configurazione.

Parametro	Valore
Mode	conversational
Input Fields	(lascia vuoto per il momento — la domanda arriva dal campo chat)

Con mode conversational, il nodo begin riceve automaticamente il testo della chat dell'utente nella variabile {{sys.query}}.

Mode task vs conversational

La mode task avvia il flusso una volta sola con un form strutturato (campi definiti in Input Fields). La mode conversational integra il Canvas come assistente chat: l'utente scrive messaggi e il flusso risponde. Per questo primo esempio, conversational e la scelta giusta.

Passo 2 — Nodo Retrieval

Dalla palette, trascina un Retrieval nel workspace. Posizionalo a destra di Begin. Trascina un arco dalla porta di output di Begin alla porta di input di Retrieval.

Clicca su Retrieval e configura:

Parametro	Valore
Query	{{sys.query}}
topK	10
Documenti aziendali	Abilitato
Knowledge Base	Abilitato
Sorgenti esterne	Disabilitato (per ora)

Il nodo Retrieval cerchera nei documenti aziendali e nella Knowledge Base i 10 passaggi piu pertinenti alla domanda dell'utente.

Passo 3 — Nodo LLM

Trascina un LLM nel workspace, posizionalo a destra di Retrieval, e collega Retrieval → LLM.

Clicca su LLM e configura:

Parametro	Valore
Modello	writer
System Prompt	Sei un assistente aziendale preciso. Rispondi in italiano basandoti esclusivamente sui documenti forniti. Se l'informazione non e nei documenti, dillo esplicitamente. Cita sempre le fonti con [N].
User Prompt	Documenti di contesto:\n{{retrieval_1.formalized_content}}\n\nDomanda dell'utente:\n{{sys.query}}
Temperature	0.3
Max Tokens	2048

Riferimento variabile

{{retrieval_1.formalized_content}} e il testo recuperato dal nodo Retrieval, gia formattato con i titoli dei documenti e i passaggi rilevanti. Il nome retrieval_1 e generato automaticamente dal Canvas (primo nodo Retrieval del flusso). Puoi verificarlo nell'header del nodo.

Passo 4 — Nodo Message

Trascina un Message nel workspace, posizionalo a destra di LLM, e collega LLM → Message.

Clicca su Message e configura:

Parametro	Valore
Content	{{llm_1.content}}
Format	markdown
Show Citations	Abilitato

Il nodo Message raccoglie l'output dell'LLM e lo presenta all'utente con formattazione Markdown e citazioni interattive.

Passo 5 — Verificare il Flusso

Prima di salvare, controlla visivamente che:

• Gli archi siano: Begin → Retrieval → LLM → Message.
• Ogni nodo abbia tutte le porte di input e output collegate correttamente (le porte non collegate compaiono come pallini vuoti).
• Non ci siano nodi isolati (senza archi).

Salvare il Canvas

Clicca Salva in alto a destra (o usa Ctrl+S). Il Canvas viene salvato con lo stato attuale del flusso.

Salvataggio automatico

Queria salva automaticamente le modifiche ogni 30 secondi durante la modifica. L'icona di salvataggio in alto indica lo stato: disco pieno = salvato, disco con punto giallo = modifiche non salvate.

Eseguire e Testare

Esecuzione di Test dall'Editor

Clicca Esegui Test (pulsante play in alto). Si apre un pannello inferiore con un campo di testo. Scrivi una domanda di prova — ad esempio "Quali sono le condizioni del contratto Rossi?" — e premi Invio.

Osserva il flusso in esecuzione:

• I nodi cambiano stato: grigio (in attesa) → giallo (in esecuzione) → verde (completato).
• Il pannello inferiore mostra l'output di ogni nodo man mano che viene prodotto.
• La risposta finale appare nel Message con formattazione Markdown.

Se un nodo mostra stato rosso, clicca su di esso per vedere il messaggio di errore nel pannello config.

Ispezionare gli Output dei Nodi

Durante o dopo l'esecuzione, clicca su qualsiasi nodo per vedere:

• Gli input ricevuti (con i valori effettivi delle variabili).
• Gli output prodotti (con i valori completi).

Questo e utile per verificare che le variabili siano popolate correttamente e che i dati fluiscano come atteso.

Pubblicare come Assistente

Quando il flusso funziona correttamente, puoi pubblicarlo:

1. Clicca Pubblica in alto a destra.
2. Inserisci una descrizione opzionale per gli utenti finali.
3. Scegli Visibilita:
   • Solo io: visibile solo a te.
   • Team: visibile a tutti gli utenti dell'organizzazione.
   • Argomento specifico: disponibile come assistente per un Topic definito.
4. Clicca Conferma pubblicazione.

Una volta pubblicato, il Canvas appare nella lista degli assistenti disponibili nella chat. Gli utenti lo trovano nel menu Assistenti in alto nella chat e possono selezionarlo come interlocutore dedicato.

Prossimi Passi

Hai costruito il tuo primo Canvas funzionante. Ora puoi:

• Aggiungere logica di routing: inserisci un nodo Switch per gestire diversi tipi di domanda in modo diverso.
• Abilitare sorgenti esterne: nel nodo Retrieval, abilita Legal Sources, Pharma Sources o altre banche dati esterne.
• Aggiungere un form di input: cambia la mode di Begin in task e definisci i campi del form.
• Esplorare gli esempi: la pagina Esempi Pratici mostra flussi progressivamente piu complessi.
• Usare un template: la pagina Template Settoriali offre punti di partenza pronti per il tuo settore.

---

Queria v3.1.2 -- Canvas Agent Builder