Home/HighLevel/Features/Workflows/How to configure the HighLevel AI Agent workflow action, add tools, choose a model and set output for your workflow

Workflows and Automation

How to configure the HighLevel AI Agent workflow action, add tools, choose a model and set output for your workflow

In short

The AI Agent workflow action enables a HighLevel workflow to execute multiple tasks automatically using plain language instructions. You select a model, enable the needed tools, let the agent decide execution order and inputs, and capture its response as text or JSON for downstream steps, while reviewing logs for insight.

AreaWorkflows · Section
Used forReal estate brokerage, Ecommerce store, SaaS company
PlanPremium action. Incurs additional charges per execution
Setup steps14 steps in 1 task
Last updatedNovember 17, 2026

01Who this is for

  • Founders who need to replace many manual workflow steps with a single, flexible action.
  • Marketing managers looking to personalize follow up messages without building separate automations.
  • Operations teams that must update custom fields or trigger external tasks based on dynamic data.

02AI Agent workflow actions, explained

The AI Agent action is a premium workflow element that interprets a written prompt and performs a series of operations using the tools you allow it to use. It can call built in actions such as sending SMS, updating contact fields, or any custom tool you add.

When a workflow runs, the agent receives the trigger data, your instructions, and any enabled tools. It then decides which tool to call, what values to supply, and in what order, producing either free text or a JSON payload that downstream steps can reference.

You find the AI Agent option inside the workflow builder under the Workflow AI section. After placing it on the canvas, you configure its name, template or custom prompt, model, tools, and advanced options such as conversation memory and output format.

03How businesses use AI Agent workflow action

  • Real estate brokerage. The broker creates a workflow that runs when a lead submits a property inquiry. Inside the AI Agent, they add the Search Knowledge Base tool to pull listing details, enable the Update Custom Value tool to store a suggested showing time, and let the agent send a personalized email and SMS with a booking link.
  • Ecommerce store. When a new customer registers, the store adds an AI Agent step that enriches the contact with recent purchase history, generates a discount code using the Update Custom Value tool, and sends a welcome message. The JSON output includes the code for later steps.
  • SaaS company. A lead capture form triggers a workflow that launches the AI Agent. The agent reads the form data, decides which sales rep to assign, creates an opportunity, and adds a task via the appropriate tool. The result is passed to subsequent actions for reporting.

04The numbers and rules that matter

  • Premium action. Using this action incurs additional charges per execution.
  • Up to 10 tools can be added per agent; internal tools such as Date Calculator and Math Operations do not count toward this limit.
  • Automatic token optimizations can reduce execution costs by up to 50%.
  • Models are grouped by provider (Anthropic, Google, OpenAI) and include effort levels Low, Medium, High.
  • OpenAI GPT 6 Sol is for complex, multistep tasks; GPT 6 Luna is for faster, high volume tasks.

05Before you start

  • The AI Agent action is a premium feature and will add a per execution charge.
  • You must have access to the workflow builder and an appropriate subscription that includes premium actions.

06How to set up and use AI Agent workflow action in HighLevel

Set up the AI Agent workflow action

  1. Navigate to Automations > Workflows.
  2. Start a new workflow or modify an existing one.
  3. Select a suitable trigger such as a form submission or contact creation.
  4. Click the plus button or choose the placeholder to add an action on the canvas.
  5. Pick the AI Agent option from the Workflow AI group.
  6. Give the action a descriptive name.
  7. Choose Build Your Own if you want to start from a blank configuration.
  8. Enter the task description in the Instructions field.
  9. Press Enhance Prompt to reorganize the instructions, if desired.
  10. Select the AI model that will run the agent.
  11. Click the plus button to add a tool and pick the ones the agent may use.
  12. Set each tool’s fields to let the AI generate values or to use fixed inputs.
  13. Open Advanced Options and turn on Conversation Memory or define the Output Format as needed.
  14. Save the action to make the workflow live.

07What it looks like in HighLevel

08Settings that matter

  • Action Name. A label you assign to identify the AI Agent step within the workflow.
  • Template. A pre filled set of instructions and tools that you can start from or replace.
  • Instructions. The plain language guide that tells the agent what to do and how to decide.
  • Enhance Prompt. A helper that rewrites loosely written instructions into a clearer, more detailed prompt.
  • Model. The underlying language model that powers the agent’s reasoning.
  • Tools. The actions the agent is allowed to call during its run.
  • Conversation Memory. An optional rolling summary of prior runs for the same contact to give the agent context.
  • Output format. The shape of the data the agent returns, none, plain text, or JSON.

09Things to know before you rely on it

  • You can attach up to ten tools to a single AI Agent; internal utilities such as Date Calculator and Math Operations do not count toward this cap.
  • Each execution incurs token usage charges based on the selected model and any premium tools used.
  • Automatic token optimizations may lower costs by up to fifty percent without any manual setting.

10If something goes wrong

  • Attempting to add more than ten tools causes an error.. Remove some tools so the total number is ten or fewer.

11How it connects to the rest of HighLevel

  • Learn how the AI Decision Maker works in HighLevel workflows. AI Decision Maker
  • Explore the AI Intent Detection workflow action for automatic classification. AI Intent Detection
  • Review pricing details for HighLevel plans and premium actions. Pricing
  • Start a thirty day trial to test AI workflow actions. 30 day trial

Michael's take

Michael Reimer
Michael ReimerFounder of CRM Pros, HighLevel Commander and Certified Admin

The AI Agent workflow action is overkill for simple automations that can be built with a few standard steps. Skip it if you only need basic notifications or single action updates.

Get More InformationOpens on HighLevelPublished November 2, 2026 · Updated November 17, 2026

Common questions

Common questions about AI Agent workflow action.

Is there a limit on how many tools I can add?

Yes. Up to ten tools can be attached to an AI Agent, not counting internal utilities.

Which model should I pick for my task?

Select a model based on the description shown in the dropdown. Simpler tasks can use faster, lower effort models, while complex multi step work benefits from a reasoning capable model with higher effort.

Can the AI Agent be used with any workflow trigger?

Yes. The action works with any trigger, though some templates expect a specific trigger to be present.

What does the Enhance Prompt button do?

It reorganizes your raw instructions into a more structured and detailed prompt, improving clarity for the agent.

When should I enable Conversation Memory?

Turn it on when the same contact may run through the AI Agent step multiple times and you need the agent to remember previous runs.

How can I view what the agent performed during a run?

Open the Execution Logs tab in the workflow builder, select the AI Agent execution, and review the trace of model calls, tool usage and input output data.

Next step

Pick the features that matter. Then get the plan that unlocks them.

Explore the features you want, start with the five at the top, and upgrade through my link when you are ready. The bonuses and the team come with it.

The features directory explains every HighLevel feature in plain English. Browse it to see what the platform can do.

Back to the FeaturesSee the full details
⌃

Site preview

Explore the next page

This destination is reserved in the page inventory and is not built yet.