Ultima atualização: 3 de Setembro de 2025
Disponível com qualquer uma das seguintes assinaturas, salvo menção ao contrário:
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
- Na sua conta HubSpot, navegue até o Breeze > Breeze Studio.
- Na guia Agentes, clique no nome do agente ao qual você deseja adicionar prompts de MCP.
- Na parte superior direita, clique em Configure agent (Configurar agente).
- Na seção Guia de comportamento deste agente , clique em Adicionar instruções extras.
- 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.
