Salta al contenuto
Nota bene: la traduzione in italiano di questo articolo è fornita solo per comodità. La traduzione viene creata automaticamente tramite un software di traduzione e potrebbe non essere stata revisionata. Pertanto, la versione inglese di questo articolo deve essere considerata come la versione di governo contenente le informazioni più recenti. È possibile accedervi qui.

Crea e personalizza gli agenti nell'Agent Builder

Ultimo aggiornamento: 23 luglio 2026

Disponibile con uno qualsiasi dei seguenti abbonamenti, tranne dove indicato:

Crea agenti personalizzati (BETA) in grado di analizzare i dati, generare risultati e intraprendere azioni in base ai tuoi processi aziendali. All’interno del builder moderno, puoi definire cosa deve fare un agente, a quali dati può accedere e come deve rispondere.

Gli agenti personalizzati aiutano a standardizzare l’esecuzione delle attività e a ridurre il lavoro manuale applicando una logica coerente ai tuoi dati. Ciò è utile per i processi che richiedono la revisione dei record, la generazione di output strutturati o il processo decisionale basato su più fonti di dati.

Per una panoramica sulla configurazione del tuo account per le funzionalità di IA, consulta la guida su come configurare il tuo account HubSpot per adottare le funzionalità di IA.

Nota: puoi gestire l'accesso delle funzionalità IA nelle tue impostazioni IA e configurare quali dati vengono condivisi. Consulta le domande frequenti sull'attendibilità dell'IA e le schede dei modelli di IA di HubSpot per informazioni dettagliate su controlli di sicurezza IA, utilizzo dei dati e conformità.

Prima di iniziare

Prima di iniziare a creare e personalizzare gli agenti nel generatore di agenti, consulta i requisiti e le considerazioni.

  • Un superamministratore deve attivare le seguenti opzioni nelle Impostazioni IA:

    • Consenti agli utenti di accedere agli strumenti e alle funzionalità di IA generativa

    • Dati CRM

    • Dati di conversione dei clienti

    • Dati relativi ai file

    • Concedi agli utenti l'accesso a Breeze Assistant

Autorizzazioni richieste Per creare e personalizzare gli agenti nel generatore di agenti è necessaria l’autorizzazione di Super Admin o Breeze Studio.

Autorizzazioni richieste A seconda dell'obiettivo dell'agente, agli utenti potrebbero essere richieste autorizzazioni aggiuntive. Ad esempio, un agente che genera una pagina di destinazione richiede le autorizzazioni "Modifica" e "Pubblica " per modificare e pubblicare le pagine di destinazione.

Crea un agente nel generatore di agenti

Crea un agente personalizzato definendone le istruzioni, selezionando le azioni e configurando i dati e gli input che utilizzerà.

  1. Nel tuo account HubSpot, clicca su Altro, quindi vai su Agenti > Hub degli agenti. Se l’opzione Altro non è presente nel tuo account, vai direttamente su Agenti > Hub degli agenti.

  2. Nella scheda Introduzione, clicca sul menu a discesa "Crea " in alto a destra e seleziona "Agenti".

  3. Nel generatore di agenti, configura le istruzioni, le azioni, le conoscenze e gli input del tuo agente.

Istruzioni

Definisci cosa deve fare l’agente e come deve comportarsi. Includi il ruolo, l’obiettivo, l’approccio e il risultato atteso dell’agente.

Nel generatore di agenti, inserisci il testo nel campo Istruzioni. Definisci chiaramente il ruolo, l’obiettivo, l’approccio e il risultato atteso dell’agente.

Ad esempio, potresti aggiungere le seguenti istruzioni:

Role:
You’re a customer onboarding review agent responsible for preparing internal handoffs after a deal is closed.
Goal:
Analyze customer information and summarize key details needed for a successful onboarding process.
Approach: 
Review contact and company properties, deal details, and recent activity.
Identify important context such as customer goals, purchased products, timeline expectations, and risks.
Flag any missing or unclear information that may impact onboarding.
Output:
Section 1: Customer summary (3-5 bullet points).
Section 2: Key onboarding considerations.
Section 3: Missing information or risks.
Keep responses concise, structured, and actionable.

Azioni

Selezionare le azioni che l'agente può eseguire. Le azioni determinano quali attività l'agente può portare a termine in base alle istruzioni.

  1. Nel generatore di agenti, clicca su Aggiungi azione nel pannello di sinistra.

  2. Nel pannello di destra, clicca sulle schede HubSpot, Predefinito o MCP e seleziona le tue azioni.

    • HubSpot: scegli tra diversi tipi di azioni (ad es., Ottieni dati, Genera, Esegui un'azione). Per filtrare i tipi di azioni, clicca sul menu a tendina Tipi e seleziona un tipo (ad es., Genera).

    • Impostazione predefinita: scegli tra le azioni predefinite, come " Navigazione sul web " o " Lettura dei record del CRM di HubSpot".

      • Naviga sul web: questa opzione consente all'agente di navigare sul web.

      • Leggi i tuoi record del CRM di HubSpot: questa opzione consente all’agente di leggere i tuoi record del CRM.

      • Scrivere nei record del CRM di HubSpot: questa opzione consente all’agente di scrivere nei record del CRM.

    • MCP: collega il tuo agente a sistemi esterni utilizzando il Model Context Protocol (MCP). Scopri di più sui server MCP supportati.

Conoscenze

Aggiungi il contesto specifico del caso d'uso a cui l'agente può fare riferimento durante la generazione dei risultati, come documenti caricati, linee guida del marchio, archivi di conoscenze o dati CRM pertinenti.

Utilizza la sezione Conoscenze per fornire informazioni di supporto a cui l'agente può attingere durante l'analisi dei dati o la generazione delle risposte. A differenza degli input, questo contesto è a disposizione dell'agente senza dover essere ridefinito ogni volta che viene eseguito.

Ad esempio, un agente incentrato sull’onboarding può fare affidamento sui dettagli delle trattative, sulle informazioni relative all’azienda e sulle attività recenti, mentre un agente incentrato sui contenuti può utilizzare documenti o file caricati.

  1. Nel generatore di agenti, clicca su "Aggiungi conoscenza " nella sezione " Conoscenza ".

  2. Nel pannello di destra, clicca su "Personalizzato", "Predefinito" o " Integrazioni " e seleziona le tue conoscenze.

Input

Definisci i dati specifici che l’agente utilizza ogni volta che viene eseguito, come un record, un valore fornito dall’utente o informazioni trasmesse da un altro strumento o processo.

Utilizza gli input per specificare su cosa l’agente deve agire per una determinata esecuzione. A differenza delle conoscenze, gli input vengono forniti in fase di esecuzione e possono variare a seconda del contesto.

Ad esempio, un agente incentrato sull’onboarding può utilizzare input quali il nome dell’affare, la data di chiusura o gli obiettivi del cliente, mentre un agente incentrato sui contenuti può richiedere un argomento, un pubblico o un messaggio chiave.

  1. Nel generatore di agenti, clicca su "Aggiungi input " nella sezione " Input ".

  2. Fai clic sul menu a discesa Tipo di input e seleziona un'opzione (ad es. Oggetto CRM).

  3. Nel campo Etichetta, inserisci un nome per l’input. 

Gestire l’accesso agli agenti

Controlla quali utenti hanno accesso a ciascun agente. Per impostazione predefinita, i superamministratori possono modificare gli agenti e tutti gli utenti possono eseguirli.

Se la configurazione di un agente si basa su altre funzionalità di HubSpot (ad esempio, blog o landing page) a cui un utente non ha accesso, l’agente non può essere eseguito da quell’utente, anche se quest’ultimo dispone dell’autorizzazione per modificare o eseguire l’agente.

  1. Nel generatore di agenti, clicca sull’icona con i tre puntini verticali e seleziona " Assegna accesso " in alto a sinistra.

  2. Nel pannello di destra, seleziona un'opzione di accesso:

    • I proprietari e i super amministratori possono modificare ed eseguire: solo l’utente che ha creato o installato l’agente e i super amministratori possono modificare ed eseguire l’agente.

    • I proprietari e i superamministratori possono modificare, tutti possono eseguire: solo l’utente che ha creato o installato l’agente e i superamministratori possono modificare l’agente. Tutti gli utenti possono eseguire l’agente.

    • Tutti possono modificare ed eseguire: qualsiasi utente può modificare ed eseguire l’agente.

    • Accesso personalizzato per team e utenti: solo gli utenti e i team selezionati possono modificare o eseguire l’agente. Se selezioni questa opzione, saranno disponibili ulteriori opzioni di accesso:

      • Esegui e modifica: gli utenti o i team selezionati possono eseguire e modificare l’agente.

      • Eseguire: gli utenti o i team selezionati possono eseguire l’agente.

  3. Al termine, fare clic su " Aggiorna".

Prova un agente nel generatore di agenti

Testa il tuo agente per verificare che l’output soddisfi le tue aspettative. Il test aiuta a confermare che l’agente utilizzi gli input corretti, faccia riferimento ai dati corretti e restituisca i risultati previsti. 

Nota: testare un agente non consuma crediti. Scopri di più su come verificare i costi stimati degli agenti nel generatore di agenti.

  1. Nel pannello di destra, inserisci gli input richiesti.

  2. Fare clic su " Testa agente".

  3. Nella finestra di dialogo, clicca su Esegui.

  4. Nella scheda " Outputs ", verificare che l'output contenga quanto segue:

    • Verifica che l’agente rispetti il formato previsto.

    • L'agente utilizza i dati e il contesto previsti.

    • Individua eventuali lacune, imprecisioni o risposte poco chiare.

  5. Aggiornare la configurazione dell'agente secondo necessità:

    • Perfeziona le istruzioni per migliorarne la chiarezza o la specificità.

    • Modifica le fonti di conoscenza se i dati rilevanti mancano o sono errati.

    • Aggiornare gli input per garantire che siano incluse le informazioni richieste.

  6. Ripetere i test fino a quando l'output non risulta coerente e soddisfa i requisiti. Quindi continuare a verificare i costi di credito stimati e impostare i limiti di esecuzione.

Verifica i costi stimati in crediti e imposta i limiti di esecuzione

Dopo aver testato l’agente, verifica i crediti HubSpot stimati necessari per l’attività. Puoi anche impostare limiti di esecuzione per controllare quanti crediti un agente può utilizzare durante l’esecuzione, aiutandoti a gestire l’utilizzo dei crediti nel tuo account.

  1. Nel generatore di agenti, fare clic su Cronologia esecuzioni nella parte superiore della pagina.

  2. Nel pannello di sinistra, fare clic su un'esecuzione dell'agente.

  3. Nel pannello di destra, controlla i crediti stimati.

Queste stime sono fornite solo a scopo informativo. I costi effettivi potrebbero variare. Scopri di più sucome verificare i costi stimati in crediti per gli agenti e impostare i limiti di esecuzione mensili.

Pubblica un agente personalizzato

Dopo aver testato l’agente e aver verificato che l’output soddisfi le tue aspettative, salva e pubblica l’agente per renderlo disponibile all’uso. 

  1. Nel generatore di agenti, fare clic su "Salva e pubblica le modifiche".

  2. Per eseguire l’agente, fare clic su Esegui in alto a destra. Scopri di più sull’esecuzione e la revisione dell’output dell’agente nella casella di posta in arrivo dell’agente.

Dopo la pubblicazione, utilizza l’agente nell’ambito dei tuoi processi più ampi e includilo in altre automazioni. Scopri di più su come aggiungere agenti ai flussi di lavoro.

Prossimi passi

L'articolo è stato utile?
Questo modulo viene utilizzato solo per il feedback della documentazione. Scopri come ottenere assistenza con HubSpot.