# Workflow Action - AI Agent > Learn how AI Agent workflow action automates tasks by planning, selecting tools, and executing steps autonomously—saving time and simplifying workflows. - Source: https://docs.ghlcustomercare.com/docs/workflows/workflow-ai-workflow-actions/workflow-action-ai-agent - Section: Workflows / Workflow AI Workflow Actions - Reading time: 14 min - Images: 16, each explained below --- The AI Agent workflow action helps you automate multi-step tasks in GHL Customer Care Workflows using plain-language instructions and selected tools. Instead of building every action manually, you can configure one AI Agent action to decide what to do, which tools to use, and what inputs to provide during execution. This article explains how the action works, how to configure it, and how to review its output. **Note:** This is a **premium** **action**. Using this action will incur **additional** **charges** per execution --- **TABLE OF CONTENTS** - [What is the AI Agent Action in Workflows?](#what-is-the-ai-agent-action-in-workflows)[](#key-benefits-of-the-ai-agent-workflow-action) - [Key Benefits of the AI Agent Workflow Action](#key-benefits-of-the-ai-agent-workflow-action)[](#ai-agent-action-details) - [AI Agent Action Details](#ai-agent-action-details)[](#templates) - [Templates](#templates)[](#writing-instructions) - [Writing Instructions](#writing-instructions)[](#configuring-tools) - [Configuring Tools](#configuring-tools)[](#built-in-conversation-history-cross-channel) - [Built-in Conversation History (Cross-Channel)](#built-in-conversation-history-cross-channel)[](#how-to-setup-the-ai-agent-workflow-action) - [How To Setup the AI Agent Workflow Action](#how-to-setup-the-ai-agent-workflow-action)[](#execution-logs) - [Execution Logs](#execution-logs)[](#pricing) - [Pricing](#pricing)[](#frequently-asked-questions) - [Frequently Asked Questions](#frequently-asked-questions)[](#related-articles) - [Related Articles](#related-articles) --- # **What is the AI Agent Action in Workflows?** AI Agent is a Workflow AI action that plans and executes tasks autonomously based on your instructions and the tools you make available to it. It is useful when a workflow needs flexible decision-making, dynamic tool usage, or multiple actions completed in sequence without manually building each step. For example, instead of creating separate workflow actions to find a contact, generate a booking link, format a date, and send follow-up messages, you can configure one AI Agent action to handle the full process. --- ## **Key Benefits of the AI Agent Workflow Action** - **Autonomous execution**: The agent decides which tools to use, in what order, and with what inputs based on your instructions. - **Faster workflow building**: One AI Agent action can replace multiple manually configured workflow steps for supported use cases. - **Flexible configuration**: You can build from scratch or start with a template and customize the setup. - **Downstream workflow support**: The agent can return text or JSON output for use in later workflow steps. - **Built-in visibility**: Execution Logs let you review the agent’s reasoning steps, tool usage, and token consumption. --- ## **AI Agent Action Details** These settings control how the AI Agent behaves and give you the core inputs needed to configure the action correctly. - **Action Name**: Add a custom name for the action. The default name is **AI Agent**, but renaming it based on the use case makes the workflow easier to manage. - **Template**: Choose a pre-built template to prefill the Instructions and Tools fields, or select **Build Your Own** to start from scratch. Some templates require a specific workflow trigger. - **Instructions**: Define what the agent should do, how it should make decisions, and any rules it should follow. This is the most important part of the configuration. - **Enhance Prompt**: Improves loosely written instructions by restructuring them into a more detailed and organized prompt. You can undo the enhancement if needed. - **Model**: Select the AI model that powers the agent. - **Tools**: Choose the actions the agent is allowed to execute. - **Conversation Memory:** Use a rolling summary of past runs for the same Contact on this step so the agent has context. - **Output format:** Choose how the agent formats its response. ![Step 8 of 8: Output format: Choose how the agent formats its response](https://jumpshare.com/share/szPJPYdoXAC0h1H9JM2L+/GIF+Recording+2026-04-06+at+19.25.41.gif) **Step 8 of 8: Output format: Choose how the agent formats its response** This animation accompanies step 8 of 8 in the "AI Agent Action Details" section of "Workflow Action - AI Agent". At this point in the walkthrough you output format: Choose how the agent formats its response. - What to choose: Output format: Choose how the agent formats its response. - Controls: Action Name, AI Agent, Template, Build Your Own, Instructions, Enhance Prompt, Model, Tools Full procedure: 1. Action Name: Add a custom name for the action. The default name is AI Agent, but renaming it based on the use case makes the workflow easier to manage. 2. Template: Choose a pre-built template to prefill the Instructions and Tools fields, or select Build Your Own to start from scratch. Some templates require a specific workflow trigger. 3. Instructions: Define what the agent should do, how it should make decisions, and any rules it should follow. This is the most important part of the configuration. 4. Enhance Prompt: Improves loosely written instructions by restructuring them into a more detailed and organized prompt. You can undo the enhancement if needed. 5. Model: Select the AI model that powers the agent. 6. Tools: Choose the actions the agent is allowed to execute. 7. Conversation Memory: Use a rolling summary of past runs for the same Contact on this step so the agent has context. 8. Output format: Choose how the agent formats its response. <- this image --- ## **Choosing a Model and Effort Level** Use the Model dropdown to choose the AI provider and model that best fits your task. Models are grouped by provider, including Anthropic, Google, and OpenAI. Each model includes a short description explaining what it is designed for. Models that support reasoning also display a thinking chip. For supported models, you can select Low, Medium, or High effort.  Choose a lower effort level for straightforward tasks and a higher effort level when the agent needs deeper reasoning for complex work. **Low**: Prioritizes faster responses for simpler tasks. **Medium:** Available as an effort option. **High**: Provides deeper reasoning for more complex tasks. ![Choosing a Model and Effort Level (image 2 of 16)](https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/155079026846/original/g1IyZpTHG0cXg0lJ1jDyaOD6sFwtYb_pSg.gif) **Choosing a Model and Effort Level (image 2 of 16)** This animation appears in the "Choosing a Model and Effort Level" section of "Workflow Action - AI Agent". The text alongside this image reads: High: Provides deeper reasoning for more complex tasks. Immediately after, the guide continues: Templates help you get started faster by pre-filling common instructions and tools for specific workflow scenarios. They are useful when you want a starting point that matches a known use case and then customize it for your business. - What this covers: High: Provides deeper reasoning for more complex tasks. - Controls: Low, High - Next: Templates help you get started faster by pre-filling common instructions and tools for specific workflow scenarios. They are useful when you want a starting point that matches a known use case and then customize it for your business. --- ## **Templates** Templates help you get started faster by pre-filling common instructions and tools for specific workflow scenarios. They are useful when you want a starting point that matches a known use case and then customize it for your business. Templates are pre-built agent configurations that populate the **Instructions** and **Tools** fields. If a template requires a specific trigger and that trigger is not already present, the template appears unavailable until the required trigger is added. **Available Templates Include:** - **Build Your Own:** Start from scratch with a blank agent and full control over instructions and tools - **Form Lead Follow Up:** Thank new form leads, assign ownership, create an opportunity, and send a personalized SMS and email with a booking link as the first touchpoint - **No Show Appointment Recovery:** Send a personalized SMS and email simultaneously with a fresh rebooking link as the first no-show touchpoint, without guilt-tripping or calling out the missed appointment - **Facebook Lead Nurturing:** Engage inbound Facebook leads within minutes by assigning ownership, enriching the contact, creating an opportunity, and sending SMS-first outreach with a booking link - **Stale Deal Nudge Agent:** Evaluate deal value and stage, then nudge high-value opportunities with email + SMS + owner notification + task, or standard deals with a lighter SMS and notification - **Lead Research & Enrichment:** Research new contacts and their companies via internet search, enrich CRM fields with findings, score the lead, and create an opportunity if they meet ICP criteria - **New Appointment: Enrich & Confirm:** Enrich the contact from CRM data, send a warm confirmation SMS and email, generate a pre-meeting research brief for the rep, handle opportunity creation, and flag any rep assignment mismatches - **Quiz Lead Scoring & Routing:** Read the quiz score, segment the lead as hot, warm, or cold, update their profile, and send an internal notification to the team — no messages to the contact - **Call Transcript Summary & Action Items:** Summarize the call, extract action items, log everything as a note on the contact, create tasks for the rep, and send a recap notification - **Task Creation from Won Deals:** Create fulfillment or onboarding tasks in ClickUp or Asana when opportunities are marked as won, notify the team, and update the opportunity with an onboarding flag - **Instagram / Facebook Comment-to-DM:** Send personalized DMs based on comment context to move contacts toward a booking, purchase, or next step - **Lead Pipeline Tracker:** Track leads through pipeline stages with periodic check-ins, using Conversation Memory to remember prior outreach and avoid repeating messaging # ![Templates (image 3 of 16)](https://jumpshare.com/share/LHazacjOLKM6HDeJLKVi+/Screenshot+2026-04-06+at+20.07.16.png) **Templates (image 3 of 16)** This screenshot appears in the "Templates" section of "Workflow Action - AI Agent". The text alongside this image reads: Build Your Own: Start from scratch with a blank agent and full control over instructions and tools Form Lead Follow Up: Thank new form leads, assign ownership, create an opportunity, and send a personalized SMS and email with a booking link as the first touchpoint No Show Appointment Recovery…. Immediately after, the guide continues: Strong instructions help the agent make better decisions, use tools correctly, and produce more reliable results. The clearer your guidance is, the easier it is for the agent to carry out the task as intended. - How to confirm: Build Your Own: Start from scratch with a blank agent and full control over instructions and tools Form Lead Follow Up: Thank new form leads, assign ownership, create an opportunity, and send a personalized SMS and email with a booking link as the first touchpoint No Show Appointment Recovery: Send a personalized SMS and email simultaneously with a fresh rebooking link as the first no-show touchpoint, without guilt-tripping or calling out the missed appointment Facebook Lead Nurturing: Engage inbound Facebook leads within minutes by assigning ownership, enriching the contact, creating an opportunity, and sending SMS-first outreach with a booking link Stale Deal Nudge Agent: Evaluate deal value and stage, then nudge high-value opportunities with email + SMS + owner notification + task, or standard deals with a lighter SMS and notification Lead Research & Enrichment: Research new contacts and their companies via internet search, enrich CRM fields with findings, score the lead, and create an opportunity if they meet ICP criteria New Appointment: Enrich & Confirm: Enrich the contact from CRM data, send a warm confirmation SMS and email, generate a pre-meeting research brief for the rep, handle opportunity creation, and flag any rep assignment mismatches Quiz Lead Scoring & Routing: Read the quiz score, segment the lead as hot, warm, or cold, update their profile, and send an internal notification to the team — no messages to the contact Call Transcript Summary & Action Items: Summarize the call, extract action items, log everything as a note on the contact, create tasks for the rep, and send a recap notification Task Creation from Won Deals: Create fulfillment or onboarding tasks in ClickUp or Asana when opportunities are marked as won, notify the team, and update the opportunity with an onboarding flag Instagram / Facebook Comment-to-DM: Send personalized DMs based on comment context to move contacts toward a booking, purchase, or next step Lead Pipeline Tracker: Track leads through pipeline stages with periodic check-ins, using Conversation Memory to remember prior outreach and avoid repeating messaging - Next: Strong instructions help the agent make better decisions, use tools correctly, and produce more reliable results. The clearer your guidance is, the easier it is for the agent to carry out the task as intended. --- ## **Writing Instructions** Strong instructions help the agent make better decisions, use tools correctly, and produce more reliable results. The clearer your guidance is, the easier it is for the agent to carry out the task as intended. The **Instructions** field defines what the agent does, how it reasons, and how it uses the tools you provide. You can keep instructions simple or make them more detailed depending on the complexity of the task. **Good instructions usually include:** - A role statement - Context about the available trigger data - A step-by-step workflow - Decision logic using if/then rules - Messaging guidelines - Rules or constraints for what the agent should avoid doing If you are unsure how to structure the prompt, enter your instructions in plain language and use **Enhance Prompt** to reorganize them. The editor also supports rich text formatting, including headings, bold text, bullet lists, numbered lists, code blocks, and block quotes. ![Writing Instructions (image 4 of 16)](https://jumpshare.com/share/4UnOEIvYfUvZh3nxJgH4+/GIF+Recording+2026-04-07+at+18.39.45.gif) **Writing Instructions (image 4 of 16)** This animation appears in the "Writing Instructions" section of "Workflow Action - AI Agent". The text alongside this image reads: The editor also supports rich text formatting, including headings, bold text, bullet lists, numbered lists, code blocks, and block quotes. This part of the guide covers 6 fields, listed below. Immediately after, the guide continues: Tools determine what the agent is allowed to do during execution. Giving the agent the right tools, and deciding which fields it can control, helps balance flexibility with predictability. - What this covers: The editor also supports rich text formatting, including headings, bold text, bullet lists, numbered lists, code blocks, and block quotes. - Fields: A role statement, Context about the available trigger data, A step-by-step workflow, Decision logic using if/then rules, Messaging guidelines, Rules or constraints for what the agent should avoid doing - Controls: Instructions, Enhance Prompt - Next: Tools determine what the agent is allowed to do during execution. Giving the agent the right tools, and deciding which fields it can control, helps balance flexibility with predictability. Full procedure: 1. A role statement 2. Context about the available trigger data 3. A step-by-step workflow 4. Decision logic using if/then rules 5. Messaging guidelines 6. Rules or constraints for what the agent should avoid doing --- ## **Configuring Tools** Tools determine what the agent is allowed to do during execution. Giving the agent the right tools, and deciding which fields it can control, helps balance flexibility with predictability. Click **\+ Add Tool** to open the tool picker. Tools are organized by category, and you can also search by name. Each selected tool appears in the configuration panel and can be configured individually. When configuring a tool, you can choose how field values are populated: - **Let AI decide all field values: ON**: The agent generates values for all fields at runtime based on your instructions and workflow data. - **Let AI decide all field values: OFF**: You can manually set some values yourself while allowing the agent to fill any remaining blank fields. Each field also includes its own toggle, so you can switch individual fields between AI-generated and manually configured values. ### ![Search Knowledge Base (Tool) (image 5 of 16)](https://jumpshare.com/share/Vuj5V1dr8ZpGjWxqqyfg+/GIF+Recording+2026-04-06+at+20.17.36.gif) **Search Knowledge Base (Tool) (image 5 of 16)** This animation appears in the "Search Knowledge Base (Tool)" section of "Workflow Action - AI Agent". The text alongside this image reads: Each field also includes its own toggle, so you can switch individual fields between AI-generated and manually configured values. This part of the guide covers 3 fields, listed below. Immediately after, the guide continues: Search Knowledge Base lets the AI Agent retrieve relevant business information from your native Knowledge Bases during execution. This avoids pasting large FAQ lists and business details into your Instructions. - What to choose: Each field also includes its own toggle, so you can switch individual fields between AI-generated and manually configured values. - Fields: Service details, pricing, and offerings, Booking rules, service menus, and availability, FAQs and policy information - Next: Search Knowledge Base lets the AI Agent retrieve relevant business information from your native Knowledge Bases during execution. This avoids pasting large FAQ lists and business details into your Instructions. Full procedure: 1. Service details, pricing, and offerings 2. Booking rules, service menus, and availability 3. FAQs and policy information **Search Knowledge Base (Tool)** Search Knowledge Base lets the AI Agent retrieve relevant business information from your native Knowledge Bases during execution. This avoids pasting large FAQ lists and business details into your Instructions. Common use cases include: 1. Service details, pricing, and offerings 2. Booking rules, service menus, and availability 3. FAQs and policy information #### **How to Set It Up** 1\. In the AI Agent action, click Add Tool. 2\. Select Search Knowledge Base. ![How to Set It Up (image 6 of 16)](https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/155071932326/original/oqE_fkPLZKVlNdrC5Xv47v9AfzY9mBlwKQ.png) **How to Set It Up (image 6 of 16)** This screenshot appears in the "How to Set It Up" section of "Workflow Action - AI Agent". The text alongside this image reads: 2. Select Search Knowledge Base. For context, this section explains: Dynamic query (AI decides): Let the agent generate the query based on the conversation and workflow context. Immediately after, the guide continues: 3. Choose which Knowledge Base(s) the agent can search. - What to choose: 2. Select Search Knowledge Base. - Controls: Why it Matters - Next: 3. Choose which Knowledge Base(s) the agent can search. 3\. Choose which Knowledge Base(s) the agent can search. 4\. Configure how the search query is created: **Static Query:** Provide a fixed query the tool uses each time. **Dynamic query (AI decides):** Let the agent generate the query based on the conversation and workflow context. ![How to Set It Up (image 7 of 16)](https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/155071932412/original/_3GgupQUu-CkLlja5xWa69M1P91HZuPMEA.png) **How to Set It Up (image 7 of 16)** This screenshot appears in the "How to Set It Up" section of "Workflow Action - AI Agent". The text alongside this image reads: Dynamic query (AI decides): Let the agent generate the query based on the conversation and workflow context. Immediately after, the guide continues: 5. Set the number of chunks the agent retrieves from the Knowledge Base. - What this covers: Dynamic query (AI decides): Let the agent generate the query based on the conversation and workflow context. - Controls: Why it Matters - Next: 5. Set the number of chunks the agent retrieves from the Knowledge Base. 5\. Set the number of chunks the agent retrieves from the Knowledge Base. **Why it Matters** Search Knowledge Base keeps your context window lean by pulling only the information the agent needs at runtime. This reduces token usage and helps the agent respond with more accurate, grounded answers. --- ## **Update Custom Value Tool** The **Update Custom Value** tool lets the AI Agent update custom values directly during workflow execution. This is useful when you want the agent to set or change values based on context, instead of building large If/Else branches for every possible outcome. You can use this tool for scenarios like: 1. setting business-hour messages based on the day of the week 2. updating formatted date values 3. assigning context-aware promo codes 4. storing values based on timezone, contact data, or pipeline stage **How to add the tool** 1. Open your workflow and add or edit the **AI Agent** action. 2. In the tool list, select **Update Custom Value**. 3. Configure the fields you want the agent to use. 4. Save the tool and publish the workflow. **Tool fields** **Custom Value** Choose the custom value to update. You can either: - select a specific custom value, or - use **Let AI decide** so the agent chooses which custom value to update **New Value** Set the value that should be written to the custom value. You can either: - enter a fixed value or variable, or - use **Let AI decide** so the agent generates the value from your prompt instructions If you choose a specific custom value, the tool may also show the **Current Value** so you can review the existing value before updating it. **Common setup patterns** **Specific custom value + AI-generated value** Use this when the field is fixed, but the agent should determine what to write into it. **AI-selected custom value + AI-generated value** Use this when the agent needs to decide both which field to update and what value to assign. **Why use this tool** This tool helps reduce workflow complexity by replacing large condition trees with a single AI Agent step. It is especially useful when workflows would otherwise need many branches and repeated update actions just to set custom values dynamically. --- ## **Built-in Conversation History (Cross-Channel)** AI Agent includes a built-in capability that can retrieve a contact’s past conversations across supported channels when additional messaging context is needed. The agent decides when to use this automatically, so history is fetched only when it’s relevant. **No setup required:** This is **available** **by** **default** for the AI Agent workflow action. **What the agent can retrieve:** - Channel (where each exchange occurred) - Message content - Direction (inbound vs outbound) - Timestamps - AI-generated summary (high-level context) **Channels covered** - SMS - Email - WhatsApp - Instagram - Facebook Messenger - TikTok - Other connected messaging channels. **Built-in Call Transcripts** AI Agent can automatically retrieve and reference a contact’s call transcripts when voice context is relevant. No setup required: This capability is available by default for the AI Agent workflow action. **How to use it:** Mention call transcripts in your Instructions (for example, “Use the last call transcript to identify objections and next steps.”). ![Built-in Conversation History (Cross-Channel) (image 8 of 16)](https://jumpshare.com/share/DMDVxuJ7jPlGM8mHrYiZ+/Screenshot+2026-04-15+at+11.26.15%E2%80%AFPM.png) **Built-in Conversation History (Cross-Channel) (image 8 of 16)** This screenshot appears in the "Built-in Conversation History (Cross-Channel)" section of "Workflow Action - AI Agent". The text alongside this image reads: How to use it: Mention call transcripts in your Instructions (for example, “Use the last call transcript to identify objections and next steps.”). This part of the guide covers 11 fields, listed below. Immediately after, the guide continues: A structured setup makes it easier to choose the right template, write clear instructions, and give the agent the tools it needs to complete the task successfully. - What this covers: How to use it: Mention call transcripts in your Instructions (for example, “Use the last call transcript to identify objections and next steps.”). - Fields: Channel (where each exchange occurred), Message content, Direction (inbound vs outbound), Timestamps, AI-generated summary (high-level context), SMS, Email, WhatsApp, Instagram, Facebook Messenger, TikTok - Controls: available, by, default, Channels covered, Built-in Call Transcripts - Next: A structured setup makes it easier to choose the right template, write clear instructions, and give the agent the tools it needs to complete the task successfully. Example values (illustrative, not read from the screenshot): - Email: priya.raman@northgatedental.com Full procedure: 1. Channel (where each exchange occurred) 2. Message content 3. Direction (inbound vs outbound) 4. Timestamps 5. AI-generated summary (high-level context) --- ## **How To Setup the AI Agent Workflow Action** A structured setup makes it easier to choose the right template, write clear instructions, and give the agent the tools it needs to complete the task successfully. 1. Go to **Automations** > **Workflows**. ![Step 1 of 15: Go to Automations > Workflows](https://jumpshare.com/share/0JWEsWQU9NawnWRXArkh+/Screen+Shot+2026-04-06+at+21.20.01.png) **Step 1 of 15: Go to Automations > Workflows** This screenshot accompanies step 1 of 15 in the "How To Setup the AI Agent Workflow Action" section of "Workflow Action - AI Agent". At this point in the walkthrough you go to Automations > Workflows. For context, this section explains: A structured setup makes it easier to choose the right template, write clear instructions, and give the agent the tools it needs to complete the task successfully. The navigation path used here is Automations > Workflows. The next step is to create a new workflow or edit an existing one. - Path: Automations > Workflows - Where to go: Go to Automations > Workflows. - Controls: Automations, Workflows, new, workflow, edit, existing, Add, trigger, + Add, Please select action, AI Agent, Action Name - Next: Create a new workflow or edit an existing one. Full procedure: 1. Go to Automations > Workflows. <- this image 2. Create a new workflow or edit an existing one. 3. Add a relevant trigger like Form Submitted, Contact Created, etc or you can select a pre-built template as well during the action setup. 4. Click + Add or select the Please select action placeholder in the workflow canvas. 5. Select AI Agent action from the Workflow AI section. 6. Enter an Action Name. 7. You can select Build Your Own to configure the action from scratch. 8. Add your Instructions. 9. Click Enhance Prompt if you want to improve the structure of the prompt. 10. Choose the Model you want to use. 11. Click + Add Tool and select the tools the agent can use. 12. Configure each tool, including whether AI should decide field values or whether specific values should be set manually. 13. Or you can also select a Template: Templates are pre-built agent configurations that populate the Instructions and Tools fields. If a template requires a specific trigger and that trigger is not already present, the template appears unavailable until the required trigger is added. 14. Open Advanced Options if you want to enable Conversation Memory or configure Output Format. Advanced settings give you more control over how the agent remembers prior activity and how its output can be passed into later workflow steps. 2. Create a **new** **workflow** or **edit** an **existing** one. ![Step 2 of 15: Create a new workflow or edit an existing one](https://jumpshare.com/share/BXEsCvFYK7i5WsZpbUNj+/Screen+Shot+2026-04-06+at+21.21.45.png) **Step 2 of 15: Create a new workflow or edit an existing one** This screenshot accompanies step 2 of 15 in the "How To Setup the AI Agent Workflow Action" section of "Workflow Action - AI Agent". At this point in the walkthrough you create a new workflow or edit an existing one. The navigation path used here is Automations > Workflows. The next step is to add a relevant trigger like Form Submitted, Contact Created, etc or you can select a pre-built template as well during the action setup. - Path: Automations > Workflows - What this covers: Create a new workflow or edit an existing one. - Controls: new, workflow, edit, existing, Automations, Workflows, Add, trigger, + Add, Please select action, AI Agent, Action Name - Next: Add a relevant trigger like Form Submitted, Contact Created, etc or you can select a pre-built template as well during the action setup. Full procedure: 1. Go to Automations > Workflows. 2. Create a new workflow or edit an existing one. <- this image 3. Add a relevant trigger like Form Submitted, Contact Created, etc or you can select a pre-built template as well during the action setup. 4. Click + Add or select the Please select action placeholder in the workflow canvas. 5. Select AI Agent action from the Workflow AI section. 6. Enter an Action Name. 7. You can select Build Your Own to configure the action from scratch. 8. Add your Instructions. 9. Click Enhance Prompt if you want to improve the structure of the prompt. 10. Choose the Model you want to use. 11. Click + Add Tool and select the tools the agent can use. 12. Configure each tool, including whether AI should decide field values or whether specific values should be set manually. 13. Or you can also select a Template: Templates are pre-built agent configurations that populate the Instructions and Tools fields. If a template requires a specific trigger and that trigger is not already present, the template appears unavailable until the required trigger is added. 14. Open Advanced Options if you want to enable Conversation Memory or configure Output Format. Advanced settings give you more control over how the agent remembers prior activity and how its output can be passed into later workflow steps. 3. **Add** a relevant **trigger** like Form Submitted, Contact Created, etc or you can select a pre-built template as well during the action setup. ![Step 3 of 15: Add a relevant trigger like Form Submitted, Contact Created, etc or…](https://jumpshare.com/share/7cvd7EvdDe5EzEzze4Zm+/GIF+Recording+2026-04-06+at+21.28.31.gif) **Step 3 of 15: Add a relevant trigger like Form Submitted, Contact Created, etc or…** This animation accompanies step 3 of 15 in the "How To Setup the AI Agent Workflow Action" section of "Workflow Action - AI Agent". At this point in the walkthrough you add a relevant trigger like Form Submitted, Contact Created, etc or you can select a pre-built template as well during the action setup. The navigation path used here is Automations > Workflows. The next step is to click + Add or select the Please select action placeholder in the workflow canvas. - Path: Automations > Workflows - What to choose: Add a relevant trigger like Form Submitted, Contact Created, etc or you can select a pre-built template as well during the action setup. - Controls: Add, trigger, Automations, Workflows, new, workflow, edit, existing, + Add, Please select action, AI Agent, Action Name - Next: Click + Add or select the Please select action placeholder in the workflow canvas. Full procedure: 1. Go to Automations > Workflows. 2. Create a new workflow or edit an existing one. 3. Add a relevant trigger like Form Submitted, Contact Created, etc or you can select a pre-built template as well during the action setup. <- this image 4. Click + Add or select the Please select action placeholder in the workflow canvas. 5. Select AI Agent action from the Workflow AI section. 6. Enter an Action Name. 7. You can select Build Your Own to configure the action from scratch. 8. Add your Instructions. 9. Click Enhance Prompt if you want to improve the structure of the prompt. 10. Choose the Model you want to use. 11. Click + Add Tool and select the tools the agent can use. 12. Configure each tool, including whether AI should decide field values or whether specific values should be set manually. 13. Or you can also select a Template: Templates are pre-built agent configurations that populate the Instructions and Tools fields. If a template requires a specific trigger and that trigger is not already present, the template appears unavailable until the required trigger is added. 14. Open Advanced Options if you want to enable Conversation Memory or configure Output Format. Advanced settings give you more control over how the agent remembers prior activity and how its output can be passed into later workflow steps. 4. Click **\+ Add** or select the **Please select action** placeholder in the workflow canvas. 5. Select **AI Agent** action from the Workflow AI section. 6. Enter an **Action Name**. ![Step 6 of 15: Enter an Action Name](https://jumpshare.com/share/GBYCnKxPwxf36RdroWew+/GIF+Recording+2026-04-06+at+21.30.12.gif) **Step 6 of 15: Enter an Action Name** This animation accompanies step 6 of 15 in the "How To Setup the AI Agent Workflow Action" section of "Workflow Action - AI Agent". At this point in the walkthrough you enter an Action Name. For context, this section explains: A structured setup makes it easier to choose the right template, write clear instructions, and give the agent the tools it needs to complete the task successfully. The navigation path used here is Automations > Workflows. The next step is to you can select Build Your Own to configure the action from scratch. - Path: Automations > Workflows - What to fill in: Enter an Action Name. - Controls: Action Name, Automations, Workflows, new, workflow, edit, existing, Add, trigger, + Add, Please select action, AI Agent - Next: You can select Build Your Own to configure the action from scratch. Full procedure: 1. Go to Automations > Workflows. 2. Create a new workflow or edit an existing one. 3. Add a relevant trigger like Form Submitted, Contact Created, etc or you can select a pre-built template as well during the action setup. 4. Click + Add or select the Please select action placeholder in the workflow canvas. 5. Select AI Agent action from the Workflow AI section. 6. Enter an Action Name. <- this image 7. You can select Build Your Own to configure the action from scratch. 8. Add your Instructions. 9. Click Enhance Prompt if you want to improve the structure of the prompt. 10. Choose the Model you want to use. 11. Click + Add Tool and select the tools the agent can use. 12. Configure each tool, including whether AI should decide field values or whether specific values should be set manually. 13. Or you can also select a Template: Templates are pre-built agent configurations that populate the Instructions and Tools fields. If a template requires a specific trigger and that trigger is not already present, the template appears unavailable until the required trigger is added. 14. Open Advanced Options if you want to enable Conversation Memory or configure Output Format. Advanced settings give you more control over how the agent remembers prior activity and how its output can be passed into later workflow steps. 7. You can select **Build Your Own** to configure the action from scratch. 8. Add your **Instructions**. 9. Click **Enhance Prompt** if you want to improve the structure of the prompt. 10. Choose the **Model** you want to use. 11. Click **\+ Add Tool** and select the tools the agent can use. 12. Configure each tool, including whether AI should decide field values or whether specific values should be set manually. ![Step 12 of 15: Configure each tool, including whether AI should decide field values…](https://jumpshare.com/share/rL6dUAKMPEV4IVjmBCOG+/GIF+Recording+2026-04-07+at+19.45.24.gif) **Step 12 of 15: Configure each tool, including whether AI should decide field values…** This animation accompanies step 12 of 15 in the "How To Setup the AI Agent Workflow Action" section of "Workflow Action - AI Agent". At this point in the walkthrough you configure each tool, including whether AI should decide field values or whether specific values should be set manually. The navigation path used here is Automations > Workflows. The next step is to or you can also select a Template: Templates are pre-built agent configurations that populate the Instructions and Tools fields. If a template requires a specific trigger and that trigger is not already present, the template appears unavailable until the required trigger is added. - Path: Automations > Workflows - What this covers: Configure each tool, including whether AI should decide field values or whether specific values should be set manually. - Controls: Automations, Workflows, new, workflow, edit, existing, Add, trigger, + Add, Please select action, AI Agent, Action Name - Next: Or you can also select a Template: Templates are pre-built agent configurations that populate the Instructions and Tools fields. If a template requires a specific trigger and that trigger is not already present, the template appears unavailable until the required trigger is added. Full procedure: 1. Go to Automations > Workflows. 2. Create a new workflow or edit an existing one. 3. Add a relevant trigger like Form Submitted, Contact Created, etc or you can select a pre-built template as well during the action setup. 4. Click + Add or select the Please select action placeholder in the workflow canvas. 5. Select AI Agent action from the Workflow AI section. 6. Enter an Action Name. 7. You can select Build Your Own to configure the action from scratch. 8. Add your Instructions. 9. Click Enhance Prompt if you want to improve the structure of the prompt. 10. Choose the Model you want to use. 11. Click + Add Tool and select the tools the agent can use. 12. Configure each tool, including whether AI should decide field values or whether specific values should be set manually. <- this image 13. Or you can also select a Template: Templates are pre-built agent configurations that populate the Instructions and Tools fields. If a template requires a specific trigger and that trigger is not already present, the template appears unavailable until the required trigger is added. 14. Open Advanced Options if you want to enable Conversation Memory or configure Output Format. Advanced settings give you more control over how the agent remembers prior activity and how its output can be passed into later workflow steps. 13. Or you can also select a **Template:** Templates are pre-built agent configurations that populate the **Instructions** and **Tools** fields. If a template requires a specific trigger and that trigger is not already present, the template appears unavailable until the required trigger is added. ![Step 13 of 15: Or you can also select a Template: Templates are pre-built agent…](https://jumpshare.com/share/K0Y1edlbfPxhdnRFeVYS+/GIF+Recording+2026-04-07+at+19.51.17.gif) **Step 13 of 15: Or you can also select a Template: Templates are pre-built agent…** This animation accompanies step 13 of 15 in the "How To Setup the AI Agent Workflow Action" section of "Workflow Action - AI Agent". At this point in the walkthrough you or you can also select a Template: Templates are pre-built agent configurations that populate the Instructions and Tools fields. If a template requires a specific trigger and that trigger is not already present, the template appears unavailable until the required trigger is added. The navigation path used here is Automations > Workflows. The next step is to open Advanced Options if you want to enable Conversation Memory or configure Output Format. Advanced settings give you more control over how the agent remembers prior activity and how its output can be passed into later workflow steps. - Path: Automations > Workflows - What to choose: Or you can also select a Template: Templates are pre-built agent configurations that populate the Instructions and Tools fields. If a template requires a specific trigger and that trigger is not already present, the template appears unavailable until the required trigger is added. - Controls: Instructions, Tools, Automations, Workflows, new, workflow, edit, existing, Add, trigger, + Add, Please select action - Next: Open Advanced Options if you want to enable Conversation Memory or configure Output Format. Advanced settings give you more control over how the agent remembers prior activity and how its output can be passed into later workflow steps. Full procedure: 1. Go to Automations > Workflows. 2. Create a new workflow or edit an existing one. 3. Add a relevant trigger like Form Submitted, Contact Created, etc or you can select a pre-built template as well during the action setup. 4. Click + Add or select the Please select action placeholder in the workflow canvas. 5. Select AI Agent action from the Workflow AI section. 6. Enter an Action Name. 7. You can select Build Your Own to configure the action from scratch. 8. Add your Instructions. 9. Click Enhance Prompt if you want to improve the structure of the prompt. 10. Choose the Model you want to use. 11. Click + Add Tool and select the tools the agent can use. 12. Configure each tool, including whether AI should decide field values or whether specific values should be set manually. 13. Or you can also select a Template: Templates are pre-built agent configurations that populate the Instructions and Tools fields. If a template requires a specific trigger and that trigger is not already present, the template appears unavailable until the required trigger is added. <- this image 14. Open Advanced Options if you want to enable Conversation Memory or configure Output Format. Advanced settings give you more control over how the agent remembers prior activity and how its output can be passed into later workflow steps. 14. Open **Advanced Options** if you want to enable Conversation Memory or configure Output Format. Advanced settings give you more control over how the agent remembers prior activity and how its output can be passed into later workflow steps. - **Conversation Memory:** Conversation Memory helps the agent keep continuity across repeated runs for the same contact. This is helpful for workflows where the same contact may re-enter the step and the agent should adapt based on previous interactions. This setting is off by default. When enabled, the agent uses a rolling summary of past runs for the same contact on that step. Use Conversation Memory for recurring or multi-touch workflows, such as periodic lead follow-up. For one-time workflows, such as a single form follow-up, it can usually remain off. - **Output Format:** Output Format controls whether the agent returns data that later workflow steps can use. Choosing the right output type helps when the workflow needs to reference the agent’s result after it finishes running. **Available options:** **None:** The agent performs actions but does not return structured output for downstream steps. **Text:** The agent returns a free-text response. When selected, an Output Description field appears so you can describe what the response should contain. **JSON:** The agent returns structured data based on a defined schema. You can add properties with a name, type, and optional description to make the output easier to reference later in the workflow. 15. **Save** the action. ![Step 15 of 15: Save the action](https://jumpshare.com/share/GzSHLAMZcSAIh5XoNLp7+/Screen+Shot+2026-04-07+at+19.53.43.png) **Step 15 of 15: Save the action** This screenshot accompanies step 15 of 15 in the "How To Setup the AI Agent Workflow Action" section of "Workflow Action - AI Agent". At this point in the walkthrough you save the action. For context, this section explains: A structured setup makes it easier to choose the right template, write clear instructions, and give the agent the tools it needs to complete the task successfully. The navigation path used here is Automations > Workflows. - Path: Automations > Workflows - How to confirm: Save the action. - Controls: Save, Automations, Workflows, new, workflow, edit, existing, Add, trigger, + Add, Please select action, AI Agent Full procedure: 1. Go to Automations > Workflows. 2. Create a new workflow or edit an existing one. 3. Add a relevant trigger like Form Submitted, Contact Created, etc or you can select a pre-built template as well during the action setup. 4. Click + Add or select the Please select action placeholder in the workflow canvas. 5. Select AI Agent action from the Workflow AI section. 6. Enter an Action Name. 7. You can select Build Your Own to configure the action from scratch. 8. Add your Instructions. 9. Click Enhance Prompt if you want to improve the structure of the prompt. 10. Choose the Model you want to use. 11. Click + Add Tool and select the tools the agent can use. 12. Configure each tool, including whether AI should decide field values or whether specific values should be set manually. 13. Or you can also select a Template: Templates are pre-built agent configurations that populate the Instructions and Tools fields. If a template requires a specific trigger and that trigger is not already present, the template appears unavailable until the required trigger is added. 14. Open Advanced Options if you want to enable Conversation Memory or configure Output Format. Advanced settings give you more control over how the agent remembers prior activity and how its output can be passed into later workflow steps. --- ## **Execution Logs** Execution Logs make it easier to understand what the agent did during a workflow run. They are useful for validating behavior, checking tool usage, and troubleshooting unexpected results. After the workflow runs, open the **Execution Logs** tab in the workflow builder and select an AI Agent execution to view the trace. The trace can include: 1. **Agent Input**: The full input received by the agent. 2. **LLM**: Each model call used to reason about the next step. 3. **Tool executions**: Each tool the agent called, including execution time and success or failure status. You can expand each step to review input and output data. The log view supports both a table format and raw JSON view. ![Execution Logs (image 16 of 16)](https://jumpshare.com/share/9QUweuvvPUpZZ9c21JUC+/_Umdeshfp6Wt-nH6PHIhYGP_Ws4HJVrE7w.png) **Execution Logs (image 16 of 16)** This screenshot appears in the "Execution Logs" section of "Workflow Action - AI Agent". The text alongside this image reads: You can expand each step to review input and output data. The log view supports both a table format and raw JSON view. Immediately after, the guide continues: Understanding how pricing works helps you estimate the cost of using AI Agent in production workflows, especially when different models or premium actions are involved. - What to fill in: You can expand each step to review input and output data. The log view supports both a table format and raw JSON view. - Next: Understanding how pricing works helps you estimate the cost of using AI Agent in production workflows, especially when different models or premium actions are involved. --- ## **Pricing** Understanding how pricing works helps you estimate the cost of using AI Agent in production workflows, especially when different models or premium actions are involved. The cost of each AI Agent execution is based on two components: **Note:** You can review token usage in the Execution Logs and check billing details in the account billing section. 1. **LLM token usage**: The agent may make one or more model calls during execution. Total token usage depends on instruction length, task complexity, and how many tool calls are needed. 2. **Premium action executions**: If the agent uses premium actions as tools, those executions are charged at the same per-execution rate as when they are used as standalone workflow actions. **Total cost per execution** = (total tokens consumed across all LLM calls × selected model's per-token rate) + (number of premium tool executions × their per-execution rate) Standard built-in tools such as **Send SMS**, **Update Contact Field**, and **Add Tag** do not add an extra premium action execution charge beyond normal platform usage. --- ## **Frequently Asked Questions** **Q: Is there a limit on how many tools I can add?** Yes. You can add up to 10 tools per agent. Internal tools such as Date Calculator and Math Operations do not count toward this limit. **Q: Which model should I use?** Choose a model based on the type and complexity of the task. Use the description shown under each model to understand what it is designed for. For simpler tasks, such as intent classification, simple reads, or basic operations, consider a faster model and a lower effort level when supported. For complex or multi-step tasks that require deeper reasoning, choose a reasoning-capable model and increase the effort level when needed. Model availability, token usage, and pricing can vary. Review the current model options and applicable pricing when configuring the action. **Q: Can I use the AI Agent with any trigger?** Yes. AI Agent works with any workflow trigger. Templates may recommend specific triggers because their instructions are written for that context. **Q: What does Enhance Prompt do?** Enhance Prompt restructures your instructions into a more organized and detailed prompt, including clearer steps and edge-case handling. You can undo the enhancement if needed. **Q: What context does AI Agent use when running in a workflow?** AI Agent uses your instructions, the tools you enable, and the contact/workflow data available at runtime. When messaging context is relevant, it can also retrieve the contact’s conversation history across channels. **Q: What’s the difference between Conversation Memory and Conversation History?** **Conversation Memory:** A rolling summary of prior runs of this AI Agent step for the same contact (optional). **Conversation History:** Cross-channel messaging history retrieval used when needed (available by default). **Q: When should I use the JSON output format?** Use JSON when later workflow steps need to reference specific values from the agent’s response, such as qualification results or other structured outputs. **Q: How can I see what the agent did during a workflow run?** Open the **Execution Logs** tab in the workflow builder and select the AI Agent execution to review the trace, including model calls, tool executions, inputs, outputs, and token usage. **Q: Do templates lock me into a specific configuration?** No. Templates pre-fill the Instructions and Tools fields, but you can edit the instructions, change the model, add or remove tools, and update advanced options after applying a template. **Q: When should I enable Conversation Memory?** Enable it when the same contact may go through the agent step more than once and the agent should adapt based on prior runs. For one-time workflows, it is usually not needed. **Q: When should I use Search Knowledge Base instead of adding business details to Instructions?** Use Search Knowledge Base when your business context lives in a Knowledge Base and the agent should retrieve only what it needs at runtime (for example pricing, policies, FAQs, or booking rules). This reduces prompt size and keeps responses grounded in your stored content. --- ### **Related Articles** - **[](https://docs.ghlcustomercare.com/docs/workflows/workflow-ai-workflow-actions/workflow-action-ai-decision-maker)**[](https://docs.ghlcustomercare.com/docs/workflows/workflow-ai-workflow-actions/workflow-action-ai-decision-maker)[Workflow Action - AI Decision Maker](https://docs.ghlcustomercare.com/docs/workflows/workflow-ai-workflow-actions/workflow-action-ai-decision-maker) - [Workflow Action - AI Intent Detection](https://docs.ghlcustomercare.com/docs/workflows/workflow-ai-workflow-actions/workflow-action-ai-intent-detection) - [Workflow Action - GPT Powered by OpenAI](https://docs.ghlcustomercare.com/docs/workflows/workflow-ai-workflow-actions/workflow-action-gpt-powered-by-openai) - [Workflow Actions - Conversation AI](https://docs.ghlcustomercare.com/docs/workflows/workflow-actions/workflow-actions-conversation-ai) --- Documentation for GHL Customer Care. Support: support@ghlcustomercare.com