Agent Editor

The Agent Editor is where you configure every aspect of your agent after creation. Open it by clicking on any agent card from the Agents page.

General Settings

Name

Edit the agent’s display name. This updates everywhere in the dashboard, including call logs, analytics, and the client portal.

Prompt

The core instructions that define your agent’s behavior. The prompt editor is a full-size text area where you can write and refine your agent’s instructions.

AI Prompt Suggestions — Click the sparkles icon next to the prompt editor to get AI-generated suggestions for improving your prompt. The AI analyzes your current prompt and recommends:

• Structural improvements
• Missing edge case handling
• Better phrasing for natural conversation
• Additional instructions based on the agent’s apparent use case

You can accept, modify, or dismiss each suggestion individually.

Status

Toggle the agent between Active and Inactive. Inactive agents do not receive or make calls. This is useful for temporarily pausing an agent during maintenance or prompt updates.

Client Assignment

Change or remove the client assignment. Reassigning a client moves the agent and its call history to appear under the new client’s analytics and portal view.

Voice Settings

Voice Selection

Change the voice your agent uses. The interface varies by provider:

• Retell AI — A dropdown list of voices from your Retell account. Each entry shows the voice name.
• Vapi — First select the voice engine (OpenAI, ElevenLabs, PlayHT, Deepgram, Azure, LMNT, Rime AI), then enter the voice ID for your chosen voice.
• Bland.ai — A dropdown list of voices from your Bland account.

Click the play button next to a voice to hear a preview before selecting it.

Advanced Settings

Advanced settings are provider-specific. Not all options are available for every provider.

Webhook URL

An optional URL that receives event notifications for this agent’s calls. BuildVoiceAI sends POST requests to this URL with call data (start, end, transcript updates). This is for custom integrations beyond the built-in workflow system.

Response Engine Configuration (Retell only)

Configure the underlying language model that powers the agent’s responses:

• Model — Select the LLM used for generating responses.
• Temperature — Control response randomness (0 = deterministic, 1 = creative). Default is typically 0.7.

Interruption Sensitivity

How quickly the agent stops speaking when the caller interrupts. Higher values make the agent more responsive to interruptions but may cause it to stop prematurely on background noise.

Additional Provider Settings

Depending on the provider, you may see additional options:

• End call after silence — Automatically hang up after a specified period of silence.
• Max call duration — Set a maximum call length.
• First message — The first thing the agent says when the call connects (for inbound calls).
• Language — Set the conversation language if different from English.

Phone Number

Assign or change the phone number for this agent. The dropdown shows all phone numbers synced from your voice provider that aren’t currently assigned to another agent.

• Select a number to assign it.
• Select “None” to unassign the current number.

See Phone Number Assignment for details on how assignment works.

Knowledge Base

Manage the agent’s knowledge base directly from the editor. You can:

• Create a new knowledge base
• Add sources (files, URLs, or text)
• View existing sources and their sync status
• Remove sources

See Knowledge Base for complete documentation.

Website Widget

Configure the embeddable widget for browser-based calls:

• Enable or disable the widget
• Set the primary color
• Choose the position (bottom-left or bottom-right)
• Write a greeting message
• Set a custom avatar URL

See Website Widget for details.

Saving Changes

Click Save to persist your changes. BuildVoiceAI will:

1. Update the agent record in your account.
2. Sync the changes to your voice provider via their API.
3. Show a success confirmation.

Deleting an Agent

To delete an agent, scroll to the bottom of the editor and click Delete Agent. You’ll be asked to confirm. Deleting an agent:

• Removes it from BuildVoiceAI.
• Removes it from your voice provider.
• Unassigns its phone number (the number is not deleted).
• Does not delete call history — past calls remain in your records.