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.

Gestire il contesto di Breeze con i knowledge vault

Ultimo aggiornamento: 21 aprile 2026

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

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:

  1. Nel tuo account HubSpot, passa a Breeze > Conoscenza.
  2. In alto a destra, clicca suCrea archivio.
  3. Nel pannello di destra, inserisci unnome perl'archivio nelcampo Nome.
  4. Nelcampo Descrizione, inserisci unadescrizione delcontesto che aggiungerai a questo archivio.
  5. 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).
  6. 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.

In the right panel, when creating a knowledge vault, the add content information is displayed. An arrow points to the Select all switch. A box is placed around a checkbox for a specific asset.

  1. 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.

In the right panel, when creating a knowledge vault, the add segment details are displayed. Boxes are placed around the Type and Object dropdown menu to filter segments. A box is placed around a checkbox for a specific segment.

  1. Per aggiungere ulteriori file, contenuti o segmenti, clicca su Aggiungi, quindi ripeti le sezioni pertinenti. 
  2. 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 

  1. Nel tuo account HubSpot, passa a Breeze > Conoscenza
  2. Fai clic sulla scheda di un archivio di conoscenze. 
  3. 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.
  4. Per aggiungere un nuovo file, cliccasu Aggiungi nellasezione File, quindi carica un file. 
  5. 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.
  6. Per rimuovere un file, una risorsa o un segmento, cliccasull'icona di rimozione accantoal relativo nome. 
  7. 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: 

  1. Nel tuo account HubSpot, passa a Breeze > Conoscenza
  2. Fai clic sulla scheda di un archivio di conoscenze.
  3. Nel pannello di destra, cliccasull'icona del menu con i puntini di sospensione e selezionaElimina.
  4. 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. 

  1. Nel tuo account HubSpot, passa a Breeze > Breeze Studio.
  2. Passa il mouse sull'agente o sull'assistente e cliccasull'icona del menu verticale, quindi selezionaConfigura
  3. Nella sezione "Cosa sa questo agente " dell'editor, fare clic su "Aggiungi conoscenza". 
  4. 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. 
  5. Per esaminare il contenuto di un archivio di conoscenze, passa con il mouse sull'archivio e clicca suVisualizza dettagli oVisualizza nelle impostazioni

ai-tools-breeze-studio-add-knowledge-vault

  1. Per rimuovere un archivio di conoscenze da questo agente o assistente, passa con il mouse sull'archivio di conoscenze e cliccasu Rimuovi
  2. 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.

In an agent or assistant, sources are displayed at the bottom of a response. Clicking the source will display the document name from the knowledge vault along with the relevant page number or section.

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

  1. Nel tuo account HubSpot, passa a CRM > Segmenti.
  2. 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

  1. Nel tuo account HubSpot, passa a Breeze > Conoscenza.
  2. In alto a destra, clicca su Crea archivio
  3. Inserisci i dettagli dell'archivio di conoscenze:
    • Nome: Ticketrecenti nella regione [X].
    • Descrizione: Ticket di assistenza degli ultimi 30 giorni registrati nella regione [X].
  4. 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

  1. Nel tuo account HubSpot, passa a Breeze > Breeze Studio.
  2. Fai clic sulla scheda Assistenti.
  3. 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
  4. 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.
  5. 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.

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