What This Update Actually Is
HubSpot shipped two connected features inside the Customer Agent configuration area: Draft Mode and Embedded Testing.
Draft Mode gives you a protected workspace. Any changes you make to Guidelines, Actions, Custom Actions, or Lead Qualification criteria stay in draft. Live traffic never sees them until you click "Publish Changes."
Embedded Testing puts a test panel directly on the same page where you're configuring. Type a message, get a response, and expand that response to see which knowledge sources the agent used, the reasoning behind its answer, and when automations like handoffs or lead qualification triggers fired. No tab-switching. No guessing.
Both features live under the Train section of Customer Agent. Both are in beta for Guidelines at launch and fully available for Actions and Lead Qualification.
Why HubSpot Shipped This
We've seen this pattern across dozens of portals: teams set up a Customer Agent, it goes live, and then nobody touches the guidelines again. Not because they don't want to improve it. Because every change feels like defusing a bomb.
The external problem is real. Before this update, any configuration change hit live customers immediately. One bad guideline edit could send an AI agent off the rails in front of a paying customer. That fear is rational, and it slows iteration to a crawl.
The internal frustration is just as real. Even brave admins who did test had to bounce between the config screen and the separate test chat, mentally mapping what they changed to what they got back. The feedback loop was broken.
HubSpot's answer is a tight configure-test-publish loop, all in one place, with zero production risk. That's the whole point of this release.
How to Use It Step by Step
- Navigate to Customer Agent. In your HubSpot portal, go to the AI Agents section and open Customer Agent.
- Open the Train section. Click into Guidelines, Actions, Custom Actions, or Lead Qualification depending on what you want to change.
- Toggle to Draft Mode. Look for the Draft toggle in the top navigation. Switch it on. Your changes are now isolated from live traffic.
- Make your configuration changes. Edit a guideline, adjust an action, or update your lead qualification criteria. Do as much as you need.
- Use the inline test panel. Type a test message in the Embedded Tester on the same page. Review the response.
- Expand the response for insights. Click the expand option to see which knowledge sources the agent pulled, the reasoning chain, and whether any automations triggered.
- Iterate until it's right. Adjust your config, test again, and repeat. The loop is instant.
- Click "Publish Changes" when you're satisfied. Only then does your configuration go live to real conversations.
What It Touches in Your HubSpot Strategy
This update ripples into more areas of your HubSpot strategy than it first appears.
On the service side, this changes how your support team should think about AI agent governance. You now have a proper change-management workflow baked into the tool. Draft, test, approve, publish. That's a real process, not a workaround.
On the sales side, Lead Qualification is the biggest win. Your agent can ask the right questions, score intent, and trigger handoffs to reps. But only if the criteria are dialed in. Embedded Testing lets sales ops iterate on qualification logic the same way a developer iterates on code: build, test, fix, ship.
On the marketing side, Content Hub and Marketing Hub portals using Customer Agent for inbound conversations can now safely tune their agent's tone, scope, and content source behavior before any update touches a live visitor.
Key Takeaway
Draft Mode effectively turns Customer Agent configuration into a staged deployment. That's a best practice for any production system handling real humans, and HubSpot now makes it the default workflow.
The Reasoning Insights panel is worth calling out separately. When you expand a test response, you see which knowledge base articles or pages the agent cited, with actual snippets. This is diagnostic gold. If your agent is pulling the wrong source, you know immediately. You fix the knowledge base or the guideline, not the symptom.
This builds directly on the previous Customer Agent Tester improvements HubSpot shipped earlier this year, which added file attachments and smarter guidelines testing. Think of those as the foundation. This release is the finished floor.
Key Takeaway
The Reasoning Insights panel closes the gap between 'my agent said something weird' and 'here's exactly why it said that.' That transparency shortens debugging from hours to minutes.
If you're doing a regular review of your portal's AI and automation setup, add Customer Agent draft-and-test cycles to your checklist. Our HubSpot portal audit checklist is a good starting point for building that habit across every hub.
Who Should Care Most
Not every update is for everyone. This one is highly relevant for a specific set of roles and company profiles.
- HubSpot admins managing Customer Agent configurations who've been scared to iterate because of production risk. This removes that barrier completely.
- Service Hub managers who use Customer Agent as their first line of support. Tighter testing means fewer escalations from AI errors.
- Sales ops teams running Lead Qualification through Customer Agent. Now they can stress-test qualification criteria against real conversation patterns before flipping the switch.
- Marketing teams using Customer Agent on landing pages or website chat to qualify inbound leads. Every guideline tweak can now be validated before it touches a prospective buyer.
- Growing companies on Professional or Enterprise tiers across any of the five hubs. If you're paying for Customer Agent and not iterating on it, this update is your invitation to start.
The one caveat: Guidelines testing is still in beta. Expect the experience to evolve. Actions and Lead Qualification are fully available now.
George's Take
I've been inside a lot of portals where Customer Agent was set up once, went live, and then sat untouched for months. The configuration was okay but not great, and nobody wanted to risk breaking it. That's not a technology problem. It's a confidence problem. This update solves it directly. Draft Mode gives you the safety net. Embedded Testing gives you the feedback. Together, they give you the confidence to actually make your AI agent better over time, which is the only way to make it genuinely useful for the humans it serves. If your team has been avoiding Customer Agent iterations because it felt too risky, that excuse is gone now. Use it.
“The only way to make your AI agent genuinely useful is to keep improving it. Draft Mode and Embedded Testing finally make that safe enough to actually do.”
If you're curious how Customer Agent can serve as a real AI presence for your brand, read about why George moved his digital clone entirely into HubSpot Customer Agent. It gives you a ground-level look at how these features come together in a real deployment.
Ready to build a Customer Agent setup your team can iterate on with confidence? Let's map out your AI agent strategy together. Book a strategy call with the Sidekick team and we'll walk through your current configuration, identify the gaps, and help you publish changes you can actually stand behind.
Frequently Asked Questions
What is HubSpot Customer Agent Draft Mode?
Draft Mode is a protected workspace inside HubSpot Customer Agent where you can make configuration changes to Guidelines, Actions, and Lead Qualification without affecting live conversations. Changes stay in draft until you manually click "Publish Changes," so no real customer interactions are impacted during testing.
What does the Embedded Testing panel show me?
The Embedded Tester lets you type a test message directly on the configuration page and see the agent's response inline. Expanding the response reveals which knowledge sources were used with actual snippets, the agent's reasoning chain, and whether any automations like handoffs or lead qualification triggers fired.
Which HubSpot plans include Customer Agent Embedded Testing?
Customer Agent Embedded Testing is available on Professional and Enterprise tiers of Marketing Hub, Sales Hub, Service Hub, Content Hub, and Data Hub. It's also available to HubSpot Credits subscribers. Free and Starter tiers are not included.
Is Customer Agent Guidelines testing fully released or still in beta?
As of the April 2026 release, Embedded Testing for Guidelines is in beta. Testing for Actions, Custom Actions, and Lead Qualification is fully available. Beta features are functional but expect the experience to continue improving as HubSpot gathers feedback.
How does Embedded Testing help with Lead Qualification setup?
Lead Qualification in Customer Agent lets your AI ask qualifying questions and trigger rep handoffs based on answers. Embedded Testing lets you simulate those conversations inline, see exactly when qualification criteria fire and why, and adjust your logic before any live prospect experiences it.
Can I use Draft Mode to review Customer Agent changes as a team before publishing?
Yes. Draft Mode keeps all unpublished changes isolated from live traffic, which makes it practical for team review workflows. Configure changes, test them thoroughly in the Embedded Tester, share your findings with stakeholders, and only publish when everyone is aligned. It functions as a basic staging environment for AI agent config.
