Skip to main content
POST
/
simulate
/
simulator-agents
/
create
/
Create simulator agent
curl --request POST \
  --url https://api.futureagi.com/simulate/simulator-agents/create/ \
  --header 'Content-Type: application/json' \
  --header 'X-Api-Key: <api-key>' \
  --header 'X-Secret-Key: <api-key>' \
  --data '{
  "name": "Customer Support Bot",
  "model": "gpt-4"
}'

Authorizations

​
X-Api-Key
string
header
required

API Key for authentication. Click here to access API Key

​
X-Secret-Key
string
header
required

Secret Key for authentication. Click here to access Secret Key

Body

application/json
​
name
string
required

Agent name

Example:

"Customer Support Bot"

​
model
string
required

LLM model to use

Example:

"gpt-4"

​
prompt
string

System prompt for the agent

​
voice_provider
string
default:elevenlabs

Voice provider (e.g., elevenlabs, google)

​
voice_name
string
default:marissa

Voice name/ID

​
llm_temperature
number
default:0.7

LLM temperature (0-2)

​
max_call_duration_in_minutes
integer
default:30

Maximum call duration

​
interrupt_sensitivity
number
default:0.5

Interrupt sensitivity (0-1)

​
conversation_speed
number
default:1

Conversation speed multiplier

​
finished_speaking_sensitivity
number
default:0.5

Sensitivity for detecting end of speech

​
initial_message
string

Initial greeting message

​
initial_message_delay
integer
default:0

Delay before sending initial message (ms)

Response

201

Simulator agent created