AI Agent - Orchestrazione LLM in ConvyAI
Cos'è un AI Agent
L'AI Agent rappresenta una major evolution delle capacità Generative AI di ConvyAI. Mentre il nodo Knowledge Base è progettato per la RAG conversazionale - recuperare contenuti e generare risposte ancorate alle fonti - l'AI Agent è costruito per l'orchestrazione di processi: consente all'LLM di interagire con tool esterni, analizzare immagini, invocare funzioni personalizzate e prendere decisioni all'interno di un workflow, tutto direttamente nel FlowDesigner.
Tramite il nodo AI Agent, sviluppatori e utenti avanzati possono interagire direttamente con modelli LLM, eseguire analisi di immagini e combinare diversi tool e servizi esterni senza costruire integrazioni personalizzate o middleware. Tutto avviene nel FlowDesigner in modo controllato e tracciabile - prompt, parametri e output del modello sono configurabili senza uscire dall'ambiente di sviluppo.
Come si differenzia dal nodo Knowledge Base
Sia il nodo Knowledge Base che il nodo AI Agent utilizzano la stessa infrastruttura di AI Models. Ciò che cambia è lo scopo e le capacità disponibili.
| Nodo Knowledge Base | Nodo AI Agent | |
|---|---|---|
| Uso principale | RAG conversazionale - Q&A ancorato a contenuti indicizzati | Orchestrazione di processi - decisioni, estrazione, workflow multi-tool |
| Sorgenti dati | Knowledge Base indicizzata | Input dinamici: testo, immagini, tool esterni via MCP |
| Integrazioni esterne | Nessuna | Server MCP, funzioni JavaScript callable |
| Analisi immagini | Non supportata | Supportata |
| Memoria conversazione | Opzionale, scoped alla sessione | Configurabile tramite impostazioni del nodo |
Quando usare l'AI Agent
L'AI Agent è la scelta giusta quando il modello deve fare più che generare una risposta conversazionale:
- Analisi di ticket e richieste - classificare e instradare automaticamente le richieste in arrivo in base al loro contenuto.
- Estrazione dati strutturati - estrarre campi strutturati da testo libero, documenti o immagini.
- Workflow multi-tool - combinare il ragionamento LLM con servizi esterni connessi via MCP.
- Decision-making complesso - usare l'output del modello per guidare i branch del flusso sulla base di input in formati multipli.
Architettura
Il nodo AI Agent funge da hub di orchestrazione. L'LLM non è solo un generatore di risposte - decide quali tool chiamare, in quale ordine, e come usare i loro output per produrre un risultato finale.
In questa sezione
- Nodo AI Agent - Configura i campi del nodo, prompt, tool e impostazioni di interazione.
- Analisi immagini - Allega e analizza immagini all'interno del prompt dell'agente.
- Server MCP - Connetti tool e servizi esterni tramite Model Context Protocol.
- Funzioni callable - Definisci funzioni JavaScript personalizzate che l'AI può invocare durante l'esecuzione.