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.

Configurazione dei prompt per gli agenti Breeze con HubSpot MCP Client

Ultimo aggiornamento: 3 settembre 2025

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

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.

screenshot showing the Extra instructions text field to enter MCP prompts for your agent.

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.

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