1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | azure-ai-microsoft-azure-skills |
| 作者/维护者 | Microsoft |
| 来源链接 | github.com/microsoft/azure-skills/tree/main/skills/azure-ai |
| 许可证 | MIT（GitHub API 获取） |
| GitHub Stars | 1,377（GitHub API 获取；该数字属整个 Azure Skills Plugin 合集，不代表本技能自身热度） |
| Forks | 225（同上，整个合集） |
| 最新版本 | 1.2.1（SKILL.md 元数据） |
| 安装方式 | 随 Azure Skills Plugin 整体安装（Claude Code / GitHub Copilot CLI / APM 多宿主安装器等，见第 10 章） |
2. 功能介绍与亮点
azure-ai 是 Microsoft 官方 Azure Skills Plugin 中面向 Azure AI 服务的技能，一次性覆盖四类常用能力：
- AI Search：全文检索、向量检索、混合检索
- Speech：语音转写（speech-to-text）、语音合成（text-to-speech）
- OpenAI：GPT 模型、embedding、DALL-E 相关操作入口
- Document Intelligence：表单提取、OCR
每类能力都给出触发词表、对应的 Azure MCP 工具名（如 azure__search、azure__speech）与 CLI 命令，并附带 Python / TypeScript / .NET / Java 四种语言的 SDK 速查参考（共 16 个文件，约 29KB）。
主要亮点：官方 Microsoft 出品，配合 Azure MCP Server 可直接查询用户自己的真实 Azure 资源（如已有的 Search 索引），而不只是生成示例代码；单个技能覆盖四条常见场景线，减少在多个碎片化技能间切换的成本。
3. 适用场景
所属分类：集成与工作流自动化（该技能的核心是把应用接入 Azure 的第三方 AI 服务 SDK/API/MCP 工具，属于“连接/操作另一个系统”）
- 需要在应用中集成 Azure AI Search 做全文、向量或混合检索的开发者
- 需要语音转写（如客服录音转文字）或语音合成（如无障碍朗读）能力的团队
- 需要用 Document Intelligence 做表单/票据 OCR 提取的场景
- 已经用 Claude Code、GitHub Copilot 等 agent 处理 Azure 相关工作、希望 agent 直接操作真实 AI 资源而非现查文档抄代码的开发者
4. 跨 Agent 兼容性
- Claude Code：原生支持 ✅ —— 官方插件市场提供一键安装命令
/plugin install azure@claude-plugins-official - Codex：支持 ✅ —— 官方多宿主安装器 APM 明确列出 Codex 为受支持宿主之一（
apm install microsoft/azure-skills一次安装覆盖 GitHub Copilot、Claude Code、Cursor、OpenCode、Codex、Gemini） - OpenClaw：未验证 ❓ —— 官方文档未提及
- Hermes Agent：未验证 ❓ —— 官方文档未提及
5. 推荐理由
azure-ai 把 Azure 四类主力 AI 服务（搜索、语音、OpenAI、文档智能）的接入方式打包进一个技能，配合 Azure MCP Server 能让 agent 直接查询真实索引、转写真实音频，而不是停留在“生成示例代码”这一层。对已经在用 Azure 的团队，这比逐份查阅四份官方 SDK 文档更省事，比现攒 prompt 更可靠，且官方持续维护、安装路径覆盖多种 agent 宿主。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 7 | 官方 Microsoft 出品；GitHub Star 数（1,377）记在整个 Azure Skills Plugin 合集名下，不代表本技能个体；本技能自身目前暂无独立第三方讨论或评测 |
| 可用性 | 8 | Claude Code / GitHub Copilot CLI / APM 均提供一键安装命令，SKILL.md 与四种语言的 SDK 速查文档齐全；需已具备 Azure 订阅及对应 AI 资源（如 Search 索引、Speech 资源），仓库主干近日仍有提交 |
| 安全性 | 8 | 见下方检查清单 |
安全检查清单：
- ① 是否执行 shell 命令及权限范围：主要通过 Azure MCP 工具（
azure__search、azure__speech）或官方 SDK 调用既有 Azure 资源，涉及的 CLI（如az cognitiveservices）范围限定在已声明的 AI 服务操作内 - ② 运行时是否联网外发数据：会向用户自己名下的 Azure AI 资源发起调用，属技能声明用途内的必要网络请求，目标透明
- ③ 是否要求 API key/凭据及其存储方式：认证走 Azure CLI（
az login）或既有 Azure MCP 会话，未见技能本身另外索取或存储凭据 - ④ 有无可疑指令：通读 SKILL.md 与 references 未发现隐藏指令或数据外发迹象
- ⑤ 作者信誉：Microsoft 官方仓库，
microsoft/azure-skills自述为“Official agent plugin providing skills and MCP server configurations for Azure scenarios” - ⑥ License：MIT，明确
- ⑦ 最近维护：仓库主干 2026-08-13 当天仍有提交，该子技能内容最近一次同步为 2026-07-28
7. 跟同类 Skills 相比的优势
| 技能 | 定位 | 与 azure-ai 的差异 |
|---|---|---|
| azure-aigateway（同合集） | 把 Azure API Management 配置成 AI 网关，提供语义缓存、限流、内容安全过滤、MCP 工具限流等治理能力 | 面向已在生产环境跑 LLM 应用、需要治理与成本控制的团队，是“治理层”；azure-ai 是“消费层”，直接调用 AI 服务本身 |
| azure-messaging（同合集） | 专注排查 Event Hubs / Service Bus 消息中间件的 SDK 连接、鉴权与消息处理故障 | 是问题诊断工具，处理的是“消息队列出了什么错”，与 azure-ai 面向的“接入 AI 能力”是完全不同的服务线 |
azure-ai 的差异化在于单技能覆盖四类 AI 服务、且通过官方 MCP 工具直接操作真实资源，而不是仅提供某一单点能力的代码片段。
8. 用户评价
该技能目前在第三方平台尚无具名用户评价。microsoft/azure-skills 已被 LobeHub、ExplainX、AwesomeSkill 等第三方 Agent Skill 目录站收录展示，但均为自动化索引列表，未附带具体的用户评论内容。
9. 其他补充
参考文档同时给出 Python、TypeScript、.NET、Java 四种语言的 SDK 代码片段，方便不同技术栈团队直接复用同一份技能说明。
10. 安装使用方式
- Claude Code：运行
/plugin install azure@claude-plugins-official，或在/plugin市场中搜索 “azure” 后安装；更新用/plugin update azure@claude-plugins-official - GitHub Copilot CLI：先执行
/plugin marketplace add microsoft/azure-skills添加市场，再执行/plugin install azure@azure-skills - 多宿主统一安装（含 Codex / Cursor / OpenCode / Gemini）：安装 APM 后执行
apm install microsoft/azure-skills - VS Code：安装 Azure MCP 扩展（应用商店搜索 “Azure MCP”），会自动带入配套的 Azure 技能层
- 安装前提：已有 Azure 订阅、已执行
az login完成 Azure CLI 登录、Node.js 18+（用于启动 MCP server） - 安装后：技能与 Azure MCP Server、Foundry MCP 一起注册；当对话触发“AI Search / 语音转写 / OCR / 文档智能”等相关描述时自动加载；实际调用前需已在 Azure 订阅内创建好对应服务资源（如 Search 服务、Speech 资源）
11. 注意事项
- 本技能是 Azure Skills Plugin 合集内的子技能，官方标准渠道是整套安装（含 20 余个 Azure 技能），不单独分发
- 实际调用 AI Search / Speech / OpenAI / Document Intelligence 前，需要用户已在 Azure 订阅内创建好相应服务资源，本技能本身不负责资源开通
- 调用 Azure AI 服务会产生 Azure 侧用量计费，属正常云服务成本
- OpenClaw 与 Hermes Agent 的兼容性未经官方文档说明，也未经实测验证