Discover how your AI agent works and how it can be tailored to your specific needs.
Your AI agent has a name, description, and custom instructions for how to interact with users. These can be updated using the "Agent Update" endpoint of the API.
These represent the fundamentals of who your agent is and how they will operate when interacting with users. All of these can be updated using the "Agent Update" endpoint of the API.
| Agent Property | Type | Description |
|---|---|---|
name | string | The organization your AI agent represents. |
bot_name | string | The name of your AI agent. |
bot_description | string | A description of the purpose of your AI agent. |
bot_instructions | string | Instructions that your AI agent will use to interact with users. These can be personality, tone, things to do or not to do, etc.. |
whitelist_domains | string[] | An array of domains on which the web component can operate. |
On top of your agent's basic information above, you can define settings to help tailor how your agent works. All of these can be updated using the "Agent Setting Update" endpoint of the API.
| Setting Key | Type | Description |
|---|---|---|
aiModels | SupportedAIModel[] | See "Supported AI Models" for list of default models used. |
defaultLanguage | String | Defaults to en_US. See "Supported Locales" below. |
isPredefinedOnly | Boolean | If false, the user can freely chat with your bot, otherwise only predefined
questions can be used. |
allowVoting | Boolean | If true, users will be able to vote on links provided by your bot. |
Your AI agent can operate under a number of different locales which dictate what language they will converse in.
| Locale | Description |
|---|---|
en_US | American english. |
You can choose which AI models you want your AI agent to use when chatting with users. Some AI models are built for speed, others for increased accuracy.
| Model Key | Name | Default? | Avg Speed* | Avg Cost** |
|---|---|---|---|---|
| ANTHROPIC | ||||
anthropic/claude-sonnet-4 | Claude 4 Sonnet | - | - | - |
anthropic/claude-3.7-sonnet | Claude 3.7 Sonnet | - | - | - |
google/gemini-2.5-pro | Gemini 2.5 Pro | - | 13-20¢ | |
google/gemini-2.5-flash | Gemini 2.5 Flash | ✅ | - | 1-4¢ |
| META | ||||
meta-llama/llama-4-maverick | Llama 4 Maverick | ✅ | - | <1-4¢ |
| OPEN AI | ||||
openai/gpt-5-chat | GPT-5 Chat | - | - | - |
openai/gpt-5-mini | GPT-5 Mini | - | - | - |
openai/gpt-4.1 | GPT 4.1 | - | - | - |
openai/o4-mini | o4 Mini | ✅ | - | 6-10¢ |
| X-AI | ||||
x-ai/grok-4 | Grok 4 | - | - | - |
* Average speed only considers the roundtrip time to make an AI request and does not take into account
modules or actions, which will increase these times, sometimes significantly.
** Listed costs are estimates and will change depending on a number of factors.