Skip to main content
Settings is where you configure the infrastructure your agents depend on. Before creating your first agent, configure at least one model here. Think of Settings as the toolbox. Agents are built from the tools in the box. You define the tools once, and any agent in the workspace can use them.

​
The settings sections

Models Registry

Register LLM providers and their API credentials. Every agent needs a model.

MCP Servers

Connect external tools — APIs, databases, and services agents can call.

Sentinels

Define safety and pre-processing agents that intercept requests before your main agent runs.
Embeddings for the Knowledge Base are managed automatically by the Alquimia runtime — there is no embeddings model to configure here.
  1. Models — required to create any agent
  2. MCP Servers — required if you want agents to use external tools
  3. Sentinels — optional, for safety and moderation workflows
All settings are scoped to the active workspace. If you switch to a different workspace, you’ll start with an empty settings configuration for that workspace.

​
Bootstrap from Docker Compose

Cloud models are not pre-filled from .env—add them in Settings → Models Registry. If you use the with-local-models profile and set OLLAMA_MODELS in .env, studio-init can register those Ollama models for you; still confirm they appear under Models before you create an agent.