conversation_ai_update_agent
Idempotent
Update a GoHighLevel Conversations AI agent by modifying its goal, mode, channels, wait time, and sleep settings to refine automated interactions.
Instructions
Update Agent
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| goal | No | The goal of the agent. | |
| mode | No | Mode of operation for the agent, required if primary is enabled. | |
| name | No | Name of the agent. | |
| agentId | Yes | Conversations AI agent id | |
| channels | No | Channels the agent can use. | |
| waitTime | No | Wait time before agent responds (max 5 for minutes, 300 for seconds). | |
| isPrimary | No | Indicates if this agent is a primary agent. | |
| sleepTime | No | Duration of sleep period (required if sleepEnabled is true). Set to null for indefinite sleep. (max 2880 for minutes, 172800 for seconds, 48 for hours) | |
| personality | No | Personality traits of the agent. | |
| businessName | No | Name of the business the agent represents. | |
| instructions | No | Instructions for the agent. | |
| sleepEnabled | No | Indicates if sleep functionality is enabled. | |
| waitTimeUnit | No | Unit for wait time - SECONDS or MINUTES | |
| sleepTimeUnit | No | Unit of sleep time - HOURS, MINUTES, or SECONDS (required if sleepEnabled is true). Set to null for indefinite sleep. | |
| respondToAudio | No | Allow agent to respond to audio | |
| respondToImages | No | Allow agent to respond to images | |
| knowledgeBaseIds | No | Array of knowledge base IDs associated with this agent. | |
| autoPilotMaxMessages | Yes | Maximum number of messages in auto-pilot mode before requiring human intervention. (max: 100, min: 1) | |
| sleepOnManualMessage | No | Enable sleep when a manual outbound message is sent. | |
| sleepOnWorkflowMessage | No | Enable sleep when a workflow outbound message is sent. |