HubSpot Knowledge Base

Configurazione dei prompt per gli agenti Breeze con HubSpot MCP Client

Scritto da HubSpot Support | Sep 3, 2025 1:21:49 PM

Dopo aver collegato gli agenti Breeze a un server MCP utilizzando HubSpot MCP Client, è necessario aggiungere istruzioni chiare per guidare l'agente Breeze su quali strumenti MCP utilizzare e quando. Le istruzioni devono essere personalizzate in base al caso d'uso, alla configurazione e agli obiettivi specifici.

Aggiunta di prompt MCP agli agenti Breeze

  1. Nell'account HubSpot, navigare in Breeze > Breeze Studio.
  2. Nella scheda Agenti , fare clic sul nome dell'agente a cui si desidera aggiungere i prompt MCP.
  3. In alto a destra, fare clic su Configura agente.
  4. Nella sezione Guida al comportamento dell'agente, fare clic su Aggiungi istruzioni extra.
  5. Nel campo di testo Istruzioni extra, inserire i prompt MCP.

Pratiche ottimali per l'aggiunta di prompt MCP agli agenti Breeze

Utilizzare gli esempi seguenti come guida per aggiungere i prompt MCP a un agente Breeze collegato a un Notion MCP Server. Sebbene queste best practice offrano un quadro generale, è possibile personalizzarle per il proprio caso d'uso specifico e per altri server MCP.

Identificare il database

Poiché le pagine e i database di Notion non seguono una struttura fissa, è necessario indicare all'agente quale database utilizzare. Si consiglia di indicare il nome del database, il suo scopo e di includere l'ID del database, se disponibile.

Esempio di richiesta:

Utilizzare il database Notion intitolato "Content Projects Tracker", che include il nome del progetto, lo stato, il proprietario e la data di scadenza.

Descrivere la struttura della proprietà o della colonna

Descrivere la struttura del database per aiutare l'agente Breeze a comprendere i dati. Si consiglia inoltre di elencare i nomi delle colonne rilevanti, il loro contenuto e il tipo di proprietà.

Esempio di richiesta:

Il database comprende le seguenti colonne: 'Nome progetto' (titolo), 'Proprietario' (persona), 'Stato' (selezionare) e 'Scadenza' (data).

Se alcuni campi sono opzionali o non vengono utilizzati in modo costante, è utile indicarlo.

Definire il compito dell'agente

Siate chiari sulle informazioni specifiche che l'agente deve trovare o estrarre.

Esempi di prompt:

  • Trova tutti gli elementi il cui stato è "In corso" e la cui scadenza è entro i prossimi 7 giorni.

  • Riassumere tutte le voci che hanno "Lancio del prodotto" nel titolo.

Specificare azioni e strumenti

Se l'agente deve eseguire un'azione specifica, come query_database, list_databases o retrieve_page, è utile indicare esplicitamente quali strumenti deve usare e come. Questo è particolarmente utile se l'agente deve scegliere tra più strumenti.

Fornire un esempio di input e output

Se l'agente deve aggiungere o modificare voci, si consiglia di includere un esempio di come dovrebbero apparire i dati.

Esempio di richiesta:

Quando si crea una nuova voce, inserire "Stato" come "Non iniziato" per impostazione predefinita e lasciare "Scadenza" in bianco.

Esempio di richiesta MCP completa per gli agenti Breeze

Si è connessi al server MCP Notion. Utilizzare il database intitolato "Feature Rollouts Tracker". Include le seguenti colonne: 'Feature Name' (titolo), 'Status' (selezionare: Not Started, In Progress, Done), 'PM Owner' (persona) e 'Target Release Date' (data). Il vostro compito è trovare tutte le funzioni contrassegnate come "In corso" e restituire i loro nomi insieme al PM Owner. Utilizzare lo strumentoquery_database e prelevare i risultati solo da questo database.