microsoft/autogen · error · Error

Failed to update gallery

Error message

Failed to update gallery

What it means

Raised in the tool constructor when `azure-search-documents` (checked via the module-level `has_azure_search` import guard) is unavailable. The Azure AI Search tool is an optional extra of autogen-ext; constructing it without the SDK fails immediately with install instructions.

Source

Thrown at python/packages/autogen-studio/frontend/src/components/views/gallery/api.ts:73

    galleryData: Partial<Gallery>,
    userId: string
  ): Promise<Gallery> {
    const gallery = {
      ...galleryData,
      user_id: userId,
    };

    const response = await fetch(
      `${this.getBaseUrl()}/gallery/${galleryId}?user_id=${userId}`,
      {
        method: "PUT",
        headers: this.getHeaders(),
        body: JSON.stringify(gallery),
      }
    );
    const data = await response.json();
    if (!data.status)
      throw new Error(data.message || "Failed to update gallery");
    return data.data;
  }

  async deleteGallery(galleryId: number, userId: string): Promise<void> {
    const response = await fetch(
      `${this.getBaseUrl()}/gallery/${galleryId}?user_id=${userId}`,
      {
        method: "DELETE",
        headers: this.getHeaders(),
      }
    );
    const data = await response.json();
    if (!data.status)
      throw new Error(data.message || "Failed to delete gallery");
  }

  async syncGallery(url: string): Promise<Gallery> {
    const response = await fetch(url);

View on GitHub (pinned to 027ecf0a37)

Solutions

1. Install the SDK: `pip install azure-search-documents>=11.4.0` (or `uv add "azure-search-documents>=11.4.0"`).
2. Better, install via the extra: `pip install "autogen-ext[azure]"` so the right dependencies travel with the package.
3. Verify in the runtime env: `python -c "import azure.search.documents; print(azure.search.documents.__version__)"`.

Example fix

# before: ImportError on AzureAISearchTool(...)
# after
# shell:
#   pip install "autogen-ext[azure]"
#   # or: pip install "azure-search-documents>=11.4.0"

def azure_search_sdk_available() -> bool:
    try:
        import azure.search.documents  # noqa: F401
        return True
    except ImportError:
        return False

assert azure_search_sdk_available(), "pip install 'autogen-ext[azure]'"

try:
    tool = AzureAISearchTool(...)
except ImportError as e:
    raise SystemExit("Install azure-search-documents>=11.4.0 or autogen-ext[azure]") from e

When it happens

Trigger: Instantiating AzureAISearchTool (or any BaseAzureAISearchTool subclass) in an environment where `import azure.search.documents` failed at module import time — the class is importable but unusable.

Common situations: Installing autogen-ext without the [azure] extra; a different virtualenv at runtime than at dev time; a dependency conflict downgrading/removing azure-search-documents; version <11.4.0 missing required APIs.

Related errors

• Failed to get login URL
• Authentication failed
• Unauthorized
• Failed to fetch galleries
• Failed to delete gallery

AI-assisted analysis of microsoft/autogen@027ecf0a37 (2026-08-15). Data as JSON: /api/errors/b989cc329af4891f. Report an issue: GitHub.