Help center

AI Agents

Setting up the Global AI Key

How to configure a workspace-level AI provider key for all pre-built antbase agents, including OpenAI, Anthropic, Google, Groq, Deepseek, Z.ai, and Perplexity.


The Global AI Key is a workspace-level API key that all pre-built antbase agents use automatically. You configure it once and every agent picks it up — no need to set a key on each agent individually. Custom agents can still override it with their own key.

Setting up your Global AI Key

  1. Go to Workspace Settings → AI.
  2. Click the Global AI Key section to expand it.
  3. Choose your Provider from the dropdown.
  4. Paste your API key into the key field.
  5. Click Test to verify the key works, then click Save.

Supported providers and where to get your API key

Provider Models Where to get your key
OpenAI GPT-4o, GPT-4.1, GPT-4o mini platform.openai.com/api-keys
Anthropic Claude 4 Opus, Claude 4 Sonnet, Claude Haiku console.anthropic.com/settings/keys
Google Gemini 2.5 Pro, Gemini 2.5 Flash aistudio.google.com/apikey
Groq Llama 4 Scout, Llama 4 Maverick, Mixtral console.groq.com/keys
Deepseek DeepSeek V3, DeepSeek R1 platform.deepseek.com/api_keys
Z.ai (GLM) GLM-4, GLM-4V open.bigmodel.cn/usercenter/apikeys
Perplexity Sonar, Sonar Pro perplexity.ai/settings/api

Tips

  • Only Admins can view or change the Global AI Key.
  • The key is stored encrypted and is never shown in full after saving.
  • If you want an agent to use a different provider, configure its own key inside the agent settings — the per-agent key always takes priority over the Global AI Key.
  • Use the Test button before saving to catch typos or expired keys early.

Was this helpful?