这个 Skill 能做什么，适合哪些场景？
该技能面向使用 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 支持知识库或代理式检索时。
如何安装这个 Skill？
- 示例包含索引创建、上传和删除文档等外部写操作，但没有确认、权限范围或恢复步骤；生产使用前应先审查 RBAC、密钥存储、过滤器安全边界和回滚策略。
- 参考示例中的语义配置字段命名存在潜在不一致，且 SDK/API 版本前提未固定；应依据目标包版本和官方文档逐项编译核验。
- 核心功能依赖 Azure AI Search、Entra ID 及可能的嵌入/语义服务；未提供中国大陆网络可达性或区域限制说明。
- Shell / 命令行
- 网络访问
Node.js@azure/search-documents@azure/identity
先安装依赖：npm install @azure/search-documents @azure/identity。若安装整个技能集合，README 提供的命令是：npx skills add microsoft/skills，然后在向导中选择所需技能。源材料未说明如何单独通过该命令指定 azure-search-documents-ts 技能。
tmp="$(mktemp -d)"
git clone --depth 1 https://github.com/microsoft/skills.git "$tmp"
mkdir -p ~/.claude/skills
cp -R "$tmp/.github/plugins/azure-sdk-typescript/skills/azure-search-documents-ts" ~/.claude/skills/
rm -rf "$tmp"根据源仓库地址和 Skill 路径自动生成，只复制这个 Skill 的文件夹。如果上文有作者提供的安装方式，请优先按作者说明操作；想只在当前项目中使用，把 ~/.claude/skills 换成项目里的 .claude/skills。
如何使用这个 Skill？
安装后，把下面任意一句发给 Agent 即可触发：
- 请用 @azure/search-documents 为产品目录创建向量索引，并实现文本、向量和混合搜索
将该技能放入编码代理可加载的技能目录后，使用类似“请用 @azure/search-documents 为产品目录创建向量索引，并实现文本、向量和混合搜索”的请求。配置 AZURE_SEARCH_ENDPOINT 和 AZURE_SEARCH_INDEX_NAME；使用密钥时配置 AZURE_SEARCH_ADMIN_KEY，使用 DefaultAzureCredential 时配置 AZURE_TOKEN_CREDENTIALS=prod。嵌入生成函数需要由应用自行提供。
这个 Skill 有哪些优点和局限？
- 覆盖从索引设计到查询执行的完整 Azure AI Search TypeScript 基础流程。
- 同时包含全文、向量、混合和语义搜索示例。
- 提供 Entra ID、DefaultAzureCredential 和托管身份认证模式。
- 包含过滤、分面、自动补全、建议和批量文档操作。
- MIT 许可，且来自 Microsoft 的 Agent Skills 仓库。
- 示例依赖应用自行实现的 getEmbedding 函数，未提供嵌入模型方案。
- 内容主要是代码片段和最佳实践，不是完整可运行项目。
- 未给出 Azure 资源创建、索引部署或服务定价说明。
- 语义搜索示例要求索引先配置语义配置。
这个 Skill 与同类方案有什么区别？
与相关 Skills 并排比较；分数均按同一 FSRS 标准得出。
| Skill | FS 评分 | Star 数 | 最近更新 | License |
|---|---|---|---|---|
| Azure AI Search TypeScript 技能 本页 ✓ Microsoft · 官方 | 50 · 谨慎使用 | ★ 2.7k | 3 个月前 | MIT |
| Azure AI Search Python 技能 ✓ Microsoft · 官方 | 50 · 谨慎使用 | ★ 2.7k | 3 个月前 | MIT |
| Azure AI Search .NET 开发技能 ✓ Microsoft · 官方 | 51 · 谨慎使用 | ★ 2.7k | 3 个月前 | MIT |
| Azure AI 服务技能 ✓ Microsoft · 官方 | 49 · 谨慎使用 | ★ 2.7k | 3 个月前 | MIT |
| Azure AI Projects TypeScript 技能 ✓ Microsoft · 官方 | 49 · 谨慎使用 | ★ 2.7k | 3 个月前 | MIT |
FollowSkills 如何评估这个 Skill？
提供 Entra ID、托管身份和环境变量认证示例，并建议使用文档级安全过滤器；但未明确最小 RBAC 权限、密钥保护、数据流、用户确认、外部写入影响或回滚方案，因此扣分。
核心 TypeScript 工作流覆盖索引、上传、全文、向量、混合和语义搜索；但没有该技能专属测试、输入校验或可诊断的异常处理，且主文档与参考文档在语义配置字段写法等细节上存在潜在不一致，因此静态分不超过10。
目标 SDK、TypeScript 场景和主要功能触发条件较清楚；但未声明非适用范围、服务版本前提、输入输出契约、地区网络可达性或中文使用注意事项，因此扣分。
SKILL.md 结构清晰，包含安装、认证、核心示例、最佳实践、MIT 许可证、作者和 1.0.0 版本，并提供两个参考文件；但缺少变更日志、维护责任和更新路径说明，限制与故障排查也不充分。
示例可直接作为搜索、索引和语义检索的起点，覆盖面较好；但嵌入生成、索引现有状态、服务配置、权限和生产级错误处理仍需用户补全，部分 API 细节还需核验，因此仅给中等静态效用分。
参考文件提供 Azure SDK for JS 和 Microsoft Learn 的来源指向，仓库还显示存在通用 CI 与测试基础设施；但没有该技能专属可审计测试或实际执行结果，静态证据覆盖有限。
点击维度查看打分理由
证据充分度：低 — 主要依赖静态检查、作者材料或有限演示；适合发现线索，不适合做高风险决策。
查看完整评分方法 →