{"record":{"id":"9e691105b5a48d38","repo":"microsoft/autogen","slug":"azure-search-sdk-is-required-but-not-installed-pl","errorCode":null,"errorMessage":"Azure Search SDK is required but not installed. Please install it with: pip install azure-search-documents>=11.4.0","messagePattern":"Azure Search SDK is required but not installed\\. Please install it with: pip install azure-search-documents>=11\\.4\\.0","errorType":"exception","errorClass":"ImportError","httpStatus":null,"severity":"error","filePath":"python/packages/autogen-ext/src/autogen_ext/tools/azure/_ai_search.py","lineNumber":285,"sourceCode":"            description (Optional[str]): Optional description explaining the tool's purpose\n            api_version (Optional[str]): Azure AI Search API version to use\n            query_type (Literal[\"simple\", \"full\", \"semantic\", \"vector\"]): Type of search to perform\n            search_fields (Optional[List[str]]): Fields to search within documents\n            select_fields (Optional[List[str]]): Fields to return in search results\n            vector_fields (Optional[List[str]]): Fields to use for vector search\n            top (Optional[int]): Maximum number of results to return\n            filter (Optional[str]): OData filter expression to refine search results\n            semantic_config_name (Optional[str]): Semantic configuration name for enhanced results\n            enable_caching (bool): Whether to cache search results\n            cache_ttl_seconds (int): How long to cache results in seconds\n            embedding_provider (Optional[str]): Name of embedding provider for client-side embeddings\n            embedding_model (Optional[str]): Model name for client-side embeddings\n            openai_api_key (Optional[str]): API key for OpenAI/Azure OpenAI embeddings\n            openai_api_version (Optional[str]): API version for Azure OpenAI embeddings\n            openai_endpoint (Optional[str]): Endpoint URL for Azure OpenAI embeddings\n        \"\"\"\n        if not has_azure_search:\n            raise ImportError(\n                \"Azure Search SDK is required but not installed. \"\n                \"Please install it with: pip install azure-search-documents>=11.4.0\"\n            )\n\n        if description is None:\n            description = (\n                f\"Search for information in the {index_name} index using Azure AI Search. \"\n                f\"Supports full-text search with optional filters and semantic capabilities.\"\n            )\n\n        super().__init__(\n            args_type=SearchQuery,\n            return_type=SearchResults,\n            name=name,\n            description=description,\n        )\n\n        processed_credential = self._process_credential(credential)","sourceCodeStart":267,"sourceCodeEnd":303,"githubUrl":"https://github.com/microsoft/autogen/blob/027ecf0a379bcc1d09956d46d12d44a3ad9cee14/python/packages/autogen-ext/src/autogen_ext/tools/azure/_ai_search.py#L267-L303","documentation":"Error \"Azure Search SDK is required but not installed. Please install it with: pip install azure-search-documents>=11.4.0\" thrown in microsoft/autogen.","triggerScenarios":"Thrown at python/packages/autogen-ext/src/autogen_ext/tools/azure/_ai_search.py:285 when the library encounters an invalid state.","commonSituations":"See trigger scenarios.","solutions":["Install azure-search-documents"],"exampleFix":"pip install azure-search-documents>=11.4.0","handlingStrategy":null,"validationCode":null,"typeGuard":null,"tryCatchPattern":null,"preventionTips":[],"tags":[],"backgroundTag":null,"analyzedSha":"027ecf0a379bcc1d09956d46d12d44a3ad9cee14","analyzedAt":"2026-08-15T03:38:00.719Z","schemaVersion":2},"datasetVersion":"2026-08-15T22:17:37.221Z"}