Invoke managed agent workflow: risposta diretta
Per usare l’azione Invoke Managed Agent in un workflow GoHighLevel, l’agente deve avere il trigger Invoked from a workflow attivo e deve essere pubblicato. Se una delle due condizioni manca, l’agente non compare nell’elenco di selezione. Non è un bug: è un requisito di design. Una volta selezionato, il workflow passa all’agente un’istruzione, l’agente ragiona e restituisce una risposta usabile nei passi successivi come valore dinamico.
Il punto di partenza è capire dove finisce il workflow e dove inizia l’agente. Nel workflow tieni la sequenza, le condizioni fisse, i ritardi, i tag: tutto ciò che ha una logica binaria e prevedibile. Nell’agente metti solo ciò che richiede ragionamento, generazione di testo o decisioni che dipendono dal contesto. Mescolare i due livelli è il modo più veloce per costruire qualcosa che funziona a metà e non sai perché. Il workflow è la macchina; l’agente è il pezzo che pensa. Tenerli separati ti permette di testare ciascuno in modo indipendente e di capire dove si rompe quando si rompe.
Questo articolo copre il setup completo: trigger dell’agente, configurazione dell’azione Invoke Managed Agent, struttura dell’istruzione e differenza con le altre due azioni AI vicine che fanno cose diverse.
Perché l’agente non compare in Invoke Managed Agent
È il problema che blocca quasi tutti la prima volta. Vai nell’azione, apri il menu a tendina e non vedi l’agente che hai appena creato. Le cause sono due, e vanno verificate in questo ordine.
Trigger mancante
Ogni Managed Agent ha i propri trigger: quelli che dicono all’agente da dove può essere attivato. Per essere richiamabile da un workflow, l’agente deve avere il trigger Invoked from a workflow tra quelli configurati. Non è il trigger predefinito: va aggiunto esplicitamente nella configurazione dell’agente, dentro AI Agents → Agent Studio → Managed Agents. Un agente può avere più trigger contemporaneamente, quindi aggiungerlo non rompe niente di esistente.
Agente non pubblicato
Un agente in bozza non è visibile dal workflow. Devi pubblicarlo. Attenzione: prima di pubblicare, controlla gli strumenti e i permessi CRM configurati nell’agente. Un agente pubblicato può fare tutto ciò per cui ha strumenti abilitati: se hai connesso azioni CRM che non vuoi che esegua in quel contesto, disabilitale o restringile prima. Pubblicare senza controllare i permessi è il modo classico per avere un agente che esegue azioni che non ti aspettavi.
La regola
L’agente non compare? Controlla queste due cose prima
Se l’agente non appare nell’azione Invoke Managed Agent, sono quasi sempre le stesse due cause. Verificale in questo ordine prima di cercare altrove.
- Trigger mancante — l’agente non ha Invoked from a workflow tra i trigger attivi
- Agente non pubblicato — una bozza non è visibile dal workflow
- Permessi non verificati — controlla strumenti e azioni CRM prima di pubblicare
Come configurare l’azione Invoke Managed Agent nel workflow
Una volta che l’agente ha il trigger corretto ed è pubblicato, l’azione è disponibile nel workflow. La trovi nella sezione delle azioni AI. Selezionato l’agente, il campo che conta è l’istruzione.
Come scrivere un’istruzione che funziona
Un’istruzione vaga produce un output vago. L’agente non sa cosa stai cercando di fare a meno che tu non glielo dica con precisione. Un’istruzione efficace ha tre componenti.
Il compito: cosa deve fare l’agente in questo passaggio specifico. Non in generale, non «aiuta il contatto»: un’azione concreta, circoscritta. Il contesto: quali dati del contatto, della pipeline o della conversazione sono rilevanti per questo compito. Qui usi i valori dinamici del workflow — nome, email, stadio della pipeline, ultima risposta. Il risultato atteso: in che formato vuoi la risposta e cosa farai con essa nel passo successivo. Se il passo dopo è un’email, dillo. Se vuoi un testo di tre righe, dillo.
Il ruolo permanente dell’agente — chi è, come comunica, con quale tono — resta nella configurazione dell’agente, non nell’istruzione del workflow. L’istruzione del workflow è solo il compito di questo specifico momento nella sequenza. Mettere tutto nell’istruzione del workflow rende ogni azione difficile da manutenere e crea ridondanza ogni volta che riusi lo stesso agente in workflow diversi.
Usare la risposta nei passi successivi
L’output dell’agente è disponibile come valore dinamico nei passi che seguono l’azione Invoke Managed Agent. Puoi usarlo in un’email, in un SMS, in un campo personalizzato del contatto, in una condizione If/Else. Il workflow continua normalmente dopo che l’agente ha risposto: non si ferma, non aspetta input umano. L’agente esegue, restituisce la risposta, il workflow procede.
Tre azioni AI vicine che fanno cose diverse
Dentro i workflow GoHighLevel ci sono tre azioni che hanno nomi simili e fanno cose diverse. Confonderle è frequente e produce setup sbagliati.
| Azione | Tipo di agente | Configurazione | Consigliata per |
|---|---|---|---|
| Invoke Managed Agent | Managed Agent separato | In AI Agents, con trigger e strumenti propri | Agenti autonomi nuovi |
| AI Agent (nel workflow) | Agente inline | Istruzioni, modello, strumenti e memoria configurati dentro il workflow | Logica AI locale e circoscritta |
| Invoke Agent Studio Agent | Agente Agent Studio a flusso | Costruito in Agent Studio con logica a grafo | Flussi agent strutturati già esistenti |
Per i nuovi agenti autonomi, la documentazione GoHighLevel raccomanda i Managed Agents e quindi l’azione Invoke Managed Agent. L’azione AI Agent configurata dentro il workflow è un’esperienza separata: le istruzioni, il modello, gli strumenti e la memoria vivono nel workflow stesso, non in un agente esterno riusabile. Invoke Agent Studio Agent è invece per gli agenti costruiti con la logica a flusso di Agent Studio, che è un’esperienza ancora diversa. Se vuoi approfondire le differenze tra Managed Agents, Conversation AI e le altre opzioni disponibili, questo articolo le mette a confronto.
Costruisci la macchina
Make come layer che dà le braccia all’agente
Un Managed Agent decide. Make esegue. Collegare i due livelli è il modo per trasformare un agente che ragiona in un agente che agisce su sistemi esterni, fogli, CRM e code. Il piano gratuito parte da 1.000 operazioni al mese: abbastanza per costruire e testare l’infrastruttura prima di andare in produzione.
- Fase 1 — collega Make al webhook del tuo workflow GHL e verifica che i dati arrivino correttamente
- Fase 2 — costruisci lo scenario che esegue l’azione esterna decisa dall’agente
- Fase 3 — testa con dati reali e aggiungi le guardie sugli errori prima di attivare
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.
Cosa tenere nel workflow e cosa delegare all’agente
La regola pratica è semplice: se la logica è binaria, resta nel workflow. Se richiede ragionamento sul contesto, va nell’agente.
Nel workflow tieni: l’ordine delle azioni, le condizioni If/Else su campi del CRM, i ritardi temporali, i tag, l’invio di email o SMS con testo fisso. Sono tutte operazioni deterministiche: dato A produce B, sempre. L’agente non aggiunge niente su questi passaggi e aggiunge latenza.
All’agente deleghi: la generazione di testo personalizzato basato su più variabili del contatto, la classificazione di una risposta aperta, la decisione su come seguire un lead in base alla conversazione precedente. Sono i momenti dove il ragionamento conta e il testo fisso non basta. Per capire come il workflow di GoHighLevel gestisce la struttura condizionale prima e dopo l’azione dell’agente, è utile avere chiara la differenza tra le azioni di routing e branching del workflow.
Un agente già in uso con altri trigger — Conversation AI, webhook inbound, trigger orario — si può richiamare dal workflow senza modificare il resto: basta aggiungere il trigger Invoked from a workflow. L’agente continua a funzionare come prima sugli altri canali.
Strumenti e permessi: cosa controllare prima di pubblicare
Un Managed Agent può avere strumenti configurati: azioni CRM, chiamate API esterne, ricerche nella Knowledge Base. Quando il workflow invoca l’agente, l’agente ha accesso a tutti gli strumenti abilitati, non solo a quelli che ti aspetti usi in quel contesto.
Questo crea due rischi. Il primo: l’agente esegue un’azione CRM che non era prevista per quel flusso — aggiorna uno stadio, invia un messaggio, modifica un campo. Il secondo: se hai più azioni API configurate con istruzioni d’uso poco chiare, l’agente può scegliere quella sbagliata o chiamarne una a vuoto.
Prima di pubblicare, verifica che ogni strumento abilitato abbia istruzioni d’uso precise e che i permessi siano limitati a ciò che serve davvero. Per chi vuole capire come funziona il debug quando qualcosa non va dopo la pubblicazione, Agent Logs di GoHighLevel è il posto dove guardare prima.
Un agente senza guardie esegue sbagliato con la stessa precisione con cui esegue giusto. Non rallenta, non dubita. Produce. Controllare permessi e istruzioni prima di pubblicare non è burocrazia: è l’unico momento in cui puoi farlo senza conseguenze.
Se stai costruendo il workflow che contiene l’azione e vuoi testarlo senza impatti su contatti reali, la guida al test dei workflow GoHighLevel copre come farlo in modo isolato. Per chi invece viene da n8n e sta valutando di portare un flusso esistente dentro un Managed Agent, la documentazione ufficiale GoHighLevel descrive come funziona l’importatore da n8n e cosa si adatta e cosa no.
Il setup di Invoke Managed Agent in un workflow GoHighLevel non è complicato. Il problema quasi sempre non è l’azione: è l’agente che non ha il trigger giusto o non è pubblicato. Sistema quei due punti, struttura l’istruzione con compito, contesto e risultato atteso, e la macchina funziona. Il resto — permessi, strumenti, output dinamico — si controlla prima di andare in produzione, non dopo.
Domande frequenti
Posso usare Invoke Managed Agent con un agente già attivo su Conversation AI?
Sì. Basta aggiungere il trigger Invoked from a workflow all’agente esistente. Gli altri trigger — compreso quello di Conversation AI — continuano a funzionare invariati. L’agente risponde su tutti i canali per cui è configurato.
Invoke Managed Agent e Invoke Agent Studio Agent sono la stessa cosa?
No. Invoke Managed Agent richiama un agente configurato in AI Agents → Managed Agents, con trigger, strumenti e istruzioni propri. Invoke Agent Studio Agent richiama un agente costruito con la logica a flusso di Agent Studio. Sono architetture separate: scegli in base al tipo di agente che hai costruito.
La risposta dell’agente è disponibile come variabile nei passi successivi del workflow?
Sì. L’output di Invoke Managed Agent è usabile come valore dinamico nelle azioni che seguono: email, SMS, aggiornamento di un campo personalizzato, condizione If/Else. Il workflow non si ferma dopo l’azione: continua con la risposta dell’agente disponibile come dato.
Cosa succede se l’istruzione è vaga o incompleta?
L’agente produce un output generico o non centrato sul compito. Un’istruzione efficace specifica sempre compito, contesto rilevante e formato del risultato atteso. Il ruolo e il tono dell’agente restano nella sua configurazione permanente, non nell’istruzione del singolo workflow.
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.
