Risposta diretta
Nelle istruzioni di un managed agent non scrivi link di prenotazione, email di supporto o nome dell’attività: inserisci Custom Values e campi del Business Profile come segnaposto. Ogni sub-account fornisce i propri valori, l’agente li legge a ogni esecuzione, e cambiare un valore non richiede di ripubblicare.
Il problema che i segnaposto risolvono
Hai scritto un agente AI per un cliente. Funziona: risponde alle domande frequenti, gestisce le obiezioni, rimanda al link di prenotazione. Arriva il secondo cliente. Stesso tipo di attività, stessa logica. Copi le istruzioni e cambi a mano il nome, il telefono, il sito, l’email, il link di booking.
Al terzo cliente ti metti seduto e ricominci. Al quinto stai già sbagliando qualcosa — un link del cliente A rimasto nelle istruzioni del cliente C, un nome che non corrisponde.
Non è un problema di attenzione. È un problema di architettura. Le istruzioni non dovrebbero contenere dati: dovrebbero contenere riferimenti a dati che vivono altrove e cambiano per sub-account.
GoHighLevel risolve questo con due fonti: i Custom Values e il Business Profile. Entrambi funzionano come segnaposto nelle istruzioni del managed agent custom values e si risolvono a runtime, quando l’agente gira.
Come inserire segnaposto nelle istruzioni del managed agent
Vai in AI Agents → Agent Studio. Apri il managed agent e, se è già salvato, clicca Edit Agent. Arrivi all’editor delle Instructions.
Metti il cursore nel punto esatto dove deve comparire il valore — dentro la frase, non a capo. Poi clicca Insert value nell’intestazione dell’editor.
Si apre un selettore con due categorie principali:
- Custom values — link di prenotazione, email di supporto, offerte, qualsiasi dato che hai creato tu in Settings → Custom Values.
- Business profile — nome attività, email, telefono, sito, indirizzo, titolare: dati che GoHighLevel tiene già per ogni sub-account.
Scegli il valore e lui compare nell’editor come una pillola colorata. Passando il mouse sulla pillola vedi il valore attuale del sub-account in cui stai lavorando. Se il sub-account non ha ancora quel valore, la pillola mostra Not set in this sub-account.
Puoi anche creare un nuovo Custom Value al volo: l’opzione New custom value… in fondo al selettore lo crea e lo inserisce in un colpo solo, senza uscire dall’editor.
Il testo che deve restare letterale — tipo un placeholder di template come Dear {{name}}, — non viene toccato. Solo le pillole vengono risolte.
L’avviso Not set e la finestra Set custom values to publish
Hai finito le istruzioni. Clicchi Publish. Se uno o più Custom Values non hanno un valore nel sub-account corrente, GoHighLevel apre la finestra Set custom values to publish prima di procedere.
Da lì puoi assegnare i valori mancanti e cliccare Save and publish: GoHighLevel crea i valori e pubblica in un’unica operazione. Non devi uscire, andare in Settings, tornare.
La stessa logica vale quando pubblichi via API: la chiamata controlla i valori e restituisce un errore per ogni segnaposto non impostato. Non pubblica silenziosamente con dati vuoti. Questo è uno dei pochi posti dove il sistema non si rompe in silenzio — ma solo perché lo blocca attivamente.
Quello che nessuno dice
Cambiare un valore non richiede di ripubblicare l’agente
Se aggiorni un Custom Value in Settings il managed agent lo legge dalla corsa successiva. Nessun passaggio in Agent Studio, nessun nuovo Publish. Questo vale per Business Profile e Custom Values standard.
- Business profile — nome, email, telefono, sito: cambiali in Settings e valgono subito
- Custom values standard — aggiornali in Settings senza toccare l’agente
- Segnaposto data e ora — cambiano a ogni esecuzione ma non stanno nel selettore Insert value
Managed agent custom values e il builder AI
Nell’editor c’è anche un builder AI: gli descrivi il comportamento che vuoi e lui costruisce le istruzioni. Quando gli chiedi di usare un link o un dato già salvato, cerca un Custom Value con quel nome nel sub-account. Se lo trova, lo usa. Se non lo trova, usa quello che gli hai passato nel prompt o chiede conferma.
Non inventa valori mancanti. Se il dato non esiste, o lo chiede o lo lascia vuoto — a seconda di come hai formulato la richiesta. Questo è il comportamento corretto, ma significa che il setup dei Custom Values deve esistere prima di usare il builder, non dopo.
Usarlo con template e snapshot
I segnaposto nelle istruzioni sono compatibili con i template e con i managed agents di GoHighLevel distribuiti tramite snapshot. Quando copi la struttura dell’agente su un nuovo sub-account, le istruzioni portano con sé le pillole, non i valori. Ogni sub-account deve avere i propri.
Questo è uno degli scopi dichiarati della funzione: stesse istruzioni, identità diverse per ogni cliente. L’agente non sa che sta girando su un sub-account diverso — legge i valori che trova e risponde di conseguenza.
Cosa puoi promettere sugli snapshot
Gli snapshot copiano la struttura dell’agente, comprese le istruzioni con i segnaposto. Non copiano i valori: quelli restano nel sub-account sorgente. Ogni sub-account di destinazione deve impostare i propri prima di pubblicare. Non c’è altro da promettere su questo punto — il resto dipende da come GHL evolve gli snapshot nel tempo.
Confronto: dato scritto a mano vs segnaposto
| Aspetto | Dato scritto a mano | Segnaposto Custom Value / Business Profile |
|---|---|---|
| Aggiornamento | Richiede modifica e ripubblicazione dell’agente | Modifica il valore in Settings, vale dalla corsa successiva |
| Riuso su più sub-account | Copia e riscrittura manuale | Stesse istruzioni, valori diversi per sub-account |
| Rischio di errore | Link e nomi sbagliati tra clienti | Errore bloccato al Publish se il valore manca |
| Costo per token | Uguale | Uguale (Custom Values e Business Profile standard non costano più del testo equivalente) |
| Segnaposto data e ora | Non applicabile | Cambiano a ogni esecuzione: possono far salire i costi |
Strumento consigliato
Make è il layer che dà le braccia al tuo managed agent
Un agente decide, Make esegue. Nei primi giorni connetti il tuo agente a Make e costruisci tre automazioni concrete: notifica quando l’agente prenota un appuntamento, scrivi su un foglio i dati raccolti dalla conversazione, aggiorna un Custom Value automaticamente quando cambia un dato del cliente.
- Giorno 1 — collega il webhook del managed agent a uno scenario Make
- Giorno 2 — scrivi i dati della conversazione su un Google Sheet
- Giorno 3 — crea un’automazione che aggiorna i Custom Values dal CRM al cambio di stato
Apri il piano gratuito di Make →
Link di affiliazione: se ti iscrivi da qui io prendo una commissione, tu paghi uguale. Lo linko perché ci lavoro dentro ogni giorno.
Costi e segnaposto di data e ora
I Custom Values standard e i dettagli del Business Profile non costano più dello stesso testo scritto a mano nelle istruzioni: il conteggio dei token è identico perché il valore viene sostituito prima che le istruzioni vengano passate al modello.
I segnaposto di data e ora si comportano diversamente: cambiano a ogni esecuzione perché dipendono dal momento in cui l’agente gira. Questo li rende utili per istruzioni contestuali — ma ogni esecuzione produce istruzioni diverse, e istruzioni diverse non vengono messe in cache dai layer di riduzione costi. Se usi molti segnaposto temporali su volumi alti, monitora i costi: il delta può non essere trascurabile. Questi segnaposto non stanno nel selettore Insert value: se li conosci già, li scrivi a mano nel formato corretto.
Dove si rompe in silenzio
Il blocco al Publish protegge solo al momento della pubblicazione. Se dopo il Publish vai in Settings e svuoti un Custom Value che l’agente usa, l’agente gira lo stesso — con la pillola che si risolve in stringa vuota. Nessun errore, nessun avviso. Risponde come se il dato non esistesse.
Per capire cosa ha letto l’agente durante l’esecuzione devi andare negli Agent Logs e guardare le istruzioni risolte, non quelle con le pillole. Se un valore è sparito, lo vedi lì — non nell’editor.
Costruire un managed agent su più clienti con i segnaposto è il modo giusto. Ma i segnaposto vuoti dopo la pubblicazione non fanno rumore: il silenzio del sistema non è salute, è il sintomo che qualcosa manca. Tieni i Custom Values monitorati come tieni i webhook.
Per chi vuole capire la struttura più in profondità, l’articolo su quando usare Custom Value e quando Custom Field su GoHighLevel chiarisce quale tipo di dato va dove, prima ancora di configurare l’agente.
Domande frequenti
Devo ripubblicare il managed agent dopo aver cambiato un Custom Value?
No. I Custom Values standard e i dettagli del Business Profile vengono letti a ogni esecuzione. Aggiorni il valore in Settings e vale dalla corsa successiva, senza toccare Agent Studio né cliccare Publish di nuovo.
Cosa succede se un Custom Value è vuoto quando l’agente gira?
La pillola si risolve in stringa vuota. L’agente non va in errore: risponde come se il dato non ci fosse, spesso in modo incoerente. Il blocco al Publish protegge solo al momento della pubblicazione, non dopo. Controlla i valori negli Agent Logs.
I segnaposto di data e ora costano di più?
Sì, indirettamente. Cambiano a ogni esecuzione, impediscono la cache delle istruzioni e possono far salire i costi su volumi alti. I Custom Values standard e il Business Profile no: costano quanto il testo equivalente scritto a mano.
Posso usare i Custom Values nelle istruzioni di un agente distribuito con snapshot?
Sì. Lo snapshot porta le istruzioni con i segnaposto, non i valori. Il sub-account di destinazione deve impostare i propri Custom Values prima di pubblicare: se mancano, GoHighLevel lo segnala con la finestra Set custom values to publish.
Trasparenza: in questo articolo c’è un link di affiliazione. Se ti iscrivi da lì io ricevo una commissione, per te non cambia niente. Linko solo strumenti che uso in produzione.
