Agents Config

This page explains how to configure AI providers for Budibase Agents.

Before building an Agent, you need at least one AI provider enabled in your Workspace settings.

For a broader AI setup walkthrough, see Quickstart: Budibase AI.

Before you start

Make sure you have:

• Access to Workspace Settings
• Credentials for your chosen model provider
• A default model selected for testing

Configure an AI provider

1. Open your Workspace Settings
2. Go to the AI Config section
3. Choose a provider and complete its setup form
4. Save and enable the configuration

Once enabled, the provider and model become available when creating or editing an Agent.

Supported providers

Budibase supports multiple model providers:

Custom provider setup

If your provider is not listed, use Connect to a custom provider.

Depending on the provider, you may need values such as:

• API base URL
• API key
• Access key and secret key
• Default model name

Use the exact values expected by your provider. Incorrect values can allow setup to save but still fail during runtime.

Validate your provider setup

Before attaching a model to an Agent:

1. Confirm the provider shows as enabled in AI Config
2. Confirm your target model name is available and correctly spelled
3. Run a simple test from an Agent with a short prompt
4. Save the successful configuration as your default team setup

Selecting models in Agents

After configuring AI Config:

1. Open Agents
2. Create a new Agent or open an existing one
3. Click Connect AI Model
4. Select the configured provider and model

For a full Agent walkthrough, see Agent building 101.

Troubleshooting

If model connection or Agent tests fail:

• Re-check API credentials and model ID
• Verify any provider-specific base URL value
• Confirm outbound internet access is allowed from your environment
• Re-run a simple prompt test after saving changes

If you are self-hosting and using Budibase AI, ensure your network allows the required outbound traffic. See Self-hosted AI features.

Related guides

• Agent building 101
• Agent instructions guide
• Agent testing guide
• Agent troubleshooting