Azure AI 服务技能
为编码代理提供 Azure AI 搜索、语音、OpenAI 与 OCR 操作指引。
内容包含托管身份、RBAC、避免硬编码凭据和密钥保管库等安全建议，未见恶意或破坏性默认行为；但 MCP、CLI、搜索、语音、OCR 和生成式服务涉及外部数据传输与云端副作用，未规定最小权限、用户确认、数据流披露、敏感数据处理或回滚，因此扣分。
结构清晰，提供服务映射、认证模式和部分 SDK 片段；但覆盖面很广，缺少安装前提、版本兼容矩阵、关键路径测试、输入边界和统一错误处理，且部分示例依赖未说明的环境变量或服务配置。静态审查上限内，扣除可复现性和失败反馈不足。
触发条件明确覆盖 AI Search、Speech、OpenAI、OCR 和文档智能，适合 Azure AI 开发者；但能力边界、非适用场景、地区/服务可用性、中文输入输出和中国大陆网络可达性均未说明，广泛服务范围也可能造成误触发，因此扣分。
具备规范的名称、描述、MIT 许可证、作者和 1.1.1 版本元数据，并按服务和 SDK 参考分层；但没有变更日志、维护责任和更新路径说明，安装依赖、参数稳定性、FAQ、限制和排障信息不完整，因此未满分。
服务表、MCP 命令、CLI 提示、认证建议和多语言快速参考能直接帮助常见 Azure AI 编码任务；但多数内容是压缩参考，缺少端到端输出、完整参数、错误恢复和结果验证，用户仍可能需要较多查证与改写，静态证据不足以支持更高分。
引用了 Microsoft 文档来源，且仓库提供通用 CI、评估工作流和测试代码；但提供的测试并未覆盖该 azure-ai 技能的关键服务路径，未见该技能专属验收标准或独立执行结果，因此只能给予有限可审计性。
- 不要把该技能的示例视为已验证可运行的生产代码；应逐项确认 SDK 版本、API 可用性、区域限制和身份权限。
- 处理音频、文档、图像或搜索索引前，应明确数据是否发送到 Azure、配置最小 RBAC、取得用户确认，并制定日志、保留和失败恢复策略。
- 仓库说明处于持续开发阶段，建议在采用前检查后续版本和服务弃用变化。
这个 Skill 能做什么，适合哪些场景？
azure-ai 是 Microsoft Agent Skills 仓库中的一项 Azure AI 技能，覆盖 AI Search、Speech、OpenAI 和 Document Intelligence。它为编码代理提供搜索、向量与混合检索、语音转写、语音合成和 OCR 等场景的服务选择、MCP 命令及 CLI 入口。启用 Azure MCP 时，技能优先使用搜索和语音 MCP 工具；部分服务则通过 Azure CLI 或文档参考使用。它适合已经使用 Azure、需要代理获得 Azure AI 服务上下文的开发团队，但并非完整 SDK 教程或独立运行时。
根据任务匹配 Azure AI 服务；使用 azure__search 列出搜索索引、获取索引详情和执行索引查询；使用 azure__speech 进行语音转文字和文字转语音；为 Azure OpenAI 指向 GPT 模型、嵌入和 DALL-E 的 az cognitiveservices CLI；为 Document Intelligence 指向表单提取和 OCR；提供 AI Search、OpenAI、视觉、转写、翻译、文档智能和内容安全的 SDK 参考链接。
- 使用 Azure AI Search 的开发者需要查询索引或组合关键词与向量检索时。
- 构建会议、客服或媒体应用的团队需要语音转写、说话人识别或神经语音合成时。
- 使用 Azure OpenAI 进行 GPT、嵌入或图像生成的开发者需要服务入口提示时。
- 处理表单、票据或扫描文档的开发者需要 OCR 或表单提取方向时。
- 希望让编码代理在 Azure AI 服务任务中自动选择 MCP 工具或 CLI 的团队。
这个 Skill 有哪些优点和局限？
- 覆盖 AI Search、Speech、Azure OpenAI 和 Document Intelligence 四类 Azure AI 服务。
- 明确列出 MCP 工具、命令名称及 AI Search 和 Speech 的具体操作。
- 提供多种语言的 SDK 快速参考入口。
- 采用 MIT 许可证，并由 Microsoft 发布。
- 依赖 Azure MCP 或 Azure CLI；源文档没有说明凭据配置、权限范围或错误处理细节。
- MCP 工具仅明确覆盖 AI Search 和 Speech，OpenAI 与 Document Intelligence 没有对应 MCP 工具说明。
- 内容偏向服务路由和操作提示，不是完整的 SDK 实现指南。
- 源材料未提供该技能专属测试场景或平台覆盖证明。
如何安装这个 Skill？
运行 npx skills add microsoft/skills，在安装向导中选择 azure-ai。技能源目录为 .github/plugins/azure-skills/skills/azure-ai/SKILL.md；仓库说明技能会安装到所选代理的目录，例如 GitHub Copilot 使用 .github/skills/。
如何使用这个 Skill？
在已启用 Azure MCP 的代理中提出具体任务，例如“列出我的 Azure AI Search 索引并查询其中的产品文档”。可使用 azure__search 的 search_index_list、search_index_get、search_query，或 azure__speech 的 speech_transcribe、speech_synthesize。若 Azure MCP 未启用，源文档建议运行 /azure:setup 或通过 /mcp 启用。