Skip to main content
You can disable creating or updating classic agents and assistants on an Azure OpenAI account by setting the MS-AOAI-Feature-Assistants tag to Disabled. This tag opts the account out of the Assistants API surface while leaving other model and inference features unchanged.

​
Prerequisites

  • The Azure CLI installed.
  • You’re signed in to Azure with az login.
  • Owner or Contributor access on the target subscription or resource group.

​
Disable assistants and classic agents

To disable creation, set the MS-AOAI-Feature-Assistants tag to Disabled on the Azure OpenAI account. 
    # CLI — single account
    az resource tag --tags MS-AOAI-Feature-Assistants=Disabled \
        --ids /subscriptions/<sub>/resourceGroups/<rg>/providers/Microsoft.CognitiveServices/accounts/<account>

​
Re-enable assistants and classic agents

To re-enable creation, set the same tag to Enabled. 
    # CLI — single account
    az resource tag --tags MS-AOAI-Feature-Assistants=Enabled \
        --ids /subscriptions/<sub>/resourceGroups/<rg>/providers/Microsoft.CognitiveServices/accounts/<account>

​
What gets disabled

When the tag is set to Disabled, the following Assistants API operations are blocked on the account:
  • Create assistant
  • Update assistant
  • Create agent
  • Update agent
  • Create thread
  • Create run
  • Create thread and run
  • Create assistant file
Existing assistants, threads, and files remain in place, but they can’t be modified and no new ones can be created until the tag is set back to Enabled.

​
Related content