Cosa fa un agente
Un agente permette all’assistente di fare qualcosa, oltre a rispondere – ad esempio verificare un ordine, cercare in un catalogo o aprire una richiesta di assistenza.
Quando la domanda di un utente corrisponde a un agente, Echo7 raccoglie i dati necessari, esegue le azioni dell’agente e restituisce il risultato in chat. Gli agenti appartengono a un’integrazione, che contiene le impostazioni di collegamento comuni.
Passo 1: aggiungi l’agente
Apri il menu contestuale dell’integrazione e scegli Agenti per l’integrazione, poi fai clic su Aggiungi.
Inserisci un Nome tecnico stabile, ad esempio WooCommerce_GetOrder, e una Descrizione di ciò che fa.
Scegli la Modalità di attivazione: semantica (attivata dalle domande degli utenti) oppure solo quando richiamato da un workflow.
Scegli la Fase di esecuzione: prima o dopo la ricerca nei tuoi contenuti.
Passo 2: scrivi le domande di attivazione
Aggiungi le richieste che devono attivare l’agente – una per riga, in linguaggio naturale. Ad esempio:
- Voglio sapere a che punto è il mio ordine
- Dov’è l’ordine che ho fatto la settimana scorsa?
- Trova gli ordini del cliente partendo dalla sua email
Evita parole chiave isolate o termini tecnici come “API” o “JSON”. Ogni frase deve contenere abbastanza contesto da distinguere questo agente dagli altri.
Passo 3: definisci i parametri
I parametri sono i dati di cui l’agente ha bisogno prima di agire – come un numero d’ordine o un indirizzo email.
- Scegli il Tipo parametro: testo, email, numero, data, ora, combobox, checkbox, scelta multipla, nascosto e altri.
- Usa Spiegazione su come deve essere rilevato dall’IA per descrivere con precisione cosa estrarre – e quando lasciare il campo vuoto.
- Segna come Obbligatorio solo ciò che è davvero indispensabile. L’assistente chiederà all’utente i dati mancanti.
- Per le prenotazioni, usa campi data e ora con Picker inline, disattiva Consenti passato e imposta giorni e orari selezionabili.
Passo 4: aggiungi le azioni
Le azioni sono ciò che l’agente esegue una volta ottenuti i parametri. Vengono eseguite in ordine.
| Tipo azione | Cosa fa |
|---|---|
| Chiamata Webhook | Chiama un endpoint HTTP, ad esempio /orders/{{order_id}}. |
| Chiamata MCP / Chiamata UCP | Usa un tool esposto da un server MCP o UCP. |
| Genera query SQL | Interroga un database tramite un connettore a database. |
| Invia mail | Invia un’email ai destinatari definiti nell’assistente. |
| JavaScript | Esegue codice nella pagina che ospita l’assistente. |
| Nessuna | Raccoglie solo i dati, che un workflow userà nel passaggio successivo. |
Usa {{nome_parametro}} per inserire i valori dei parametri in URL, header e body. I valori estratti dalla risposta di un’azione possono essere riutilizzati in quella successiva.
Passo 5: abilitalo sul tuo assistente
Modifica l’assistente, vai a Configurazione integrazioni e fai clic su Agenti accanto all’integrazione. Spunta Abilitato per l’agente. Se vuoi, personalizza frasi di attivazione o parametri solo per questo assistente – l’agente originale resta invariato per tutti gli altri.
Buone pratiche
- Mantieni stabili i nomi dell’agente e dei parametri – workflow e placeholder dipendono da essi.
- Fai test con domande realistiche, anche con dati mancanti.
- Usa Bloccato per sospendere un agente senza eliminarlo.
Preferisci una guida passo passo? Prenota una sessione di formazione e uno specialista Echo7 aiuterà il tuo team nella configurazione.
Prenota una sessione di formazioneVuoi approfondire?
Questa guida copre gli aspetti essenziali. Per la documentazione dettagliata su ogni impostazione e funzionalità, consulta la Wiki completa di Echo7.
Echo7 Wiki