How to Set Up a HubSpot Knowledge Base Agent

Creating a guided self-service experience in Hubspot starts with configuring a dedicated knowledge base agent. This agent helps visitors access relevant articles, get tailored suggestions, and move smoothly between your knowledge base and support channels. The steps below walk you through setup, customization, and access control so you can launch a reliable support assistant.

What Is a HubSpot Knowledge Base Agent?

A knowledge base agent in HubSpot is a configurable assistant that surfaces help content to visitors. It can recommend articles, answer common questions using your documentation, and direct users to your help desk when they need more support.

On the source configuration page, you can:

Select which knowledge base is used.
Customize how the agent appears on your site.
Control how and when the agent offers help.
Manage what articles are available to different audiences.

This setup ensures that visitors see the right content at the right time and that your support team receives better-qualified requests.

Before You Configure the HubSpot Agent

Before building your knowledge base agent in HubSpot, check a few prerequisites so everything connects smoothly.

Make sure you have an existing knowledge base with published articles.
Confirm you have the correct permissions to edit knowledge base and inbox settings.
Decide which support inbox or help desk you want the agent to reference.
Review which segments of your audience should see private or restricted articles.

Preparing these pieces in advance will make the configuration process faster and more consistent.

Step 1: Access the HubSpot Knowledge Base Settings

Begin by navigating to the knowledge base area inside your HubSpot account. The exact menu structure can vary slightly depending on your subscription, but the general flow is the same.

Sign in to your HubSpot portal.
Open the settings or service tools area.
Locate the Knowledge Base section.
Open the configuration panel for your knowledge base agent.

This panel is where you will manage how the assistant behaves, what content it uses, and how it interacts with the rest of your support tools.

Step 2: Connect the Agent to Your Knowledge Base in HubSpot

Next, connect the assistant to the correct set of articles so it can return accurate, useful results.

Select the primary knowledge base the agent should use.
Confirm the language and domain settings for your content.
Ensure that any draft or internal-only articles are correctly marked if they should not appear to visitors.

In HubSpot, the agent relies on your published, accessible articles. Keeping your structure clear and your topics organized will improve the quality of the responses the assistant can provide.

Step 3: Customize the HubSpot Agent Experience

You can tailor the look, tone, and behavior of your knowledge base agent in HubSpot so it matches your brand and support strategy.

Visual and Branding Options in HubSpot

Use styling controls to align the agent with the rest of your site.

Choose colors and fonts that match your theme.
Add your logo or icon if the interface allows it.
Adjust the widget position and size so it does not block key content.

Agent Greeting and Tone in HubSpot

Configure how the assistant greets visitors and suggests articles.

Write a friendly welcome message that sets expectations.
Explain briefly that the agent uses your knowledge base to provide answers.
Offer a clear path to contact support if the articles do not solve the problem.

Making these details explicit helps users understand when to rely on self-service and when to escalate to your team.

Step 4: Control Article Access in Your HubSpot Knowledge Base

The knowledge base agent follows the same access rules as your articles. Set these carefully so sensitive information remains protected while public help stays easy to find.

Public vs. Private Content in HubSpot

Within each article’s settings, choose the appropriate visibility level.

Public: Articles that anyone can view without logging in.
Private: Articles limited to certain contacts, customers, or internal teams.

The agent will only recommend content that a visitor is allowed to access, based on these settings.

Using Lists and Permissions with HubSpot

For private or restricted knowledge bases, configure lists and permissions:

Create lists of customers or internal users who should have access.
Assign access to those lists in your knowledge base visibility settings.
Test with sample users to confirm that restricted articles appear only where intended.

Proper permissions help your HubSpot agent deliver targeted information without exposing confidential details.

Step 5: Connect the HubSpot Agent to Your Help Desk

While the knowledge base agent focuses on self-service, it should also provide a smooth path to live support when needed.

Open your shared inbox or help desk settings.
Confirm which inbox the agent should direct users to for further help.
Align any forms or ticket fields with the topics covered in your knowledge base.

This alignment helps ensure that when users transition from articles to tickets, your team receives context about the issue and can respond faster.

Step 6: Test and Optimize Your HubSpot Knowledge Base Agent

After configuration, thoroughly test the assistant before and after publishing.

Interact with the agent as a new visitor would.
Search for common questions and confirm that the right articles appear.
Verify that restricted content does not display to unauthorized users.
Check that links to the help desk and contact options work as expected.

Use engagement metrics and support feedback from HubSpot reports to identify gaps in your content and refine the agent over time.

Best Practices for Maintaining Your HubSpot Knowledge Base Agent

Keeping the agent effective is an ongoing process. Use a regular maintenance routine to ensure high-quality assistance.

Review search logs to see which queries are not returning helpful articles.
Create or update content to cover missing topics.
Retire or merge outdated articles to avoid conflicting guidance.
Re-test visibility rules when you add new audiences or products.

Consistent maintenance helps your HubSpot knowledge base remain reliable and aligned with your current offerings.

Learn More About HubSpot Knowledge Base Configuration

For complete, product-specific instructions, you can refer directly to the official documentation at this HubSpot knowledge base agent guide. It provides detailed, up-to-date steps and screenshots for every configuration area.

If you need broader strategy guidance, implementation support, or optimization for your overall service experience, you can explore additional resources from Consultevo, a consultancy focused on digital systems and customer experience.

By following these structured steps and revisiting your configuration regularly, you can make the most of the knowledge base tools in HubSpot and offer visitors a seamless, efficient self-service journey.

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

“`