BetaCriar e personalizar agentes no construtor de agentes

Crie agentes personalizados (BETA) que podem analisar dados, gerar resultados e tomar ações com base em seus processos de negócios. Dentro do construtor moderno, você pode definir o que um agente deve fazer, quais dados ele pode acessar e como deve responder.

Os agentes personalizados ajudam a padronizar como as tarefas são executadas e reduzem o esforço manual aplicando lógica consistente aos seus dados. Isso é útil para processos que exigem a revisão de registros, a geração de resultados estruturados ou a tomada de decisões com base em várias fontes de dados.

Para obter uma visão geral da configuração da sua conta para recursos de IA, revise como configurar sua conta da HubSpot para adotar recursos de IA.

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 criar e personalizar agentes no construtor de agentes, revise os requisitos e considerações.

• 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

Criar um agente no construtor de agentes

Crie um agente personalizado definindo suas instruções, selecionando ações e configurando os dados e entradas que ele usará.

1. Na sua conta da HubSpot, clique em Mais e navegue até o Hub do Agente para Agentes >. Se Mais não aparecer na sua conta, navegue diretamente para o Agents > Agent Hub .

2. Na guia Introdução , clique no menu suspenso Criar no canto superior direito e selecione Agentes.

3. No construtor de agentes, configure as instruções, ações, conhecimento e entradas do seu agente.

Instruções

Defina o que o agente deve fazer e como deve se comportar. Inclua a função do agente, a meta, a abordagem e o resultado esperado.

No construtor de agentes, insira o texto no campo Instruções. Defina claramente a função, o meta, a abordagem e o resultado esperado do agente.

Por exemplo, você pode adicionar as seguintes instruções:

Role:
You’re a customer onboarding review agent responsible for preparing internal handoffs after a deal is closed.
Goal:
Analyze customer information and summarize key details needed for a successful onboarding process.
Approach: 
Review contact and company properties, deal details, and recent activity.
Identify important context such as customer goals, purchased products, timeline expectations, and risks.
Flag any missing or unclear information that may impact onboarding.
Output:
Section 1: Customer summary (3-5 bullet points).
Section 2: Key onboarding considerations.
Section 3: Missing information or risks.
Keep responses concise, structured, and actionable.

Ações

Selecione as ações que o agente pode executar. As ações determinam quais tarefas o agente pode concluir com base nas instruções.

1. No construtor do agente, clique em Adicionar ação no painel esquerdo.

2. No painel direito, clique nas guias HubSpot, Padrão ou MCP e selecione suas ações.

   • HubSpot: selecione entre diferentes tipos de ações (por exemplo, Obter dados, Gerar, Executar ação). Para filtrar os tipos de ações, clique no menu suspenso Tipos e selecione um tipo (por exemplo, Gerar).

   • Padrão: selecione entre as ações padrão, como Navegar na Web ou Ler seus registros do CRM da HubSpot.

     • Navegar na Web: dá ao agente acesso para navegar na Web.

     • Ler 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.

   • MCP: conecte seu agente a sistemas externos usando o MCP (Model Context Protocol). Saiba mais sobre os servidores MCP compatíveis.

Conhecimento

Adicione contexto de caso de uso específico que o agente pode consultar ao gerar saídas, como documentos carregados, diretrizes de marca, cofres de conhecimento ou dados relevantes do CRM.

Use a seção Conhecimento para fornecer informações de suporte que o agente pode extrair ao analisar dados ou gerar respostas. Ao contrário das entradas, esse contexto está disponível para o agente sem ser redefinido cada vez que ele é executado.

Por exemplo, um agente focado em onboarding pode confiar em detalhes do negócio, informações associadas da empresa e atividades recentes, enquanto um agente focado em conteúdo pode usar documentos ou arquivos carregados.

1. No construtor de agentes, clique em Adicionar conhecimento na seção Conhecimento .

2. No painel direito, clique em Personalizado, Padrão ou Integrações e selecione seu conhecimento.

   • Personalizado: selecione um cofre de conhecimento. Saiba mais sobre como gerenciar o contexto do agente com cofres de conhecimento.

   • Padrão: selecione a partir do contexto padrão, como seu kit de marca ou PCIs.

   • Integrações: clique em uma integração para configurar o que está incluído.

Entradas

Defina os dados específicos que o agente usa sempre que é executado, como um registro, valor fornecido pelo usuário ou informações passadas de outra ferramenta ou processo.

Use entradas para especificar em que o agente deve agir para uma determinada execução. Ao contrário do conhecimento, as entradas são fornecidas em tempo de execução e podem variar dependendo do contexto.

Por exemplo, um agente focado em onboarding pode usar entradas como nome do negócio, data de fechamento ou metas do cliente, enquanto um agente focado em conteúdo pode exigir um tópico, público ou mensagem-chave.

1. No construtor de agentes, clique em Adicionar entrada na seção Entradas .

2. Clique no menu suspenso Tipo de entrada e selecione uma opção (por exemplo, CRM Objeto ).

3. No campo Rótulo , insira um nome para a entrada. 

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.

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.

1. No construtor de agentes, clique no ícone de três pontos verticais e selecione Atribuir acesso no canto superior esquerdo.

2. 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 o agente, 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 o agente e os 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.

3. Quando terminar, clique em Atualizar.

Testar um agente no construtor de agentes

Teste seu agente para confirmar se a saída atende às suas expectativas. O teste ajuda a confirmar se o agente está usando as entradas corretas, referenciando os dados corretos e retornando os resultados esperados. 

Observação: testar um agente não consome créditos. Saiba mais sobre como revisar os custos estimados do agente no construtor de agentes.

1. No painel direito, insira as entradas necessárias.

2. Clique em Agente de teste.

3. Na caixa de diálogo, clique em Executar.

4. Na guia Saídas , revise a saída para o seguinte:

   • Confirme se o agente segue o formato esperado.

   • O agente usa os dados e o contexto esperados.

   • Identifique quaisquer lacunas, imprecisões ou respostas pouco claras.

5. Atualize a configuração do agente conforme necessário:

   • Refine as instruções para melhorar a clareza ou a especificidade.

   • Ajuste as fontes de conhecimento se os dados relevantes estiverem ausentes ou incorretos.

   • Atualize as entradas para garantir que as informações necessárias sejam incluídas.

6. Repita o teste até que a saída seja consistente e atenda aos seus requisitos. Em seguida, continue a revisar os custos estimados de crédito e definir limites de execução.

Revisar custos de crédito estimados e definir limites de execução

Depois de testar o agente, revise os Créditos HubSpot estimados necessários para a tarefa. Você também pode definir limites de execução para controlar quantos créditos um agente pode usar durante a execução, ajudando a gerenciar o uso de créditos em sua conta.

1. No construtor de agentes, clique em Executar histórico na parte superior da página.

2. No painel esquerdo, clique em uma execução de agente.

3. No painel direito, revise os créditos estimados.

Essas estimativas são fornecidas apenas para fins informativos. Os custos reais podem variar. Saiba mais sobre comovisualizar os custos de crédito estimados para agentes e definir limites mensais de execução.

Publicar um agente personalizado

Depois de testar seu agente e confirmar que a saída atende às suas expectativas, salve e publique o agente para disponibilizá-lo para uso. 

1. No construtor do agente, clique em Salvar e publicar alterações.

2. Para executar o agente, clique em Executar no canto superior direito. Saiba mais sobre como executar e revisar a saída do agente na caixa de entrada do agente.

Após a publicação, use o agente como parte de seus processos mais amplos e inclua agentes em outras automações. Saiba mais sobre como adicionar agentes aos fluxos de trabalho.

Próximas etapas

• Executar agentes e revisar a saída na caixa de entrada do agente
• Revisar custos estimados de crédito ao usar agentes