Azure AI Search TypeScript 技能
帮助 TypeScript 开发者构建向量、混合和语义搜索应用。
提供 Entra ID、托管身份和环境变量认证示例，并建议使用文档级安全过滤器；但未明确最小 RBAC 权限、密钥保护、数据流、用户确认、外部写入影响或回滚方案，因此扣分。
核心 TypeScript 工作流覆盖索引、上传、全文、向量、混合和语义搜索；但没有该技能专属测试、输入校验或可诊断的异常处理，且主文档与参考文档在语义配置字段写法等细节上存在潜在不一致，因此静态分不超过10。
目标 SDK、TypeScript 场景和主要功能触发条件较清楚；但未声明非适用范围、服务版本前提、输入输出契约、地区网络可达性或中文使用注意事项，因此扣分。
SKILL.md 结构清晰，包含安装、认证、核心示例、最佳实践、MIT 许可证、作者和 1.0.0 版本，并提供两个参考文件；但缺少变更日志、维护责任和更新路径说明，限制与故障排查也不充分。
示例可直接作为搜索、索引和语义检索的起点，覆盖面较好；但嵌入生成、索引现有状态、服务配置、权限和生产级错误处理仍需用户补全，部分 API 细节还需核验，因此仅给中等静态效用分。
参考文件提供 Azure SDK for JS 和 Microsoft Learn 的来源指向，仓库还显示存在通用 CI 与测试基础设施；但没有该技能专属可审计测试或实际执行结果，静态证据覆盖有限。
- 示例包含索引创建、上传和删除文档等外部写操作，但没有确认、权限范围或恢复步骤；生产使用前应先审查 RBAC、密钥存储、过滤器安全边界和回滚策略。
- 参考示例中的语义配置字段命名存在潜在不一致，且 SDK/API 版本前提未固定；应依据目标包版本和官方文档逐项编译核验。
- 核心功能依赖 Azure AI Search、Entra ID 及可能的嵌入/语义服务；未提供中国大陆网络可达性或区域限制说明。
它能做什么 & 适用场景
该技能面向使用 JavaScript/TypeScript Azure AI Search SDK 的开发者。它覆盖索引创建与管理、文档写入、全文搜索、向量搜索、混合搜索、语义排序、过滤、分面、自动补全和建议。内容还介绍 DefaultAzureCredential 与托管身份认证，以及基于知识库的代理式检索场景。它适合需要在 Azure AI Search 中实现检索功能的编码代理，但不会提供嵌入生成函数或完整应用。
指导安装 @azure/search-documents 和 @azure/identity，配置 Azure Search 环境变量，创建 SearchClient 与 SearchIndexClient，定义包含向量字段和 HNSW 配置的索引，上传及批量操作文档，执行全文、向量、混合和语义搜索，使用过滤器与分面，并配置自动补全和建议器。示例会读取 Azure Search 端点、索引名称及可选密钥等环境变量，并输出搜索结果、分数、分面或语义摘要。
- TypeScript 开发者需要创建包含文本字段和嵌入字段的 Azure AI Search 产品索引时。
- 应用需要同时结合关键词与向量相似度执行混合检索时。
- 面向自然语言查询的应用需要语义排序、摘要或答案提取时。
- 团队需要按类别、价格等字段过滤结果并展示分面统计时。
- 代理应用需要使用 Azure AI Search 支持知识库或代理式检索时。
优缺点一览
- 覆盖从索引设计到查询执行的完整 Azure AI Search TypeScript 基础流程。
- 同时包含全文、向量、混合和语义搜索示例。
- 提供 Entra ID、DefaultAzureCredential 和托管身份认证模式。
- 包含过滤、分面、自动补全、建议和批量文档操作。
- MIT 许可，且来自 Microsoft 的 Agent Skills 仓库。
- 示例依赖应用自行实现的 getEmbedding 函数，未提供嵌入模型方案。
- 内容主要是代码片段和最佳实践，不是完整可运行项目。
- 未给出 Azure 资源创建、索引部署或服务定价说明。
- 语义搜索示例要求索引先配置语义配置。
如何安装
先安装依赖：npm install @azure/search-documents @azure/identity。若安装整个技能集合，README 提供的命令是：npx skills add microsoft/skills，然后在向导中选择所需技能。源材料未说明如何单独通过该命令指定 azure-search-documents-ts 技能。
如何使用
将该技能放入编码代理可加载的技能目录后，使用类似“请用 @azure/search-documents 为产品目录创建向量索引，并实现文本、向量和混合搜索”的请求。配置 AZURE_SEARCH_ENDPOINT 和 AZURE_SEARCH_INDEX_NAME；使用密钥时配置 AZURE_SEARCH_ADMIN_KEY，使用 DefaultAzureCredential 时配置 AZURE_TOKEN_CREDENTIALS=prod。嵌入生成函数需要由应用自行提供。