Azure AI 网关治理
用 Azure API Management 统一治理 AI 模型、MCP 工具和智能体流量。
文档推荐托管身份、RBAC、最小范围授权，并明确本地与生产凭据差异；但示例包含创建后端、角色分配、导入 API 和调用网关等外部变更，缺少用户确认、回滚方案、数据流/日志敏感性说明，且展示订阅密钥和内置全权限订阅的诊断路径，因此扣分。
结构化的模式、故障排查和健康检查覆盖了常见路径，并提供了部分错误反馈；但依赖 Azure CLI、APIM/Azure 资源和具体 API/策略版本，未提供该技能专属的可执行测试，部分配置兼容性和命令正确性无法静态确认，因此不超过静态上限并扣分。
触发词、模型/工具/代理治理场景和若干前置条件较清晰；但非适用范围、输入输出契约、触发排除条件和环境边界不完整，没有中文使用说明，也未说明中国大陆网络对 Azure、Microsoft Learn、GitHub 原始规范等依赖的可达性，因此扣分。
主文档采用快速参考、常见任务、故障排查和分层 references，包含 MIT、作者和版本 3.1.1 元数据；但没有变更日志、明确维护责任人/更新流程、安装版本锁定和完整 FAQ，且若干外部链接与引用的更新风险未被管理，因此扣分。
技能覆盖 APIM AI 网关的后端、策略、缓存、限流、内容安全、指标、流式和多租户配置，并提供可直接改写的 CLI/XML/curl 示例；但占位符、资源部署前置条件和未验证的服务兼容性意味着仍需较多环境适配与审查，静态评估按上限计分。
文档提供 Microsoft Learn、Azure Samples、SDK 和 API 规范等可追溯来源，并含诊断命令和健康检查示例；但没有该技能专属的提交测试、执行结果或独立交叉验证，故只能达到静态证据上限。
- 执行 az、角色分配、API 导入和策略变更前应获得明确用户确认，并准备可审计的回滚方案。
- 不要在日志、提示或共享输出中暴露订阅密钥；内置全权限订阅仅应在严格隔离的诊断场景使用。
- 应在目标 Azure 区域和 APIM SKU/API 版本上验证策略标签、CLI 参数、流式兼容性及重试行为。
- 核心依赖 Azure CLI、Azure 资源和外部 Microsoft/GitHub 服务；文档未说明中国大陆网络可达性或离线替代方案。
这个 Skill 能做什么，适合哪些场景？
Azure AI Gateway skill 指导用户将 Azure API Management 配置为 AI 网关，用于管理 AI 模型、MCP 工具和智能体。它覆盖语义缓存、令牌限制、负载均衡、内容安全、越狱检测、令牌指标和后端认证等场景。内容提供 Azure CLI 命令、curl 测试示例以及 APIM 策略配置顺序。它适合已经拥有或准备使用 APIM 的 Azure 团队，但本身不负责部署 APIM。
它使用 Azure CLI 查询 APIM 网关地址、AI 后端和订阅密钥，创建 Azure OpenAI 后端，并通过角色分配授予 APIM 托管身份访问认知服务的权限。它给出通过网关调用 OpenAI chat completions 端点的 curl 示例，并指导用户组合身份验证、语义缓存、令牌限制、内容安全、后端选择和指标策略。它还提供 MCP 或工具限流、API 转 MCP，以及令牌限制、缓存未命中、内容误报和后端 401 错误的排查建议。
- 负责 Azure 平台治理的工程师，需要为 Azure OpenAI 或 AI Foundry 模型添加 APIM 后端。
- 需要控制模型成本的团队，想通过令牌限制、语义缓存和令牌指标管理用量。
- 提供 MCP 工具的开发团队，需要通过按键限流保护工具端点。
- 运营面向用户的智能体的团队，需要配置内容安全和越狱检测。
- 需要验证网关是否正确转发 OpenAI 请求的工程师，想使用 Azure CLI 和 curl 进行端到端测试。
这个 Skill 有哪些优点和局限？
- 覆盖模型、工具和智能体三类治理场景。
- 提供可复制的 Azure CLI、curl 和策略顺序示例。
- 包含令牌限制、语义缓存、内容安全、限流和指标等具体策略。
- 提供常见 429、缓存未命中、误报和 401 问题的排查方向。
- 要求使用 Azure CLI，并依赖已配置的 Azure 资源和权限。
- 不负责部署 APIM，部署步骤需要 azure-prepare skill。
- 源材料没有说明独立测试套件、支持的其他云平台或不使用 Azure CLI 的配置流程。
- 语义缓存的 60%–80% 成本节省是文档中的标注，不能视为所有工作负载的保证。
如何安装这个 Skill？
安装整个技能集合：npx skills add microsoft/skills，然后在向导中选择需要的技能。若使用 Copilot CLI，可运行：/plugin marketplace add microsoft/skills 和 /plugin install azure-skills@skills。源材料未说明如何单独安装 .github/plugins/azure-skills/skills/azure-aigateway 目录。
如何使用这个 Skill？
在已安装该技能的 Agent Skills 兼容客户端中，提出类似“为我的 APIM 添加 Azure OpenAI 后端”“为 MCP 工具配置限流”“为 AI 网关启用语义缓存和令牌指标”或“测试 AI gateway”的请求。配置和测试需要 Azure CLI；部署 APIM 需另行使用 azure-prepare skill。示例命令包括：az apim show --name <apim-name> --resource-group <rg> --query "gatewayUrl" -o tsv，以及使用返回的网关地址和订阅密钥执行 curl POST 请求。