Gerenciar agentes no Breeze Studio

O Breeze Studio permite que você personalize agentes que concluem tarefas estruturadas usando seus dados e ferramentas da HubSpot. Esses agentes podem automatizar fluxos de trabalho repetíveis, gerar conteúdo e tomar ações em sua conta com base em entradas e instruções definidas.

Por exemplo, configure um agente para pesquisar empresas, gerar conteúdo de divulgação ou atualizar registros do CRM com base em critérios específicos.

Observação: em 13 de julho de 2026, os assistentes personalizados foram descontinuados. Os assistentes personalizados existentes são somente leitura e migrados automaticamente para os projetos. Migre as mensagens de boas-vindas e os iniciadores de conversa do assistente* personalizado* para as instruções do projeto .

Observação: você pode gerenciar o acesso aos recursos de IA nas suas configurações de IA e configurar quais dados são compartilhados. Consulte as Perguntas frequentes sobre a confiança na IA e os Cartões de modelo de IA da HubSpot para obter informações detalhadas sobre controles de segurança de IA, uso de dados e conformidade.

Antes de começar

Antes de começar a trabalhar com agentes no Breeze Studio, certifique-se de compreender completamente o Breeze, os requisitos para usar essas ferramentas, bem como suas limitações e considerações.

Observação: os recursos do Breeze usam modelos de inteligência artificial e aprendizado de máquina. Para entender a abordagem da HubSpot à IA, o uso de dados e a segurança, saiba mais sobre os Cartões de Modelo de IA da HubSpot e as Perguntas frequentes sobre infraestrutura de nuvem de IA da HubSpot.

Noções básicas sobre os requisitos

• Um superadministrador deve ativar as seguintes opções nas Configurações de IA:
  • Ofereça aos usuários acesso a ferramentas e recursos de IA generativa
  • Dados do CRM
  • Dados de conversação do cliente
  • Dados dos arquivos
  • Conceder aos usuários acesso ao Breeze Assistant

Compreender limitações e considerações

• Para obter uma visão geral da configuração da sua conta para recursos de IA, revise como configurar uma conta da HubSpot para adotar recursos de IA.
• Se a configuração de um agente depender de outros recursos do HubSpot (por exemplo, blog ou landing pages) aos quais um usuário não tem acesso, o agente não poderá ser executado por esse usuário, mesmo que o usuário tenha permissão para editar ou executar o agente.

Instalar agentes

Os agentes estão disponíveis na Breeze Marketplace e podem ser personalizados ainda mais em Breeze Studio.

1. Na sua conta HubSpot, clique em Mais e navegue até Breeze > Marketplace. Se Mais não aparecer na sua conta, navegue diretamente para Breeze > Marketplace.
2. Na parte inferior da página, clique em Explorar tudo.
3. Na página do Marketplace , clique em Filtros.
4. Clique no menu suspenso Tipo de agente e selecione Agentes.
5. Clique em um cartão de agente (por exemplo, Agente de pesquisa da Empresa).
6. Na página de listagem, revise as informações do agente: 
   • Criado por: criador do agente.
   • Visão geral: um resumo dos recursos do agente. Clique em Ver mais para exibir todo o resumo.
   • Recursos: explicação de cada recurso disponível no agente. 
   • Funcionalidade do agente: ferramentas que o agente usa por padrão.
   • Preço: explicação do uso do crédito. Saiba mais sobre créditos e cobrança da HubSpot.
   • Mais informações: informações adicionais sobre o agente, incluindo links de contato com o criador do agente para obter suporte.
   • Feedback: os usuários podem fornecer comentários sobre o agente para ajudar a melhorar seu desempenho e recursos.
7. Clique em Adicionar.

Gerenciar agentes

Gerencie agentes no Breeze Studio para personalizar, executar e revisar a saída. Os agentes operam usando entradas, instruções, ferramentas e conhecimentos predefinidos e podem ser personalizados ou clonados para dar suporte a tarefas adicionais.

Personalizar agentes

Personalize os agentes ajustando suas entradas, instruções, ferramentas, fontes de conhecimento e configurações de automação. Essas configurações determinam como o agente opera e quais informações ele usa ao executar tarefas.

1. Na sua conta HubSpot, clique em Mais e navegue até Breeze > Breeze Studio. Se Mais não aparecer na sua conta, navegue diretamente para Breeze > Breeze Studio.
2. Clique na guia Agentes .
3. Passe o mouse sobre o cartão do agente, clique nosverticalMenuIcontrês pontos verticais e selecione Configurar.
4. Na seção O que esse agente precisa dos usuários, preencha todos os campos necessários durante a configuração. Clique em Gerenciar entradas para gerenciar entradas personalizadas que fornecem informações ao agente.
   
   • No painel direito, clique no menu suspenso Adicionar entrada e selecione um formato de entrada para adicionar uma nova entrada personalizada.
   • No cartão de entrada, insira um nome e descrição para sua entrada.
   • Se a entrada for necessária para executar o agente, marque a caixa de seleçãoObrigatório.
   • Para reorganizar entradas personalizadas, clique no dragHandle ícone de arrastar e soltar no cartão de entrada e arraste a entrada para um novo local.
   • Para remover uma entrada personalizada, clique no X no cartão de entrada.
5. Na seção Guia como este agente se comporta, revise as instruções padrão do agente. Este campo não pode ser editado. 
6. Para adicionar instruções adicionais, insira contexto adicional sobre o tom, a estrutura ou o formato de saída do agente no campo Instruções adicionais .
7. Na seção O que este agente pode fazer , revise as ferramentas padrão que este agente pode usar para realizar suas tarefas. Essas ferramentas não podem ser removidas dos agentes predefinidos do HubSpot.
   • Navegar na Web: dá ao agente acesso para navegar na Web.
   • Acessar seus registros do CRM da HubSpot: dá ao agente acesso para ler seus registros do CRM.
   • Gravar nos registros do CRM da HubSpot: dá ao agente acesso para gravar nos registros do CRM. Clique no approveDraftIcon ícone de aprovação para ativar a opção Revise antes de executar esta ferramenta . Se a opção Revisar antes de executar esta ferramenta estiver ativada, os fluxos de trabalho exigirão aprovação para atualizações do CRM.

9. Para adicionar outras ferramentas, clique em Adicionar ferramenta. Saiba mais sobre como usar ferramentas no Breeze Studio .
10. Na seção O que este agente sabe , clique em Adicionar conhecimento para adicionar um cofre de conhecimento com contexto adicional. Saiba mais sobre como usar cofres de conhecimento no Breeze Studio.
11. Na seção Automatizar este agente , alguns agentes oferecem suporte à automação. Clique em Selecionar gatilho  na seção Automatizar este agente para definir um gatilho para quando a automação ocorrerá. 

Observação: a automação tem um limite diário de 1.000 execuções por dia. Esse limite é redefinido às 12h UTC.

12. Para configurar destinatários para notificações automatizadas de execução de agente, clique em Gerenciar destinatários. Saiba mais sobre como gerenciar destinatários de notificações automatizadas de execução de agentes.
13. Para testar o agente, insira valores para os campos obrigatórios à direita. Os campos obrigatórios serão marcados com um asterisco *.
    • Clique em Executar agente para testar a configuração atual do agente.
    • Para executar um teste adicional, clique em Novo teste no canto superior direito.
14. Para restaurar uma versão anterior de um agente, clique no recentlySelectedIcon ícone Histórico do agente no canto superior esquerdo. Na caixa pop-up, clique na versão anterior. Em seguida, clique em Restaurar no canto superior direito.
15. Quando terminar, clique em Publicar no canto superior direito.

Executar agentes

Execute agentes no Breeze Studio para executar seus fluxos de trabalho configurados. A execução de um agente gera saída com base nas instruções, entradas e ferramentas definidas para esse agente.

1. Na sua conta HubSpot, clique em Mais e navegue até Breeze > Breeze Studio. Se Mais não aparecer na sua conta, navegue diretamente para Breeze > Breeze Studio.
2. Clique na guia Agentes .
3. No cartão do agente, clique em Abrir.
4. Na caixa de entrada do agente, insira valores em todos os campos que são usados sempre que o agente é executado. Os campos obrigatórios serão marcados com um asterisco *.
5. Clique em Executar agente para iniciar o agente. O tempo necessário para executar o agente dependerá da complexidade das tarefas necessárias.

Revisar saída do agente

Quando o agente terminar de ser executado, revise a saída de execução e as fontes do agente. Você também pode exportar ou compartilhar a saída. Saiba mais sobre como revisar a saída do agente.

Gerenciar acesso do agente

Controle quais usuários têm acesso a cada agente. Por padrão, os Superadministradores podem editar agentes e todos os usuários podem executá-los.

1. Na sua conta HubSpot, clique em Mais e navegue até Breeze > Breeze Studio. Se Mais não aparecer na sua conta, navegue diretamente para Breeze > Breeze Studio.
2. Clique na guia Agentes .
3. Passe o mouse sobre o cartão do agente, clique nosverticalMenutrês pontos verticais e selecione Configurar.
4. No construtor de agentes, clique em Gerenciar acesso no canto superior esquerdo.
5. No painel direito, selecione uma opção de acesso:
   • Proprietários e superadministradores podem editar e executar: somente o usuário que criou ou instalou, e os superadministradores podem editar e executar o agente.
   • Proprietários e superadministradores podem editar, todos podem executar: somente o usuário que criou ou instalou e Superadministradores podem editar o agente. Todo usuário pode executar o agente.
   • Todos podem editar e executar: qualquer usuário pode editar e executar o agente.
   • Acesso personalizado de equipes e usuários: somente os usuários e equipes selecionados podem editar ou executar o agente. Se você selecionar esta opção, haverá opções de acesso adicionais:
     • Executar e editar: os usuários ou equipes selecionados podem executar e editar o agente.
     • Executar: os usuários ou equipes selecionados podem executar o agente.
6. Quando terminar, clique em Publicar no canto superior direito.