Central de conhecimento HubSpot

Usar assistentes e agentes no Breeze Studio

Written by HubSpot Support | 3/set/2025 13:42:28

No Breeze Studio, você pode personalizar os agentes do Marketplace da HubSpot para melhor atender às suas necessidades específicas. Você também pode criar assistentes personalizados do Breeze para fornecer informações direcionadas aos usuários em sua conta. 

Observação: evite compartilhar informações confidenciais nas entradas de dados habilitadas para recursos de IA, incluindo seus prompts. Os administradores podem configurar recursos de IA generativa nas configurações de gerenciamento da conta. Para obter informações sobre como a HubSpot IA usa seus dados para fornecer IA confiável, com você no controle de seus dados, consulte nossas Perguntas frequentes sobre confiança da HubSpot IA.

Antes de começar

Antes de começar a trabalhar com esse recurso, certifique-se de compreender totalmente quais etapas devem ser executadas com antecedência, bem como as limitações do recurso e as possíveis consequências de usá-lo. 

Compreender os requisitos

Para editar e executar agentes e assistentes no Breeze Studio, os seguintes requisitos devem ser atendidos: 
  • Nas configurações de IA, ative as seguintes opções: 
    • 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
  • Conceda aos usuários a permissão de usuário do Breeze Studio. 

Compreender limitações e considerações

  • Alguns agentes e assistentes exigem assinaturas adicionais para serem usados. Por exemplo, um agente que produz conteúdo personalizado para contas de destino pode exigir o Content Hub Professional ou Enterprise
  • Algumas ferramentas usadas pelos agentes podem exigir permissões adicionais do usuário para serem usadas. Por exemplo, uma ferramenta que gera um estudo de caso pode exigir que o usuário tenha acesso a estudos de caso. Um Superadministrador deve atribuir a permissão correspondente em Configurações para que um usuário execute o agente com esta ferramenta.
  • As entradas, instruções e ferramentas padrão de um agente criado pelo HubSpot não podem ser editadas, excluídas ou reorganizadas. 

Noções básicas sobre assistentes e agentes

Embora ambos os agentes e assistentes usem IA para melhorar a eficiência da sua equipe, eles operam de forma diferente: 

  Agentes Assistentes
Finalidade Automatiza tarefas e executa ações em sua conta da HubSpot.  Usa informações na sua conta da HubSpot ou que você carrega para responder a perguntas e fornecer documentação aos seus usuários do HubSpot.
Velocidade Mais lento, devido à complexidade Mais rápido
Usado em Breeze Studio Breeze Assistant
Exemplo de caso de uso Gerar um relatório detalhado de análise de lead. Responder às perguntas de novos funcionários usando a documentação da empresa fornecida.

Usar assistentes

Sua equipe pode acessar os assistentes no Breeze Assistant para responder a perguntas e fornecer orientação. Você pode baixar assistentes predefinidos no Marketplace da HubSpot. No Breeze Studio, você pode personalizar assistentes predefinidos ou criar assistentes personalizados do zero. 

Instalar assistentes do Marketplace da HubSpot

No Marketplace da HubSpot, você pode baixar assistentes predefinidos, além de agentes, aplicativos, temas e módulos.

  1. Clique no cartão do assistente. 
  2. Na caixa de diálogo, revise as informações do assistente: 
    • Criado por: o criador do assistente.
    • Visão geral: resumo dos recursos do assistente. Clique em Ver mais para exibir todo o resumo. 
    • Recursos: explicação de cada recurso disponível no assistente. 
    • Mais informações: informações adicionais sobre o assistente, incluindo links de contato com o criador do assistente para obter suporte. 
  3. Na parte superior esquerda, clique em Adicionar

Criar ou personalizar assistentes

No Breeze Studio, você pode criar assistentes personalizados do zero ou personalizar assistentes adicionados a partir do Marketplace da HubSpot. 

  1. Clique na guia Assistentes.
  2. Para criar um novo assistente, clique em Criar assistente no canto superior direito. Para editar um assistente existente, passe o mouse sobre o cartão do assistente, clique no ícone de menu e selecione Configurar
  3. No editor do assistente, clique no ícone edit editar na parte superior da página e insira um nome para o assistente. 
  4. Na seção Mensagem de boas-vindas, digite uma mensagem que será exibida para todos os usuários que usarem o assistente. 
  5. Na seção Instruções do assistente, insira uma descrição do que o assistente deve fazer e como ele deve interagir com os usuários. 

  1. Na seção Definir as informações que este assistente pode acessar, defina as informações que o assistente pode extrair para responder às perguntas dos usuários: 
    • Na seção O que este assistente pode acessar, selecione Navegação na web para permitir que o bot use mecanismos de pesquisa para encontrar respostas a perguntas. 
    • Na seção Conhecimento, clique em Adicionar conhecimento para adicionar um repositório de conhecimento que você carregou com o contexto sobre sua empresa. Saiba mais sobre como usar repositórios de conhecimento no Breeze Studio. 
  2. Na seção Sobre este assistente, insira uma descrição da finalidade do assistente. 
  3. Para editar o ícone do assistente, clique no ícone atual e selecione uma imagem na ferramenta de arquivos do HubSpot ou carregue uma nova. 
  4. Para testar o assistente, digite um prompt no assistente de teste na coluna da direita e clique no ícone send enviar
  5. Quando terminar de editar e testar o assistente, clique em Publicar na parte superior direita para disponibilizá-lo aos usuários no Breeze Assistant. 

Usar assistentes

  1. Na barra de navegação superior, clique em Breeze Assistant no canto superior direito. 
  2. No painel direito, clique no menu suspenso Assistentes no canto superior esquerdo e selecione um assistente personalizado
  3. Para adicionar aplicativos do Dashworks, clique em Adicionar aplicativos e selecione cada aplicativo que deseja incluir. 
  4. Digite um prompt e clique no ícone send enviar

Usar agentes

Você pode usar agentes para realizar tarefas específicas e complexas no HubSpot. No Marketplace da HubSpot, você pode baixar agentes predefinidos, além de assistentes, aplicativos, temas e módulos. Você pode então personalizar os agentes no Breeze Studio. 

Instalar agentes do Marketplace da HubSpot

  1. Clique no cartão do agente. 
  2. Revise as informações do agente: 
    • Criado por: o criador do agente
    • Instalações: o número de contas da HubSpot que instalaram este 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: quais ferramentas o agente usa por padrão. 
    • Mais informações: informações adicionais sobre o agente, incluindo links de contato com o criador do agente para obter suporte. 
  3. Na parte superior esquerda, clique em Adicionar

Personalizar Breeze agents

No Breeze Studio, você pode personalizar um agente com instruções, ferramentas e repositórios de conhecimento adicionais.

  1. Clique no nome do agente. 
  2. No canto superior direito, clique em Configurar agente
  3. Para editar uma cópia deste agente, clique em Clonar no canto superior direito do editor do agente. 
  4. Na seção O que esse agente precisa dos usuários, preencha todos os campos necessários durante a configuração. 
  5. Para gerenciar entradas personalizadas que fornecem informações ao agente: 
    • Na seção Durante a configuração, clique em Gerenciar entradas.
    • Para adicionar uma nova entrada personalizada, clique no menu suspenso Adicionar entrada no painel direito e selecione um formato de entrada
    • No cartão de entrada, insira um nome e descrição da 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 ícone dragHandle arrastar e soltar no cartão da entrada e arraste a entrada para um novo local. 
    • Para remover uma entrada personalizada, clique no X no cartão da entrada. 
  6. No campo Instruções do agente, revise as instruções padrão do agente. Este campo não pode ser editado. 
  7. Para adicionar mais instruções, clique em Adicionar instruções extras e insira contexto adicional no tom, na estrutura ou no formato de saída do agente. 
  8. Na seção O que este agente pode acessar, examine as ferramentas padrão que o agente pode usar para realizar suas tarefas. Essas ferramentas não podem ser removidas. 
  9. Para adicionar outras ferramentas, clique em Adicionar ferramenta. Saiba mais sobre como usar ferramentas no Breeze Studio. 
  10. Na seção Conhecimento, clique em Adicionar conhecimento para adicionar um repositório de conhecimento com contexto adicional. Saiba mais sobre como usar repositórios de conhecimento no Breeze Studio. 
  11. Para agentes que oferecem suporte à automação, clique em Selecionar gatilho na seção Automatizar este agente para definir um gatilho para quando a automação ocorrerá. A automação requer uma assinatura Professional ou Enterprise para ser usada. 
  12. Na coluna à direita, preencha todos os campos usados sempre que o agente for executado. Os campos obrigatórios serão marcados com um asterisco *. 
  13. Clique em Executar agente para testar a configuração atual do agente. 
  14. Para executar um teste adicional, clique em Novo teste no canto superior direito. 
  15. Quando terminar de editar seu agente, clique em Publicar na parte superior direita para aplicar suas alterações. 

Executar Breeze agents

Depois de publicar um agente do Breeze, você poderá executá-lo no Breeze Studio. 

  1. Clique no nome do agente. 
  2. Preencha todos os campos usados sempre que o agente for executado. Os campos obrigatórios serão marcados com um asterisco *. 
  3. Clique em Executar agente para iniciar o agente. O tempo necessário para executar o agente dependerá da complexidade das tarefas necessárias. 
  4. Quando a execução do agente terminar, revise a saída do agente. Por padrão, a saída será otimizada para legibilidade. Para ver a saída em markdown, ative a opção Saída visual no canto superior direito. 
  5. Para exibir as fontes que o agente está usando para gerar a saída: 
    • Na coluna Atividade, clique no botão [#] fontes abaixo de uma ação. 
    • Na caixa pop-up, clique em um site para exibir a fonte. 

  1. Para fazer download da saída no formato PDF:
    • Na parte superior da página, clique em Exportar PDF
    • Quando a exportação estiver pronta, clique no ícone notification notificação na barra de navegação superior.
    • No painel direito, clique na notificação de exportação para iniciar o download. 
  2. Para criar um link direto para a saída, clique em Copiar link. Este link somente pode ser exibido pelo usuário que executou o agente para criar a saída e pelos Superadministradores na conta. 

Revisar saída do agente

Depois de executar um agente, você pode revisar sua saída a qualquer momento. 

  1. Clique no nome do agente. 
  2. Na seção Histórico à esquerda, clique na execução que deseja revisar. 
  3. Para executar o agente novamente com ajustes, digite um prompt na coluna Atividades e clique no ícone send enviar
  4. Para renomear uma execução para facilitar a navegação, clique no ícone de menu na coluna Histórico e selecione Renomear. Em seguida, insira um novo nome para a execução. 

Gerenciar acesso do assistente ou agente

No Breeze Studio, você pode controlar quais usuários têm acesso a cada agente e assistente. Por padrão, os Superadministradores podem editar agentes e assistentes e todos os usuários podem executá-los. 

  1. Se você estiver editando o acesso para um assistente, clique na guia Assistentes
  2. Passe o mouse sobre o agente ou assistente, clique no ícone verticalMenumenu e selecione Configurar
  3. No editor, clique em Gerenciar acesso na seção Sobre este agente/assistente na coluna à esquerda. 
  4. Selecione uma opção de acesso
    • Somente eu posso editar e executar o agente/assistente: somente o usuário que criou o agente ou assistente pode editá-lo ou executá-lo. 
    • Somente eu posso editar, todos podem executar o agente/assistente: somente o usuário que criou o agente ou assistente pode editar sua configuração. Todos os usuários podem executar o agente ou assistente. 
    • Todos podem editar e executar o agente/assistente: todos os usuários podem executar e editar a configuração do agente ou assistente. 
    • Atribuir a usuários e equipes: selecione quais usuários e equipes têm acesso para Executar ou Executar e editar o agente ou assistente. 
  5. Quando terminar de editar o agente ou assistente, clique em Publicar no canto superior direito.