Databricks: Unable to Create Supervisor Agent Despite Enabling Supervisor API (Beta) — Feature Reports Unavailable

Veera-3402 0 Reputation points
2026-10-03T04:17:52.0133333+00:00

Problem description

I am trying to create and save a Supervisor Agent in my Azure Databricks workspace after enabling the Supervisor API (Beta). However, when I attempt to save the agent, I receive an error message stating: "Failed to save agent. Supervisor Agent is not available. To access this feature, please contact sales for assistance." Despite confirming that the Supervisor API (Beta) is enabled and showing as effective in the workspace settings, the save operation continues to fail with the same message.

Environment

The affected environment is an Azure Databricks workspace in East US, with Unity Catalog and serverless features enabled. The Supervisor API (Beta) is enabled and shows as effective. No additional workspace configuration, identity model, or entitlement details are documented.

What I've already tried

I confirmed that the workspace is in East US, Unity Catalog is enabled, and the Supervisor API (Beta) is active and effective. I also verified that agent-related preview features are enabled in the workspace. I attempted to create and save the Supervisor Agent multiple times after enabling the feature, but the operation still results in the same error. Additionally, I checked Azure diagnostics for platform issues and the Activity Log for workspace-specific issues, but no relevant problems were identified. I have not tried any other troubleshooting steps beyond these checks.

Current status

The issue persists despite verifying the workspace configuration and enabling the preview feature. I am seeking guidance on further validation steps to determine if the Supervisor Agent capability is available for my workspace or if there are account-level or region-specific rollout considerations. I would appreciate assistance in identifying the root cause and resolving the issue.

Azure Databricks
Azure Databricks

An Apache Spark-based analytics platform optimized for Azure.


1 answer

Sort by: Most helpful
  1. SIVASANKAR YEDDULA 250 Reputation points Microsoft External Staff Moderator
    2026-10-03T06:42:21.6+00:00

    Hi @Veera-3402 ,

    Thank you for contacting Microsoft Support Q&A. My name is Siva, and I will be assisting you with this support request.

    Thank you for providing the detailed information regarding the Azure Databricks Supervisor Agent issue.

    I understand that the Supervisor API (Beta) is shown as enabled/effective in your East US workspace, Unity Catalog and serverless capabilities are enabled, but attempting to save a Supervisor Agent returns:

    “Failed to save agent. Supervisor Agent is not available. To access this feature, please contact sales for assistance.”
    Technical Assessment

    Based on the current Azure Databricks documentation, there is an important distinction between the Supervisor API and Agent Bricks Supervisor Agent.

    The Supervisor API has been deprecated and reached end of life on September 30, 2026. Therefore, enabling the Supervisor API preview should not be considered confirmation that Supervisor Agent creation is enabled for the workspace.

    Supervisor Agent is a separate Beta capability. Access to Beta functionality can be controlled at the Databricks account/preview level.

    Since you have already confirmed the standard workspace configuration and the operation reaches Supervisor Agent creation but returns an explicit “feature not available/contact sales” message, I do not recommend repeatedly enabling/disabling the Supervisor API or making unrelated Unity Catalog/serverless configuration changes.
    Recommended Next Steps

    Please perform the following validation:

    Have an Azure Databricks account administrator review the available previews and confirm that the Supervisor Agent Beta capability is available/enabled for the affected account/workspace.

    If Supervisor Agent is already enabled but the Save operation continues to return the same error, please provide:

    • Azure Databricks Workspace ID
      • Databricks Account ID
        • Exact failed-attempt timestamp in UTC
          • Screenshot of the complete error
            • Request/correlation ID, if one is exposed by the failed request
            The next investigation should validate the effective Supervisor Agent availability/eligibility for the account and workspace. In particular, we need to determine whether additional account-level enablement or rollout eligibility applies to this environment.

    At this stage, I do not want to attribute the failure to East US, Unity Catalog, serverless configuration, permissions, or another workspace setting without supporting service-side evidence.
    Supervisor API Clarification

    If your objective is to develop a custom programmatic agent using the Supervisor API, please note that the Supervisor API reached end of life on September 30, 2026. Azure Databricks now recommends custom agents on Databricks Apps instead.

    If your requirement is specifically the Agent Bricks Supervisor Agent experience, we should continue by validating the Supervisor Agent Beta availability for the affected Databricks account/workspace.

    Root Cause Status: Under Investigation

    The currently available evidence indicates that further account/workspace feature-availability validation is required before we can establish the final cause.
    Refer: -

    https://learn.microsoft.com/en-us/azure/databricks/agents/agent-bricks/multi-agent-supervisor

    Was this answer helpful?


Your answer

Answers can be marked as 'Accepted' by the question author and 'Recommended' by moderators, which helps users know the answer solved the author's problem.