用途：基于 Azure AI Search 的 TypeScript SDK（@azure/search-documents）构建搜索应用，支持全文、向量、混合和语义搜索。
安装与环境：执行 npm install @azure/search-documents @azure/identity 安装依赖。需配置环境变量 AZURE_SEARCH_ENDPOINT、AZURE_SEARCH_INDEX_NAME，以及可选的 AZURE_SEARCH_ADMIN_KEY；使用 Entra ID 时可省略管理密钥。认证通过 DefaultAzureCredential 或密钥。
主要能力：使用 SearchClient 执行搜索，SearchIndexClient 管理索引，SearchIndexerClient 管理索引器。索引可定义可搜索字段、filterable/facetable 字段及 Collection(Edm.Single) 向量字段，并配置 HNSW 算法与向量配置文件。支持上传文档、全文搜索（select/filter/orderBy/top）、向量搜索（kNearestNeighborsCount）、混合搜索（文本加向量）、语义搜索（需索引配置 semanticSearch，可返回 captions 与 rerankerScore）。还支持过滤与分面（facets）、自动补全与建议（需在索引定义 suggesters）、批量操作（upload/merge/delete 组成的 batch）。
使用方式：先创建或更新索引（含字段、vectorSearch、semanticSearch、suggesters），再上传或 mergeOrUpload 文档，随后调用 search 并按需选择向量或语义选项。向量检索需自备嵌入函数生成查询向量。
适用场景：商品、文档等需自然语言检索的 TypeScript 应用。
限制：仅应在任务与上述范围明确匹配时使用，输出不能替代针对具体环境的验证、测试或专家评审；若缺少必要输入、权限、安全边界或成功标准，应停止并请求澄清。