Databricks Knowledge Assistant and Supervisor Agent are legacy: what replaces them
In October 2026 Databricks marked Knowledge Assistant, Supervisor Agent, AI Playground, legacy agent memory and agents on Model Serving as legacy. The no-code path is now Genie Agents; the code path is the Agent Bricks CLI, which scaffolds a LangGraph or OpenAI Agents SDK project, runs it locally and deploys it to the agent runtime. The full old-to-new map and the first 5 commands.
Tecyfy · Published · 7 min read

On 12 October 2026 Databricks marked Knowledge Assistant and Supervisor Agent as legacy, along with AI Playground, the old agent memory options and agents served from Model Serving. Each now has a successor. The no-code path is Genie Agents. The code path is the Agent Bricks CLI, which scaffolds an agent in LangGraph or the OpenAI Agents SDK, runs it on your laptop and deploys it to Databricks' agent runtime.
Legacy does not mean switched off. Databricks' page lists no end date and keeps the documentation "so that you can maintain and migrate existing agents". It does mean new agents should not start on the old products, and existing ones should get a migration plan before they get new features.
Find your replacement
Pick what your current agent does and see where it goes and the first command:
Legacy
Now
- Genie AgentsNo code
- Agent Bricks CLICode
- AI FunctionsSQL
- Agent memory and sessionsCode
- Query models, agentbricks devTesting
Knowledge Assistant → Genie Agents. A question-answering agent over documents and tables usually fits a Genie Agent with no code.
From Databricks' legacy agent features page and the Agent Bricks CLI docs. Legacy features keep working; Databricks lists no end date. The CLI is in Beta, so pin its version.
The full map
| Legacy | Replacement |
|---|---|
| Knowledge Assistant | Genie Agents |
| Supervisor Agent | Genie Agents; in code, the Agent Bricks CLI |
| Supervisor API (deprecated) | Your own agent loop, deployed with the Agent Bricks CLI |
| Custom multi-agent system | Agent Bricks CLI, with Genie Agents as tools |
| Agents on Databricks Apps (legacy agent server) | Agent Bricks CLI with DurableAgentServer on Agent Runtime |
| Chat front-end template | Agent Bricks CLI projects, which include a chat UI |
| Custom agent on Model Serving | Agent Bricks CLI |
| "Create a custom LLM agent" | AI Functions such as ai_query |
| Managed memory stores, Lakebase memory | Agent memory and agent sessions |
| AI Playground | Query models directly; test agents with agentbricks dev |
2 patterns run through it. Anything that was a pre-built agent configured in screens becomes a Genie Agent. Anything that was code becomes a CLI project with a standard server, local runs and a deploy command. Databricks names that server DurableAgentServer and the place it runs Agent Runtime.
The first 5 commands
The CLI needs Python 3.10 or newer and the Databricks CLI.
pip install databricks-agentbricks
databricks auth login --host https://<your-workspace-url> --profile dev
agentbricks login --profile dev
agentbricks init --framework langgraph my-agent
cd my-agent
agentbricks dev # runs the agent at http://localhost:8000
agentbricks deploy my-agent # deploys it to the agent runtime
Use --framework openai for the OpenAI Agents SDK instead of LangGraph. 2 more commands replace the legacy memory options by attaching Databricks-managed stores:
agentbricks sessions bind my-agent-sessions
agentbricks memory bind my-agent-memory
And a Genie Agent your analysts already built can become a tool of the coded agent:
agentbricks tools add genie-agent
That last command is how a Supervisor Agent's job moves to code: the supervisor's routing becomes your agent's loop, and each Genie Agent it called becomes a tool.
Migrating an existing agent
- List what you run. Note each Knowledge Assistant and Supervisor Agent, its sources, who uses it and how they reach it.
- Rebuild the simple ones as Genie Agents. A question-answering agent over documents and tables usually fits without code.
- Move the coded ones to a CLI project. Copy the agent's logic into the scaffold, run
agentbricks dev, and test the same questions against both versions. - Move memory last. Bind agent memory and sessions, then check that a returning user's context carries over.
- Switch users, then retire the old one. Keep it until the new agent has handled a normal week.
The CLI is in Beta, so pin its version in your project and read the release notes before upgrading. Databricks has renamed most of its products in the past year, so the old and new names in your notes may not match the current docs; every Databricks rename lists them. For the design of the agent itself, our AI agents subject follows one request through an AgentAgentA model that uses tools in a loop, deciding each next step from what the last one returned, until the task is done. step by step, and LangChain vs LangGraph explains the framework the CLI scaffolds by default.
Questions
- Is Databricks Knowledge Assistant deprecated?
- Databricks marked Knowledge Assistant and Supervisor Agent as legacy on 12 October 2026. Legacy means they are no longer best practice for new agents; their documentation stays so existing agents can be maintained and migrated. Databricks has not published an end-of-support date on the legacy page.
- What replaces Databricks Knowledge Assistant?
- Genie Agents, the low-code agents over documents and data. For an agent written in code, Databricks recommends the Agent Bricks CLI, which can add a Genie Agent as a tool with agentbricks tools add genie-agent.
- What is the Agent Bricks CLI?
- A command-line tool, in Beta, for building agents in code on Databricks. pip install databricks-agentbricks installs it; agentbricks init --framework langgraph my-agent scaffolds a project, agentbricks dev runs it locally on port 8000, and agentbricks deploy my-agent deploys it to the Databricks agent runtime. It supports LangGraph and the OpenAI Agents SDK.
- Do I have to migrate my Supervisor Agent now?
- Not immediately: the legacy page does not give an end date and says the documentation remains so you can maintain and migrate existing agents. Build new agents on the recommended path now, and plan the move for existing ones before you add features to them.
Sources