Central de conhecimento HubSpot

Configurar prompts para Breeze agents com o Cliente MCP HubSpot

Written by HubSpot Support | 3/set/2025 13:23:16

Depois de conectar seu Breeze agents a um servidor MCP usando o HubSpot MCP Client, você deve adicionar instruções claras de prompt para orientar seu agente Breeze sobre quais ferramentas MCP usar e quando. Os prompts devem ser personalizados com base no caso de uso específico, na configuração e no meta. 

Adicionar prompts de MCP ao Breeze agents

  1. Na sua conta HubSpot, navegue até o Breeze > Breeze Studio
  2. Na guia Agentes, clique no nome do agente ao qual você deseja adicionar prompts de MCP. 
  3. Na parte superior direita, clique em Configure agent (Configurar agente).
  4. Na seção Guia de comportamento deste agente , clique em Adicionar instruções extras.
  5. No campo de texto Instruções extras , digite os prompts do MCP

Práticas recomendadas para adicionar prompts MCP ao Breeze agents

Use os exemplos a seguir como um guia para adicionar prompts de MCP a um agente do Breeze conectado a um Notion MCP Server. Embora essas práticas recomendadas ofereçam uma estrutura geral, você pode personalizá-las para seu caso de uso específico e para outros servidores MCP.

Identificar o banco de dados

Como as páginas de Noção e os bancos de dados não seguem uma estrutura fixa, você precisa instruir o agente exatamente em qual banco de dados usar. É recomendável que você mencione o nome do banco de dados, sua finalidade e inclua a ID do banco de dados, se houver.

Exemplo de prompt:

Use o banco de dados Notion intitulado 'Content Projects Tracker,' que inclui o nome do projeto, o status, o proprietário e a data de vencimento.

Descrever a estrutura da propriedade ou da coluna

Descreva sua estrutura de banco de dados para ajudar o agente da Breeze a entender os dados. Também é recomendável listar os nomes das colunas relevantes, o que elas contêm e o tipo de propriedade.

Exemplo de prompt: 

O banco de dados inclui estas colunas: 'Nome do projeto' (título), 'Proprietário' (pessoa), 'Status' (selecionar) e 'Prazo final' (data).

Se alguns campos forem opcionais ou não forem usados de forma consistente, é útil mencionar isso também.

Definir a tarefa do agente

Seja claro sobre as informações específicas que o agente deve encontrar ou extrair.

Prompts de exemplo:

  • Localize todos os itens cujo Status seja 'Em Andamento' e cujo Prazo Final esteja dentro dos próximos 7 dias.

  • Resuma todas as entradas que têm 'Lançamento de Produto' no título.

Especificar ações e ferramentas

Se seu agente precisar executar uma ação específica, como query_database, list_databases ou recover_page, é útil declarar explicitamente quais ferramentas ele deve usar e como. Isso é especialmente útil se o agente tiver que escolher entre várias ferramentas.

Fornecer um exemplo de entrada e saída

Se seu agente precisar adicionar ou editar entradas, é recomendável incluir um exemplo de como os dados devem ser.

Exemplo de prompt:

Ao criar uma nova entrada, preencha 'Status' como 'Não Iniciado' por padrão e deixe 'Prazo final' em branco.

Exemplo de um prompt de MCP completo para Breeze agents

Você está conectado ao servidor Notion MCP. Use o banco de dados intitulado 'Rastreador de implementações de recursos'. Inclui as seguintes colunas: 'Nome do Recurso' (título), 'Status' (selecione: Não Iniciado, Em Andamento, Concluído), 'Proprietário PM' (pessoa) e 'Data de Liberação de Destino' (data). Seu trabalho é encontrar todos os recursos marcados como 'Em Andamento' e retornar seus nomes junto com o Proprietário PM. Use a ferramenta query_database e extraia somente os resultados deste banco de dados.