Panoramica

Gli AI Agent in SurveyAnalytica sono servizi autonomi e distribuibili che possono eseguire logica personalizzata, connettersi ad API esterne, elaborare dati e integrarsi nei workflow. Puoi creare agenti da zero utilizzando istruzioni in linguaggio naturale, distribuirli come endpoint API live e collegarli alle tue campagne, survey e workflow di automazione. Gli agenti vengono gestiti tramite l’Agent Catalog e possono essere creati utilizzando l’Agent Builder basato su AI.

Navigare verso Agents

Dalla barra di navigazione principale, fai clic su Agents per aprire l’Agent Catalog. Il catalogo ha due schede:

• My Agents: Gli agenti che hai creato o a cui hai accesso nel tuo workspace.
• Templates: Template di agenti predefiniti che puoi utilizzare come punto di partenza.

Agent Catalog

L’Agent Catalog mostra tutti i tuoi agenti con il loro stato, la descrizione e le informazioni di distribuzione. Puoi:

• Cercare: Filtrare gli agenti per nome o descrizione.
• Filtrare per stato: Visualizzare tutti gli agenti, solo quelli distribuiti o solo le bozze.
• Creare un nuovo agente: Apre l’Agent Builder.
• Modificare: Modificare il codice, la configurazione o le impostazioni di un agente esistente.
• Eliminare: Rimuovere un agente. Il sistema verifica la presenza di workflow dipendenti prima dell’eliminazione e ti avvisa di eventuali dipendenze attive.

Creazione di un agente

L’Agent Builder offre un ambiente di sviluppo assistito dall’AI per la creazione di agenti.

Configurazione dell’agente

Durante la creazione di un agente, configuri:

• Nome: Un nome descrittivo per l’agente.
• Descrizione: Cosa fa l’agente, utilizzata per la scoperta e la documentazione.
• Codice: Il codice applicativo dell’agente. L’assistente AI può generarlo a partire da descrizioni in linguaggio naturale.
• Variabili d’ambiente: Coppie chiave-valore per segreti e configurazioni (chiavi API, endpoint, ecc.). I nomi vengono automaticamente convertiti in maiuscolo e sanificati.
• Schema Input/Output: Definizioni JSON Schema per i formati di richiesta e risposta dell’API dell’agente, validate in fase di esecuzione.

Generazione del codice basata su AI

Descrivi in linguaggio naturale cosa dovrebbe fare il tuo agente e l’assistente AI genera il codice applicativo completo. Il codice generato include:

• Configurazione del server e routing
• Gestori degli endpoint API
• Validazione dell’input
• Integrazioni con API esterne
• Gestione degli errori

Knowledge Base (RAG)

Gli agenti possono essere potenziati con una knowledge base per la Retrieval-Augmented Generation (RAG):

• URL scraping: Fornisci degli URL e il sistema estrae il contenuto testuale, quindi lo segmenta in chunk ottimizzati per il retrieval.
• Caricamento PDF: Carica documenti PDF (fino a 10 MB) che vengono analizzati e suddivisi in chunk per il retrieval della conoscenza.
• Chunking del testo: Il contenuto viene automaticamente suddiviso in segmenti ottimizzati per le prestazioni di retrieval.

Rilevamento delle variabili d’ambiente mancanti

Il sistema analizza automaticamente il codice dell’agente alla ricerca di riferimenti a variabili d’ambiente e ti avvisa di eventuali variabili referenziate nel codice ma non definite nella configurazione. Le variabili fornite dalla piattaforma sono escluse da questo controllo.

Distribuzione di un agente

La distribuzione crea un endpoint API live e accessibile per il tuo agente:

1. Il sistema pacchettizza il codice e la configurazione del tuo agente.
2. Viene creato e distribuito nel cloud un servizio containerizzato.
3. Le variabili d’ambiente vengono iniettate in modo sicuro nel runtime.
4. L’agente riceve un URL endpoint univoco per le chiamate API.

Test di un agente

Prima o dopo la distribuzione, puoi testare gli agenti effettuando chiamate API tramite l’interfaccia dell’Agent Catalog. Invia richieste di esempio conformi allo schema di input e verifica che le risposte corrispondano allo schema di output previsto.

Template di agenti

La piattaforma fornisce template di agenti predefiniti per casi d’uso comuni. I template fungono da punto di partenza che puoi personalizzare:

• Sfoglia i template disponibili nella scheda Templates.
• Fai clic su un template per visualizzarne l’anteprima della configurazione e del codice.
• Utilizza un template come punto di partenza per un nuovo agente, il che copia la configurazione del template nell’Agent Builder per la personalizzazione.

Agenti basati su modelli

I modelli ML addestrati possono essere distribuiti automaticamente come agenti. Quando distribuisci un modello come agente (dall’interfaccia ML Models), il sistema:

1. Verifica che il modello abbia una versione live valida.
2. Crea un wrapper agente attorno al modello addestrato per l’inferenza in tempo reale.
3. Distribuisce l’agente come endpoint API live.
4. Collega l’agente al record del modello per una gestione semplificata.

Agenti nei workflow

Gli agenti si integrano nei workflow di SurveyAnalytica tramite il motore di automazione dei workflow. Puoi:

• Aggiungere un agente come passaggio in un workflow di campagna
• Attivare gli agenti in base alle risposte al survey o a eventi sui dati
• Concatenare più agenti in sequenza
• Utilizzare gli output di un agente come input per i passaggi successivi del workflow

Gestione del ciclo di vita dell’agente

• Aggiornare: Modificare il codice dell’agente e ridistribuirlo.
• Rimuovere dalla distribuzione: Portare l’agente offline mantenendo la configurazione.
• Eliminare: Rimuovere permanentemente l’agente. Il sistema avvisa di eventuali workflow dipendenti prima di consentire l’eliminazione.
• Monitorare: Visualizzare i log delle invocazioni dell’agente e le metriche di prestazione.