Each workspace has its own copy of these settings. They appear in Settings, grouped under the headings below. Reading or changing them requires settings.manage. For how to use the page, see Workspace settings.
Secret settings are encrypted before they’re stored and can’t be read back after saving. Their value shows as Configured (not viewable).
| Key |
What it’s for |
Default |
Secret |
GOOGLE_API_KEY |
Google Gemini models, and Google embeddings for knowledge bases |
|
Yes |
OPENAI_API_KEY |
OpenAI models, and OpenAI embeddings |
|
Yes |
ANTHROPIC_API_KEY |
Anthropic Claude models |
|
Yes |
OPENCODE_API_KEY |
Models offered through OpenCode Go |
|
Yes |
VERTEX_AI_SERVICE_ACCOUNT_JSON |
A Google Cloud service account for running Claude and Gemini through Vertex AI in your own project |
|
Yes |
VERTEX_AI_PROJECT_ID |
The Google Cloud project for Vertex AI. Read from the service account if blank. |
|
|
VERTEX_AI_LOCATION |
The Vertex AI region, for example us-central1 or europe-west4 |
us-central1 |
|
EMBEDDING_PROVIDER |
Who builds the knowledge base search index: google (API key), vertex (service account) or openai |
google |
|
EMBEDDING_MODEL |
The embedding model. It must belong to the provider above. |
text-embedding-004 |
|
| Key |
What it’s for |
Default |
Secret |
TWILIO_ACCOUNT_SID |
Your Twilio account, for WhatsApp |
|
|
TWILIO_AUTH_TOKEN |
Your Twilio auth token, for WhatsApp |
|
Yes |
GOOGLE_CHAT_SERVICE_ACCOUNT_JSON |
The service account your Google Chat app uses |
|
Yes |
GOOGLE_CHAT_PROJECT_NUMBER |
The number of the Google Cloud project where your Chat app is configured. Google Chat requests are verified against it. Filled in automatically when you save the service account JSON, if the service account can read its project (for example with roles/browser); otherwise type it. See Google Chat. |
|
|
GOOGLE_CHAT_WAITING_MESSAGE |
Text shown in Google Chat while the agent works |
A Spanish “this may take a few minutes” message |
|
GOOGLE_CHAT_WAITING_IMAGE_URL |
An image or GIF shown with the waiting message |
|
|
CLOUD_RUN_SERVICE_ACCOUNT_JSON |
A service account that custom tools use to call Cloud Run services protected by IAM |
|
Yes |
INTEGRATION_KEYS_ENFORCED |
Require an integration key on voice connections. WhatsApp, Google Chat, Slack and Telegram are verified by their platform instead. Change it with the Key Enforcement toggle in Integrations. See Integration keys. |
true |
|
TRANSCRIPTION_MODEL |
The Google Cloud Speech-to-Text model for voice messages: latest_long, latest_short or chirp_2 |
latest_long |
|
TRANSCRIPTION_LANGUAGE_CODES |
Languages to transcribe, comma-separated |
es-ES,en-US |
|
E2B_API_KEY |
E2B, for running code in a sandbox from agents |
|
Yes |
E2B_DOMAIN |
A self-hosted E2B domain. Leave blank for e2b.dev. |
|
|
| Key |
What it’s for |
Default |
Secret |
WORKSPACE_TIMEZONE |
The workspace’s timezone, as an IANA name such as America/Mexico_City |
UTC |
|
SYSTEM_NAME |
A display name for the system. Not used by agents at the moment. |
|
|
DEFAULT_LANGUAGE |
A default language. Not used by agents at the moment. |
english |
|
| Key |
What it’s for |
Default |
Secret |
LANGCHAIN_API_KEY |
Your LangSmith key. With it set, agent runs are traced to your LangSmith account. |
|
Yes |
LANGCHAIN_ENDPOINT |
The LangSmith API endpoint |
https://api.smith.langchain.com |
|
LANGCHAIN_PROJECT |
The LangSmith project traces go to |
default |
|
LANGSMITH_WORKSPACE_ID |
A LangSmith workspace ID. Not used at the moment. |
|
|
| Key |
What it’s for |
Default |
Secret |
conversations.retention_days |
How many days conversation history is kept in Conversations, from 1 to 3,650 |
365 |
|
OAuth apps that let agents connect to MCP servers on behalf of a user. Redirect URIs for GitHub, Slack and HubSpot are derived from your VirtuAI address.
| Key |
What it’s for |
Secret |
GOOGLE_MCP_CLIENT_ID |
OAuth client ID for Google Workspace MCP servers (Web application type) |
|
GOOGLE_MCP_CLIENT_SECRET |
Its client secret |
Yes |
GOOGLE_MCP_REDIRECT_URI |
The redirect URI registered for that client, for example https://app.imvirtuai.com/api/oauth/google/callback |
|
GITHUB_MCP_CLIENT_ID |
GitHub OAuth app client ID |
|
GITHUB_MCP_CLIENT_SECRET |
Its client secret |
Yes |
SLACK_MCP_CLIENT_ID |
Slack app client ID |
|
SLACK_MCP_CLIENT_SECRET |
Its client secret |
Yes |
HUBSPOT_MCP_CLIENT_ID |
HubSpot app client ID |
|
HUBSPOT_MCP_CLIENT_SECRET |
Its client secret |
Yes |
| Key |
What it’s for |
Default |
EVAL_JUDGE_PROVIDER |
The provider of the model that grades evaluation answers, such as gemini, openai or anthropic |
|
EVAL_JUDGE_MODEL |
The judge model. Without it, cases that need a judge are reported as unscored, not failed. |
|
EVAL_ONLINE_ENABLED |
Score a sample of real web chat conversations on a schedule. It spends tokens without anyone starting a run. Sampling also has to be running on your deployment; check with support before relying on it. |
false |
EVAL_ONLINE_SAMPLE_PERCENT |
Share of recent conversations scored each run, 0 to 100 |
5 |
EVAL_ONLINE_DAILY_CAP |
The most conversations scored per day |
50 |
EVAL_ONLINE_SCORERS |
Scorers for sampled traffic, comma-separated: groundedness, rubric, tone_policy, no_error |
groundedness |
Shown as color pickers, not as keys.
| Key |
Label |
Default |
WEB_CHAT_BUTTON_COLOR |
Button Color |
#4f46e5 |
WEB_CHAT_USER_BUBBLE_COLOR |
User Bubble Color |
#6366f1 |
WEB_CHAT_AVATAR_BG_COLOR |
Avatar Background Color |
#4f46e5 |
WEB_CHAT_ACCENT_COLOR |
Accent Color |
#6366f1 |
These are workspace settings too, but you don’t edit them in the lists above.
| Key |
Where it’s set |
TWILIO_WHATSAPP_NUMBER |
Chosen under Telephony > Messaging |
conversations.sensitive_rules |
Which sensitive data categories are detected. No screen yet; see Sensitive data. |
