Use assistants and agents in Breeze studio

Breeze studio lets you decide how AI behaves in your HubSpot account by building assistants and customizing agents. Assistants help users find information, generate content, and answer questions, while agents complete structured tasks using your data and tools. Together, they enable you to define AI behaviors that support the workflows your team relies on.

Before you get started

Before you begin working with assistants and agents in Breeze studio, make sure to fully understand Breeze, the requirements to use these tools, as well as their limitations and considerations.

Please note: Please avoid sharing any sensitive information in your enabled data inputs for AI features, including your prompts. Admins can configure generative AI features in account management settings. For information on how HubSpot AI uses your data to provide trustworthy AI, with you in control of your data, you can refer to our HubSpot AI Trust FAQs.

Please note: Breeze features use artificial intelligence and machine learning models. To understand HubSpot’s approach to AI, data usage, and security, learn more about HubSpot's AI Model Cards and HubSpot's AI Cloud Infrastructure FAQs.

Understand requirements

• A Super Admin must toggle the following switches on in AI Settings:
  • Give users access to generative AI tools and features
  • CRM data
  • Customer conversion data
  • Files data
  • Give users access to Breeze Assistant

Understand limitations & considerations

• HubSpot's pre-built agents have default inputs, instructions, and tools that can't be edited, deleted, or rearranged.
• If an agent’s configuration relies on other HubSpot features (e.g., blog or landing pages) that a user doesn't have access to, the agent can't be run by that user, even if the user has permission to edit or run the agent.

Understand assistants and agents

Assistants and agents are two types of AI-driven components that support work across your HubSpot account. Each component plays a different role within Breeze and interacts with your data in distinct ways.

Assistants focus on delivering information in a conversational format, while agents follow defined steps to complete tasks. Assistants prioritize speed and guidance, whereas agents may take longer due to task complexity.

Install assistants and agents

Assistants and agents are available in the Breeze Marketplace and can be customized further in Breeze studio.

1. In your HubSpot account, navigate to Breeze > Marketplace.
2. At the bottom of the page, click Explore all.
3. On the Marketplace page, click Filters.
4. Click the Agent type dropdown menu and select Assistants or Agents.
5. Click an assistant card or agent card (e.g., Internal FAQ Assistant) or Company research agent).
6. On the listing page, review the assistant or agent information: 
   • Built by: creator of the assistant or agent.
   • Overview: summary of the capabilities of the assistant or agent. Click See more to view the entire summary.
   • Features: explanation of individual features available in the assistant or agent. 
   • Agent functionality (agents only): which tools the agent uses by default.

1. • Pricing: explanation of credit usage. Learn more about HubSpot Credits and billing.
   • More info: additional information about the assistant or agent, including links to contact the assistant's or agent's creator for support.
   • Feedback: users can provide feedback on the assistant or agent to help improve it's performance and capabilities.
2. Click Add beta [assistant or agent].
3. In the dialog box, select the checkbox to confirm participation in the beta, then click Add beta [assistant or agent].

Manage assistants

Manage assistants in Breeze studio to define how they behave, the information they use, and how they support users in Breeze Assistant. Assistants can be created from prompts or built from scratch, then customized, published, and used in Breeze Assistant to answer questions or complete tasks.

Create assistants

Create assistants in Breeze studio to define how an assistant behaves and what tasks it supports. Assistants can be created from a prompt or built from scratch, depending on the level of customization required.

1. In your HubSpot account, navigate to Breeze > Breeze Studio.
2. Click the Assistants tab.
3. To create a new assistant, click Create assistant in the top right.
4. To create the assistant from scratch, click Start from scratch in the dialog box. The assistant editor will open to continue customizing the assistant.
5. To create the assistant using a prompt, enter text to describe what the assistant does, its human role, goal, and output. 
6. When finished, click Create assistant to continue customizing the assistant.

Customize assistants

Customize assistants by editing their behavior, instructions, welcome message, conversation starters, and the information sources the assistant can access. These settings determine how the assistant interacts with users and the context it uses in responses.

1. In your HubSpot account, navigate to Breeze > Breeze Studio.
2. Click the Assistants tab.
3. Hover over the assistant card, then click the verticalMenuIcon menu icon, and select Configure.
4. In the assistant editor, click the edit edit icon at the top of the page and enter a name for your assistant.
5. In the Guide how this assistant behaves section, enter a message that will appear for any users using the assistant in the Welcome message field. Use the rich text editor to format the message (e.g., bold).
6. Enter a description of what the assistant should do and how it should interact with users in the Assistant instructions field.
7. Enter conversational starters that appear in an assistant to help users begin a conversation in the Conversation starters field. For example, you can create conversation starters that ask the custom assistant to summarize CRM updates, draft an email, or surface recent contact activity.

7. In the Set the information this assistant can access section, set the information the assistant can pull from to answer users' questions:
   • In the What this assistant can do field, select Browse the web to allow the bot to use search engines to find answers to questions. You can also select Read your HubSpot CRM records to allow the bot access to that data.
   • In the What this assistant knows field, click Add knowledge to add a knowledge vault you've uploaded with context about your business. Learn more about using knowledge vaults in Breeze studio.
8. To edit the assistant's icon, click the current icon on the top left. Then in the right panel, select an image from HubSpot's files tool or upload a new one. 
9. To test the assistant, enter a prompt in the preview in the right column, then click the send send icon. 
10. When finished, click Publish in the top right to make the assistant available to users in Breeze Assistant. 

Use assistants in Breeze Assistant

After publishing an assistant, access it through Breeze Assistant to answer questions, generate content, or run processes defined in the assistant’s configuration. Selecting an assistant switches Breeze Assistant into a mode that uses that assistant’s behavior and knowledge.

1. In the top navigation bar, click Breeze Assistant in the top right. 
2. In the right panel, click the Assistants dropdown menu and select a custom assistant in the top left.
3. To add apps from Dashworks, click Add apps, then select each app you want to include.
4. Enter a prompt, and then click the send send icon. To use a conversation starter, click a prompt in the Some things you can ask me section.

Manage agents

Manage agents in Breeze studio to customize, run, and review output. Agents operate using predefined inputs, instructions, tools, and knowledge, and can be customized or cloned to support additional tasks.

Customize agents

Customize agents by adjusting their inputs, instructions, tools, knowledge sources, and automation settings. These configurations determine how the agent operates and what information it uses when running tasks.

1. In your HubSpot account, navigate to Breeze > Breeze Studio.
2. Click the Agents tab.
3. Hover over the agent card, then click the verticalMenuIcon menu icon, and select Configure.
4. In the agent editor, click Clone to edit a copy of the agent. 
5. In the What this agent needs from users section, fill in any fields that are required during setup. 
6. In the During setup section, click Manage inputs to manage custom inputs that give the agent information.
   
   • In the right panel, click the Add input dropdown menu and select an input format to add a new custom input.
   • On the input card, enter a name and description for your input.
   • If the input is required to run the agent, select the Required checkbox.
   • To rearrange custom inputs, click the dragHandle drag and drop icon on the input card and drag the input into a new location.
   • To remove a custom input, click the X on the input card.
7. In the Agent instructions field, review the agent's default instructions. This field can't be edited. 
8. To add additional instructions, click Add extra instructions and enter additional context on the agent's tone, structure, or output format.
9. In the What this agent can access section, review the default tools this agent can use to accomplish its tasks. These tools can't be removed.
10. To add additional tools, click Add tool. Learn more about using tools in Breeze studio.
11. In the Knowledge section, click Add knowledge to add a knowledge vault with additional context. Learn more about using knowledge vaults in Breeze studio.
12. For agents that support automation, click Select trigger in the Automate this agent section to set a trigger for when the automation will occur. Automation requires a Professional or Enterprise subscription to use.

Please note: automation has a daily limit of 100 runs per day. This limit resets at 12:00 AM UTC. Additionally, existing records can't be enrolled in bulk when publishing the agent.

13. To test the agent, enter values for the required fields on the right. Required fields will be marked with an * asterisk.
    • Click Run agent to test the agent's current configuration.
    • To run an additional test, click New test in the top right.
14. When finished, click Publish in the top right.

Run agents

Run agents in Breeze studio to execute their configured workflows. Running an agent generates output based on the instructions, inputs, and tools defined for that agent.

1. In your HubSpot account, navigate to Breeze > Breeze Studio.
2. Click the agent card.
3. Enter values in any fields that are used each time the agent runs. Required fields will be marked with an * asterisk.
4. Click Run agent to start the agent. The time it takes to run the agent will depend on the complexity of required tasks.

Review agent output

When the agent has finished running, review the agent's run output and sources. You can also export or share output. Learn more about reviewing agent output.

Manage assistant or agent access

Control which users have access to each assistant and agent. By default, Super Admins can edit agents and assistants and all users can run them.

1. In your HubSpot account, navigate to Breeze > Breeze Studio.
2. Click the Assistants or Agent tab.
3. Hover over the assistant or agent card, then click theverticalMenumenu icon and select Configure.
4. In the editor, click Manage access in the top left.
5. In the right panel, select an access option:
   • Owners and super admins can edit and run: only the user, who created or installed, and Super Admins can edit and run the assistant or agent.
   • Owners and super admins can edit, everyone can run: only the user, who created or installed, and Super admins can edit the agent. Every user can run the assistant or agent.
   • Everyone can edit and run: any user can edit and run the assistant or agent.
   • Custom team and user access: only selected users and teams can edit or run the assistant or agent. If you select this option there will be additional access options:
     • Run and edit: selected users or teams can run and edit the assistant or agent.
     • Run: selected users or teams can run the assistant or agent.
6. When finished, click Publish in the top right.