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: 6 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.
    • Fare 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 altri file, contenuti o segmenti, clicca su Aggiungi, quindi ripeti le sezioni pertinenti. 
  2. Al termine, fare clic su Crea.

Come vengono utilizzate le immagini incorporate nei documenti

Quando carichi documenti supportati in un archivio di conoscenze, tutte le immagini incorporate in tali documenti diventano automaticamente ricercabili insieme al contenuto testuale. 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.

Poni domande a un agente o a un assistente sui contenuti visivi presenti nei tuoi documenti, come diagrammi o dati mostrati in un grafico.

  • Formati di documento supportati: PDF, Word (.docx) e PowerPoint (.pptx).

  • Limite di dimensione del file: fino a 50 MB per documento.

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 del knowledge

vault Quando un assistente o un agente fa riferimento a contenuti provenienti dai 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 l'archivio 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.

Casi d'uso

Ecco alcuni esempi di prompt che gli utenti potrebbero utilizzare con il nuovo assistente, inclusi esempi di output:

Prompt Esempio di output
Quali sono stati i 5 problemi di assistenza più comuni segnalati nell'ultima settimana? Un elenco ordinato per tipo di problema (ad es. Errore di accesso - 23 ticket, Discrepanza di fatturazione - 12 ticket, ecc.
Ci sono regioni in cui i ticket hanno registrato un picco questa settimana rispetto alla scorsa? Una tabella o un elenco puntato che mostri le regioni con variazioni nel volume dei ticket (ad es. Germania 45% rispetto alla settimana precedente, Stati Uniti invariati, ecc.).
Quali clienti hanno avuto più di tre ticket chiusi questo mese? Un elenco di nomi e ID dei clienti, con il numero di ticket e magari un breve riassunto del ticket. 
L'articolo è stato utile?
Questo modulo viene utilizzato solo per il feedback della documentazione. Scopri come ottenere assistenza con HubSpot.