create_agent
Creates a new AI voice agent for your organization with configurable language, voice, and model settings. Returns the agent ID for further configuration.
Instructions
Create a new AI agent in your organization. The agent is created as a single_prompt agent with gpt-4.1 model and daniel voice (waves_lightning_v3_1) by default. Returns the created agent's ID. Set the agent prompt via update_agent_prompt after creation.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | No | Name for the new agent | |
| description | No | Short description of what the agent does | |
| language | No | Language configuration. Defaults to English. | |
| synthesizer | No | Voice synthesizer configuration | |
| slm_model | No | LLM model for the agent. Defaults to gpt-4.1. | |
| global_prompt | No | Global system prompt for the agent (max 4000 chars). For the main prompt, use update_agent_prompt after creation. | |
| first_message | No | First message the agent says when a call starts (max 500 chars) | |
| default_variables | No | Default template variables for the agent prompt (e.g. { company_name: 'Acme' }) | |
| knowledge_base_id | No | Knowledge base ID to attach to the agent | |
| allow_inbound_call | No | Whether to allow inbound calls (default true) | |
| allow_interruptions | No | Whether to allow user interruptions (default true) | |
| wait_for_user_to_speak_first | No | Wait for user to speak before agent starts (default false) | |
| smart_turn_config | No | Smart turn detection configuration | |
| voicemail_detection | No | Voicemail detection configuration | |
| background_sound | No | Background sound during calls | |
| pronunciation_dicts | No | Custom pronunciation dictionary | |
| enable_style_guide | No | Enable conversational style guide (default true) |