Prerequisites
Enable the feature
Setenable_agents to true. It’s false by default, which hides the agents UI and API for everyone.
- YAML
- Environment variable
Connect a model
A model connection tells Console which provider to call, with which key and which model. Add one or more undermodels. Each needs an id and an api_key; everything else has a default.
- YAML
- Environment variables
Connections are read-only in Console. The Models page and the model picker list them by name, and never show the key. To change a connection, update the configuration and restart Console.
Check the setup
Restart Console and sign in as an administrator. Use the toggle at the top of the sidebar to switch from Console to Agentic: the agents home page opens. If the toggle isn’t there,enable_agents isn’t set on the running instance.
Then go to Models. It lists your connections by name, provider and model, without the key. If a connection is missing, Console didn’t load that part of the models configuration: check the Console logs for a configuration error, such as a missing api_key or a duplicate id.
You’re ready to create and run your first agent.