- Knowledge base
- IA
- IA
- Gestire il contesto di Breeze con i knowledge vault
Gestire il contesto di Breeze con i knowledge vault
Ultimo aggiornamento: 21 aprile 2026
Disponibile con uno qualsiasi dei seguenti abbonamenti, tranne dove indicato:
-
Marketing Hub Starter, Professional, Enterprise
-
Sales Hub Starter, Professional, Enterprise
-
Service Hub Starter, Professional, Enterprise
-
Data Hub Starter, Professional, Enterprise
-
Content Hub Starter, Professional, Enterprise
-
CRM HubSpot intelligente Professional, Enterprise
In Breeze Studio è possibile creare e gestire archivi di conoscenze che forniscono ad assistenti e agenti ulteriori informazioni sul contesto della propria attività. Ad esempio, è possibile caricare file PDF con le descrizioni dei propri prodotti o inserire collegamenti a tutti i contatti creati da una campagna specifica.
Comprendere i limiti e gli aspetti da considerare
- È possibile avere fino a 50 archivi di conoscenza separati contemporaneamente.
- Gli assistenti e gli agentiutilizzeranno la versione più recente di qualsiasi record aggiunto ai knowledge vault.
- I knowledge vault non possono essere salvati senza almeno un file o un oggetto CRM allegato.
Creare archivi di conoscenza
Verrà creato un archivio di conoscenza predefinito utilizzando le fonti di dati impostate nelle impostazioni AI per il contesto relativo alla tua attività. Per creare archivi di conoscenza personalizzati per un contesto aggiuntivo:
- Nel tuo account HubSpot, passa a Breeze > Conoscenza.
- In alto a destra, clicca suCrea archivio.
- Nel pannello di destra, inserisci unnome perl'archivio nelcampo Nome.
- Nelcampo Descrizione, inserisci unadescrizione delcontesto che aggiungerai a questo archivio.
- Nellasezione File, fare clic suAggiungi e selezionare i file pertinenti dal dispositivo. Scopri come vengono utilizzate le immagini incorporate nei documenti.
- Carica file nei seguenti formati: .pdf, .md, .html, .pptx, .txt (solo codifica UTF-8) e .docx (fino a 50 MB per file).
- Carica file immagine nei seguenti formati: .jpeg, .png o .webp (fino a 10 MB per file).
- Nella sezione Contenuti di HubSpot, clicca sul menu a tendina Aggiungi e seleziona un tipo di contenuto(ad es. Knowledge base).
- Per scegliere contenuti specifici, seleziona la casella di controllo accanto a ciascuna risorsa. Per le knowledge base, clicca sulla knowledge base per selezionare gli articoli da includere o escludere.
- Per selezionare tutti i contenuti, attiva l'interruttore Seleziona tutto.
- Fai clic su Aggiungi [risorse] in basso a destra.

- Nella sezione Segmenti (Elenchi), clicca su Aggiungi.
- Nel campo di ricerca, inserisci il nome di un segmento.
- Per filtrare i segmenti disponibili, clicca sui menu a tendina Stato (ad es. Attivo o Statico) o Oggetto e seleziona un'opzione. Gli oggetti disponibili includonooggetti di base eoggetti personalizzati.
-
- Per scegliere un segmento, seleziona la casella di controllo accanto al segmento.
- Fai clic su Aggiungi segmenti in basso a destra.

- Per aggiungere ulteriori file, contenuti o segmenti, clicca su Aggiungi, quindi ripeti le sezioni pertinenti.
- Al termine, clicca su Crea.
Come vengono utilizzate le immagini incorporate nei contenuti
Quando aggiungi contenuti a un archivio di conoscenze, le immagini incorporate vengono elaborate insieme al testo. Ciò consente agli agenti e agli assistenti di recuperare e analizzare informazioni visive, come diagrammi, grafici e screenshot, senza che tu debba caricare i file immagine separatamente.
Ciò si applica alle immagini incorporate in:
- Articoli della knowledge base
- Post di blog
- Pagine di destinazione
- Pagine web
- Documenti caricati (ad es. PDF, Word (.docx) e PowerPoint (.pptx))
Quando i contenuti vengono pubblicati o aggiornati, l'archivio della conoscenza estrae automaticamente le immagini idonee, genera descrizioni e le indicizza insieme al testo. Al momento della query, gli agenti e gli assistenti possono utilizzare queste immagini e descrizioni per comprendere il contesto e rispondere in modo più accurato.
Poni domande sui contenuti visivi presenti nelle tue fonti, come diagrammi o dati riportati in un grafico.
- Limiti relativi alle immagini per pagine, post e articoli: fino a 10 immagini per risorsa, con una dimensione massima di 500 KB per immagine.
- Supporto documenti: PDF, Word (.docx) e PowerPoint (.pptx), fino a 50 MB per file.
- Ambito dei contenuti: vengono elaborate solo le immagini nel corpo del contenuto (non intestazioni, piè di pagina o elementi decorativi).
- Limiti HTML: le immagini devono essere incorporate in linea (ad es. base64). Gli URL di immagini esterne non sono supportati.
Modifica dei knowledge vault
- Nel tuo account HubSpot, passa a Breeze > Conoscenza.
- Fai clic sulla scheda di un archivio di conoscenze.
- Nel pannello di destra, clicca sull'icona del menu con i puntini di sospensione e selezionaModificaper personalizzare il nome e la descrizione. Quindi clicca su Salva.
- Per aggiungere un nuovo file, cliccasu Aggiungi nellasezione File, quindi carica un file.
- Per aggiungere contenuti o segmenti, clicca su Aggiungi nelle sezioni Contenuti o Segmenti (Elenco)e seleziona un'opzione.
- Per gli articoli della knowledge base, le landing page, i post del blog e le chiamate, seleziona lacasella di controllo accantoa ciascuna risorsa che desideri aggiungere, quindi cliccasu Aggiungi [risorsa].
- Per i segmenti, clicca su Aggiungi, deseleziona o seleziona la casella di controllo accanto al segmento. Quindi clicca su Aggiungi segmenti.
- Per rimuovere un file, una risorsa o un segmento, cliccasull'icona di rimozione accantoal relativo nome.
- Al termine, clicca su Salva.
Eliminare i knowledge vault
Quando rimuovi un knowledge vault da un agente o da un assistente, quel knowledge vault rimane nel tuo account. Per eliminare definitivamente un knowledge vault:
- Nel tuo account HubSpot, passa a Breeze > Conoscenza.
- Fai clic sulla scheda di un archivio di conoscenze.
- Nel pannello di destra, cliccasull'icona del menu con i puntini di sospensione e selezionaElimina.
- Nella finestra di dialogo, clicca suElimina archivio.
Gestire i knowledge vault di un agente o di un assistente
Dopo aver creato i knowledge vault, aggiungili a qualsiasi agente o assistente in Breeze Studio.
- Nel tuo account HubSpot, passa a Breeze > Breeze Studio.
- Passa il mouse sull'agente o sull'assistente e cliccasull'icona del menu verticale, quindi selezionaConfigura.
- Nella sezione "Cosa sa questo agente " dell'editor, fare clic su "Aggiungi conoscenza".
- Nel pannello di destra, passa con il mouse su unarchivio di conoscenze e fai clicsu Aggiungi. Ripeti l'operazione per ogni archivio di conoscenze che desideri utilizzare.
- Per esaminare il contenuto di un archivio di conoscenze, passa con il mouse sull'archivio e clicca suVisualizza dettagli oVisualizza nelle impostazioni.

- Per rimuovere un archivio di conoscenze da questo agente o assistente, passa con il mouse sull'archivio di conoscenze e cliccasu Rimuovi.
- Al termine, fare clic su X per chiudere il pannello laterale destro. Quindi fare clic su Pubblica in alto a destra.
Comprendere i riferimenti dei knowledge
vault Quando un assistente o un agente fa riferimento a contenuti provenienti da documenti del knowledge vault nelle proprie risposte, il riferimento include dettagli specifici dal file di origine.
I riferimenti mostrano il nome del documento insieme al numero di pagina o alla sezione pertinente, se disponibili. Questo ti aiuta a individuare e verificare il contenuto a cui si fa riferimento all’interno del documento originale. I formati supportati includono .pdf o .docx.

Comprendere le proprietà predefinite incluse nei knowledge vault
I knowledge vault includono le proprietà predefinite di HubSpot. Scopri di più sulle proprietà predefinite di contatti, aziende, trattative e ticket. Per visualizzare le proprietà di ciascun oggetto, clicca per espandere la sezione applicabile:
Esempio: utilizzare un archivio di conoscenze basato su segmenti in un assistente personalizzato
Creare un assistente personalizzato che aiuti gli utenti a ricavare informazioni dai ticket di assistenza recenti. Ad esempio, riassumendo i problemi più frequenti segnalati nell'ultima settimana, individuando le tendenze regionali o identificando i picchi in determinati tipi di ticket.
Creare un segmento per i ticket recenti
- Nel tuo account HubSpot, passa a CRM > Segmenti.
- Crea un segmento attivo su "Ticket" filtrato in modo da includere solo i ticket creati negli ultimi 30 giorni (o "negli ultimi 7 giorni", a seconda di quanto recenti desideri che siano i dati).
Scopri di più sulla creazione dei segmenti.
Crea un archivio di conoscenze utilizzando il segmento
- Nel tuo account HubSpot, passa a Breeze > Conoscenza.
- In alto a destra, clicca su Crea archivio.
- Inserisci i dettagli dell'archivio di conoscenze:
- Nome: Ticketrecenti nella regione [X].
- Descrizione: Ticket di assistenza degli ultimi 30 giorni registrati nella regione [X].
- Nella sezione Segmenti, clicca su Aggiungi e seleziona il nuovo segmento. Puoi aggiungere più di un segmento a un archivio di conoscenze, ma gli altri segmenti devono essere di un tipo di oggetto diverso. Ad esempio, un segmento sui ticket e uno sui contatti.
Scopri di più sulla creazione dei knowledge vault.
Allega il knowledge vault a un assistente personalizzato
- Nel tuo account HubSpot, passa a Breeze > Breeze Studio.
- Fai clic sulla scheda Assistenti.
- Per creare un nuovo assistente, cliccasuCrea assistenteinalto a destra. Per modificare un assistente esistente, passa con il mouse sulla scheda dell'assistente, quindi cliccasull'icona del menue selezionaConfigura.
- In Imposta le informazioni a cui questo assistente può accedere , nellasottosezione Conoscenze , clicca suAggiungi conoscenza peraggiungere il vault delle conoscenze che hai creato con il segmento del ticket.
- Una volta terminata la modifica e il test dell'assistente, cliccasu Pubblica inalto a destra per rendere l'assistente disponibile agli utenti in Breeze Assistant.
Scopri di più sulla creazione o la personalizzazione degli assistenti.
