Gli strumenti di acquisizione informazioni di GoHighLevel / Squadd in Agent Studio ti consentono di raccogliere input specifici dagli utenti durante una conversazione, come un indirizzo email, un numero di telefono, un'opzione selezionata o una risposta in testo libero. Questi strumenti vengono utilizzati all'interno di un Nodo Sequenziale per raccogliere informazioni strutturate passo dopo passo, prima che l'agente prosegua nella parte successiva del flusso.
- Cosa sono gli strumenti di acquisizione informazioni in Agent Studio
- Quando usare gli strumenti di acquisizione informazioni
- Strumenti di acquisizione informazioni disponibili
- Usare gli strumenti di acquisizione in un Nodo Sequenziale
- Riutilizzare le informazioni acquisite nel flusso
- Come configurare gli strumenti di acquisizione in Agent Studio
- Domande frequenti
Cosa sono gli strumenti di acquisizione informazioni in Agent Studio
Gli strumenti di acquisizione informazioni sono strumenti per la raccolta di input che consentono a un agente di richiedere all'utente informazioni specifiche e di salvare la risposta per un utilizzo successivo nella conversazione.
Invece di affidarsi all'intelligenza artificiale per comprendere ed estrarre dettagli da un messaggio aperto, questi strumenti pongono domande dirette e raccolgono le risposte in un formato strutturato. Ciò è utile quando l'agente necessita di informazioni obbligatorie prima di continuare, come dati di contatto, preferenze, argomenti o selezioni dell'utente.
Ad esempio, un agente può chiedere all'utente di fornire un indirizzo email, inserire un numero di telefono, scegliere da un elenco di opzioni o digitare una risposta breve. Le informazioni raccolte possono poi essere utilizzate dal nodo successivo nel flusso dell'agente.
Quando usare gli strumenti di acquisizione informazioni
Usa gli strumenti di acquisizione informazioni quando il tuo agente deve raccogliere informazioni chiare e strutturate prima di eseguire l'azione successiva.
Casi d'uso comuni includono:
- Raccogliere l'indirizzo email di un utente prima di inviare un messaggio di conferma o di follow-up
- Acquisire un numero di telefono prima di instradare il lead verso un flusso di vendita o supporto
- Chiedere all'utente di scegliere un'opzione da un elenco prima di indirizzarlo al percorso corretto
- Raccogliere testo libero, come un argomento, una richiesta, una domanda o una descrizione
- Raccogliere i dettagli necessari prima che un nodo AI Agent generi contenuti, risponda a una domanda o esegua un'altra operazione
Questi strumenti sono particolarmente utili quando le informazioni sono prevedibili e non richiedono ragionamento AI per essere raccolte.
Come funzionano gli strumenti di acquisizione informazioni
Gli strumenti di acquisizione informazioni funzionano all'interno di un Nodo Sequenziale. Un Nodo Sequenziale esegue ogni passaggio configurato uno alla volta, consentendo all'agente di richiedere informazioni in un ordine controllato.
Per una spiegazione dettagliata del funzionamento dei Nodi Sequenziali, consulta Come costruire flussi di agente strutturati usando il Nodo Sequenziale in Agent Studio.Quando uno strumento di acquisizione informazioni viene aggiunto a un Nodo Sequenziale, l'agente chiede all'utente l'input richiesto. Dopo che l'utente risponde, la risposta viene salvata e può essere utilizzata in seguito nel flusso.
Ad esempio, puoi creare una sequenza che chiede:
- Qual è il tuo indirizzo email?
- Qual è il tuo numero di telefono?
- Chi è il pubblico di destinazione?
Una volta che l'utente risponde a ogni domanda, le risposte acquisite possono essere passate a un altro nodo, come un nodo AI Agent, dove possono essere usate per generare una risposta personalizzata o completare l'azione successiva.
Strumenti di acquisizione informazioni disponibili
Agent Studio include attualmente quattro strumenti di acquisizione informazioni.
Indirizzo email
Lo strumento Indirizzo email acquisisce un indirizzo email dall'utente.
Usalo quando l'agente ha bisogno di un'email valida prima di continuare, ad esempio per inviare conferme, follow-up, dettagli sul lead o informazioni su una candidatura.
Esempio:
Fornisci il tuo indirizzo email così potremo inviarti i dettagli.
Numero di telefono
Lo strumento Numero di telefono acquisisce un numero di telefono dall'utente.
Usalo quando l'agente necessita di informazioni di contatto per richiamate, qualificazione vendite, follow-up su appuntamenti o instradamento del supporto. Lo strumento aiuta a garantire che l'utente inserisca un numero di telefono valido prima che il flusso continui.
Esempio:
Inserisci il tuo numero di telefono così il nostro team potrà ricontattarti.
Scelta singola
Lo strumento Scelta singola consente all'utente di selezionare un'opzione da un elenco predefinito.
Usalo quando l'agente ha bisogno che l'utente scelga tra opzioni fisse, come un tipo di servizio, livello di interesse, categoria di pubblico, argomento di supporto o passo successivo. L'opzione selezionata può essere usata per instradare la conversazione o personalizzare la risposta successiva.
Esempio:
Con cosa possiamo aiutarti?
Prezzi
Prenotare una chiamata
Supporto sul prodotto
Informazioni generali
Testo libero
Lo strumento Testo libero acquisisce testo a risposta aperta dall'utente.
Usalo quando l'utente deve digitare una risposta personalizzata, come un argomento, una domanda, una descrizione, il nome di un'azienda, un obiettivo o una richiesta speciale.
Esempio:
Di quale argomento vorresti che trattasse il contenuto?
Usare gli strumenti di acquisizione in un Nodo Sequenziale
Gli strumenti di acquisizione informazioni devono essere aggiunti all'interno di un Nodo Sequenziale.
Una configurazione tipica è la seguente:
- Inizia con un trigger, come un messaggio in chat, un Tag lead ecc.
- Aggiungi un Nodo Sequenziale.
- Aggiungi uno o più strumenti di acquisizione informazioni all'interno del Nodo Sequenziale.
- Configura il prompt per ogni strumento.
- Salva la risposta dell'utente in una variabile.
- Usa il valore acquisito nel nodo o percorso successivo.
Nell'esempio condiviso, il flusso inizia con un trigger su messaggio in chat. La conversazione si sposta poi in un Nodo Sequenziale che contiene uno strumento di acquisizione Scelta singola. Dopo che l'utente seleziona un'opzione, il flusso prosegue verso un Router e poi verso un Agente di Triage, che indirizza l'utente sul percorso corretto in base alla progettazione della conversazione.
Questo consente all'agente di raccogliere l'input necessario prima di decidere cosa deve accadere dopo.
Riutilizzare le informazioni acquisite nel flusso
Le informazioni acquisite possono essere riutilizzate in seguito nel flusso dell'agente come variabili di runtime.
Ciò significa che la risposta raccolta dall'utente può essere inserita in prompt, messaggi o azioni successivi.
Ad esempio, se un Nodo Sequenziale acquisisce:
Argomento: AI nel settore beauty
Pubblico di destinazione: Adulti over 60
Indirizzo email: user@example.com
Numero di telefono: +1 555 123 4567
Il nodo AI Agent successivo può usare quei valori per generare un output personalizzato, ad esempio:
Genera un articolo blog sull'argomento acquisito per il pubblico di destinazione selezionato. Includi l'indirizzo email e il numero di telefono acquisiti come dati di contatto.
Questo aiuta a collegare la raccolta strutturata dei dati con azioni basate sull'AI, mantenendo il processo di input prevedibile.
Come configurare gli strumenti di acquisizione informazioni in Agent Studio
Segui questi passaggi per aggiungere strumenti di acquisizione informazioni a un flusso di agente.
Passo 1: Apri il tuo agente
Vai su Agent Studio.
Apri l'agente che vuoi modificare.

Passo 2: Aggiungi o seleziona un Nodo Sequenziale
Aggiungi un Nodo Sequenziale al canvas, oppure apri un Nodo Sequenziale esistente in cui desideri raccogliere informazioni.

Passo 3: Scegli uno strumento di acquisizione informazioni
Dal pannello sinistro, vai alla sezione Acquisizione informazioni.
Scegli uno degli strumenti disponibili:
Indirizzo email
Numero di telefono
Scelta singola
Testo libero
Trascina lo strumento all'interno del Nodo Sequenziale.

Passo 4: Configura il prompt
Aggiungi il messaggio o la domanda che vuoi che l'agente ponga all'utente.
Esempi:
Fornisci il tuo indirizzo email.
Quale numero di telefono dobbiamo usare per contattarti?
Quale opzione descrive meglio la tua richiesta?
Di quale argomento vorresti che trattasse il contenuto?

Passo 5: Salva la risposta come variabile
Assegna un nome di variabile alla risposta acquisita in modo da poterla referenziare in seguito.
Esempi:
phone_number
selected_interest
topic
Queste variabili funzionano come valori riutilizzabili nel resto del flusso dell'agente.
Passo 6: Collega il nodo successivo
Dopo che il Nodo Sequenziale ha raccolto le informazioni richieste, collegalo al passo successivo del tuo flusso.
Questo può essere:
Un Router
Un nodo AI Agent
Un messaggio di conferma
Un altro nodo di azione o elaborazione
Nello screenshot di esempio, il Nodo Sequenziale è collegato a un Agente di Triage, e gli output del router dell'Agente di Triage sono collegati a diversi nodi di agente di follow-up in base alla risposta selezionata dall'utente. Ciò significa che una volta completata la fase di acquisizione, il flusso può instradare la conversazione al passo successivo corretto, come dettagli sui prezzi silver, interesse agli investimenti, conferma via email, risposta per chi non investe o un percorso di fallback generico.

Passo 7: Testa il flusso
Esegui una conversazione di test per verificare che:
Ogni domanda appaia nell'ordine corretto
Gli input di email e numero di telefono vengano validati correttamente
Le opzioni di Scelta singola vengano visualizzate come previsto
Le risposte vengano salvate nelle variabili corrette
Il nodo successivo utilizzi correttamente le informazioni acquisite
Domande frequenti
D: Dove posso trovare gli strumenti di acquisizione informazioni?
Gli strumenti di acquisizione informazioni sono disponibili nel pannello sinistro di Agent Studio, nella sezione Acquisizione informazioni.
D: Quali strumenti di acquisizione informazioni sono disponibili?
Gli strumenti disponibili sono: Indirizzo email, Numero di telefono, Scelta singola e Testo libero.
D: Gli strumenti di acquisizione informazioni usano l'AI?
No. Gli strumenti di acquisizione informazioni sono progettati per la raccolta strutturata di input e non richiedono l'AI per raccogliere la risposta.
D: Quale nodo supporta gli strumenti di acquisizione informazioni?
Gli strumenti di acquisizione informazioni vengono utilizzati all'interno di un Nodo Sequenziale.
D: Posso usare gli strumenti di acquisizione informazioni all'interno di un nodo AI Agent?
Gli strumenti di acquisizione informazioni sono pensati per i Nodi Sequenziali. Se hai bisogno del ragionamento AI, usa un nodo AI Agent dopo aver raccolto i valori.
D: Le informazioni acquisite possono essere usate in seguito nel flusso?
Sì. Le risposte acquisite possono essere salvate come variabili e referenziate in nodi, prompt, messaggi o azioni successivi.
D: La Scelta singola può instradare gli utenti su percorsi diversi?
Sì. L'opzione selezionata può essere usata con un Router o una logica successiva per indirizzare gli utenti sul percorso corretto.
D: Lo strumento Numero di telefono può validare il numero dell'utente?
Sì. Lo strumento Numero di telefono aiuta a raccogliere un numero di telefono valido e può richiedere nuovamente all'utente di inserirlo se il valore immesso non è valido.
D: Qual è un buon caso d'uso per il Testo libero?
Il Testo libero è utile per raccogliere risposte aperte, come un argomento, una descrizione, una domanda, il nome di un'azienda o una richiesta personalizzata.