Getting Started with HubSpot Customer Agents

HubSpot now lets you build powerful customer agents that use your own content, tools, and workflows to give automated yet accurate answers to customers and internal teams. This guide walks you through how to create, configure, test, and manage these agents so you can get value from day one.

Before you begin, make sure your user has a Service seat and that your account includes access to customer agents. Some features, like content collections and tools, may vary based on your subscription tier and region.

What a HubSpot Customer Agent Can Do

A customer agent in HubSpot is an AI assistant that can be shared internally or externally. It can rely on FAQs, documents, and other resources you select, and it can also use tools such as CRM data or workflows to complete actions for users.

The main capabilities include:

Answering questions using trusted knowledge sources.
Using tools you connect to the agent to look up data or trigger actions.
Providing short or detailed responses based on your configuration.
Following instructions you define for tone, style, and priorities.

Agents can then be embedded in support channels or used by internal teams as a central assistant.

How to Create a New HubSpot Customer Agent

To create a customer agent, you will use the customer agent editor in your account. Follow the steps below to create a new agent from scratch.

In your HubSpot account, navigate to the workspace for customer agents (typically under Service tools or AI features).
Select the option to create a new customer agent. You may see templates or starter options depending on your subscription.
Give your agent a clear and descriptive name, such as “Support FAQ Bot” or “Onboarding Helper.” This name can be visible to end users.
Add a description so internal teammates understand the purpose and scope of the agent.
Save the initial configuration to open the full editor.

Once created, you can configure knowledge sources, tools, and behavior settings that define what the agent can and cannot do.

Configuring HubSpot Agent Knowledge Sources

Knowledge sources are the foundation of your customer agent. They control which information the system can reference when answering questions.

Types of Knowledge Sources in HubSpot

Although available options can evolve, common types of sources include:

Help articles, FAQs, and documentation stored in your portal.
Knowledge base collections and content libraries.
Imported or connected documents such as PDFs or text files.
Other structured resources that the agent can read and index.

Make sure the content you connect is accurate, up to date, and written clearly. The quality of your sources has a direct impact on the quality of the answers.

Adding Knowledge to Your HubSpot Customer Agent

Open the agent in the customer agent editor.
Go to the knowledge, content, or training tab (label names may vary slightly).
Select the option to add or manage sources.
Choose the collections, knowledge base articles, or documents you want to include.
Save and allow time for indexing if your workspace prompts you to do so.

You can return to this area any time to add or remove sources as your product and processes change.

Connecting Tools for Your HubSpot Customer Agent

Tools allow the agent to go beyond static answers and interact with live data or workflows. For example, a tool might let the assistant look up ticket details or trigger an onboarding sequence.

Common Tool Use Cases in HubSpot

Looking up CRM records, such as contacts, companies, or deals.
Retrieving ticket or subscription details for support scenarios.
Triggering existing workflows or automations for follow-up actions.
Performing simple updates to records with appropriate safeguards.

Adding Tools to Your Customer Agent

Open the agent in the editor and locate the tools or capabilities section.
Review the available tools your subscription supports, such as CRM lookups or workflow triggers.
Enable the tools that match the scope of your agent. For instance, a billing helper might only need subscription lookup tools.
For each tool, configure permissions and limits so the agent uses it safely and only for valid requests.
Save changes and run a few test prompts to confirm that tools are working as expected.

Always verify that tool actions align with your data governance standards before making the agent widely available.

Setting Up Instructions and Behavior in HubSpot

Instructions guide your customer agent’s behavior, tone, and priorities. Clear guidance helps keep responses accurate and on-brand.

Defining Agent Instructions in HubSpot

Within the configuration editor, you will find a section dedicated to instructions or system prompts. Use this to set rules such as:

Who the agent is and who it serves (for example, “You are a support assistant for our SaaS app”).
Allowed topics and requests the assistant should handle.
Topics the assistant must avoid or escalate.
Preferred tone (formal, friendly, concise, or detailed).
Whether the agent should admit when it does not know an answer.

Keep instructions specific, concise, and focused on user outcomes so the system can follow them consistently.

Limiting Scope and Protecting Data

When configuring a customer agent, restrict scope to reduce risk and confusion. You can do this by:

Providing examples of valid and invalid questions.
Disabling tools that are not required for the use case.
Referencing only the knowledge sources that match the intended audience.
Including guidance on when to direct users to a human agent.

These safeguards help ensure that automated responses support your policies and compliance standards.

Testing and Refining Your HubSpot Customer Agent

Before releasing an agent to customers or internal users, test it thoroughly. The customer agent editor usually includes a testing panel or chat window.

How to Test Your Agent

Open the test chat in the agent editor.
Ask common questions your customers or team members might ask.
Try edge cases, unclear wording, and complex requests to see how the agent responds.
Check whether the agent is using the correct knowledge sources and tools.
Adjust instructions, sources, or tools based on what you observe, then test again.

Repeat this process until answers are reliable, on-brand, and aligned with your support standards.

Deploying a HubSpot Customer Agent

After testing, you can make the agent available in the channels where your audience interacts with your team.

Typical Deployment Options

Depending on your subscription and configuration, you may be able to:

Add the agent to a public-facing chat widget on your website.
Use the agent in internal help portals or team workspaces.
Connect the agent to specific inboxes or pipelines for targeted use cases.

Consult your account documentation for details on exactly where and how customer agents can appear in your environment.

Best Practices for Managing HubSpot Customer Agents

Launching an agent is not a one-time project. Plan for ongoing maintenance so the system stays accurate and helpful.

Ongoing Optimization Tips

Review conversations regularly to spot missing content or confusing answers.
Update knowledge sources whenever you release new features or policies.
Refine instructions when you see repeated misunderstandings.
Monitor how often the agent escalates to human support and why.

Over time, these adjustments will improve response quality and user satisfaction.

Additional HubSpot Resources

To dive deeper into configuration details, available tools, and current limitations, refer to the official documentation for creating a customer agent in your account. You can access the latest help article directly at this HubSpot knowledge page.

If you are planning a broader strategy around AI, automation, and CRM, you may also want expert guidance on implementation and optimization. A consulting partner such as Consultevo can help you design workflows, map customer journeys, and align your customer agents with your overall revenue operations.

By following the steps above, you can create a focused, reliable HubSpot customer agent that supports your team, improves response times, and delivers a more consistent experience for your customers.

Need Help With Hubspot?

If you want expert help building, automating, or scaling your Hubspot , work with ConsultEvo, a team who has a decade of Hubspot experience.

Scale Hubspot

“`