开发与工程 ✓ Microsoft · 官方

Azure API Management Python 技能

帮助编码代理使用 Python SDK 管理 Azure API Management 的服务、API、产品、订阅与策略。

54/ 100
谨慎使用

价值存在,但可靠性、证据或控制措施仍有明显缺口。

查看评分依据 ↓
可直接使用于
Codex · Claude Code
Star 数
★ 2.7k
最近更新
3 个月前
License
MIT
azure-api-managementpython-sdkapi-gatewayapi-policy
+2managed-identityopenapi

这个 Skill 能做什么,适合哪些场景?

该技能面向使用 azure-mgmt-apimanagement Python SDK 的开发者和编码代理。它提供 APIM 服务创建、OpenAPI 导入、API 列表、产品与订阅管理、策略配置,以及后端、命名值和用户管理示例。技能建议使用 DefaultAzureCredential 和客户端上下文管理器,并要求设置 Azure 订阅 ID。它适合需要通过 Python 自动化 Azure API 网关配置的项目,但不覆盖其他语言或完整的部署流程。

安装 azure-mgmt-apimanagement 和 azure-identity;读取 AZURE_SUBSCRIPTION_ID 及可选的 AZURE_TOKEN_CREDENTIALS;通过 ApiManagementClient 调用 Azure API,创建或更新 APIM 服务、导入 OpenAPI API、列出 API、创建产品和订阅、关联产品与 API、设置 API 策略、创建命名值、后端和用户;示例会输出服务名称、API 名称、产品名称或订阅主密钥。

适合
  • 负责 Azure 平台的 Python 开发者需要创建或更新 APIM 服务时,可用它生成 SDK 调用代码。
  • 维护 OpenAPI 文档的团队需要将 JSON 内容或 URL 导入 API Management 时,可参考其导入示例。
  • API 平台团队需要把 API 组合到产品并创建订阅访问范围时,可使用其产品和订阅操作。
  • 需要为 API 添加限流和请求头规则的开发者,可参考其 XML 策略配置示例。
  • 需要以托管身份或 DefaultAzureCredential 访问 Azure 的团队,可采用其认证和客户端生命周期模式。

如何安装这个 Skill?

使用前请注意
  • 所有创建、更新和策略操作都可能产生真实 Azure 资源或配置变更;执行前应确认目标订阅、资源组、权限和变更范围,并准备删除或恢复方案。
  • 不要打印或硬编码订阅密钥、API 密钥或其他秘密;应使用安全的秘密存储和最小权限。
  • 示例中的 SDK 方法、模型字段和枚举应与目标版本的官方 API 文档核对;未提供该技能专属的可执行测试证据。
  • Import API from URL 和后端配置涉及外部网络数据流;应审查 URL、TLS、数据内容和网络可达性。
开始前你需要
Agent 需要具备
  • Shell / 命令行
  • 网络访问
需要预先安装
  • Python package azure-mgmt-apimanagement
  • Python package azure-identity

在 Copilot CLI 或兼容客户端中运行 npx skills add microsoft/skills,在选择器中选择此技能。也可以克隆仓库后,将 .github/plugins/azure-sdk-python/skills/azure-mgmt-apimanagement-py 复制到所用代理的技能目录;README 未提供该单个技能的独立安装命令。

通用方式:手动安装到 Claude Code(macOS / Linux)
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-python/skills/azure-mgmt-apimanagement-py" ~/.claude/skills/
rm -rf "$tmp"

根据源仓库地址和 Skill 路径自动生成,只复制这个 Skill 的文件夹。如果上文有作者提供的安装方式,请优先按作者说明操作;想只在当前项目中使用,把 ~/.claude/skills 换成项目里的 .claude/skills。

如何使用这个 Skill?

在已安装技能的编码代理中提出包含触发词的请求,例如:使用 azure-mgmt-apimanagement 和 ApiManagementClient,把 OpenAPI URL 导入现有 APIM,并为 API 设置限流策略。 运行生成的 Python 代码前,安装 azure-mgmt-apimanagement 和 azure-identity,并设置 AZURE_SUBSCRIPTION_ID;使用 DefaultAzureCredential 时按文档设置 AZURE_TOKEN_CREDENTIALS。

这个 Skill 有哪些优点和局限?

优点
  • 覆盖 APIM 服务、API、产品、订阅、策略、后端、命名值和用户等具体操作。
  • 同时给出 OpenAPI JSON 内容导入和 URL 导入示例。
  • 明确建议使用 DefaultAzureCredential、生产凭据约束和客户端上下文管理器。
  • 提供同步与异步客户端选择及资源清理方面的实践建议。
局限
  • 仅针对 Python SDK,不提供 .NET、TypeScript、Java 或 Rust 用法。
  • 示例依赖真实 Azure 订阅和相应权限;来源没有列出具体 RBAC 角色或权限矩阵。
  • 来源没有展示该单个技能的专属测试覆盖情况。
  • 虽然建议启用 Application Insights 和 API 版本管理,但没有给出对应代码示例。

这个 Skill 与同类方案有什么区别?

与相关 Skills 并排比较;分数均按同一 FSRS 标准得出。

Skill FS 评分 Star 数 最近更新 License
Azure API Management Python 技能 本页 ✓ Microsoft · 官方 54 · 谨慎使用 ★ 2.7k 3 个月前 MIT
Azure Identity Python 认证技能 ✓ Microsoft · 官方 60 · 推荐 ★ 2.7k 3 个月前 MIT
Azure Bot Service Python 管理技能 ✓ Microsoft · 官方 52 · 谨慎使用 ★ 2.7k 3 个月前 MIT
Azure API Center Python 管理技能 ✓ Microsoft · 官方 48 · 谨慎使用 ★ 2.7k 3 个月前 MIT
Azure Identity TypeScript ✓ Microsoft · 官方 57 · 谨慎使用 ★ 2.7k 3 个月前 MIT

FollowSkills 如何评估这个 Skill?

FollowSkills 评估 · FSRS-2.0
谨慎使用
54/ 100 五分制 2.7 / 5
1信任安全16 / 25 · 3.2/5

证据显示技能推荐 DefaultAzureCredential、限制生产凭据链、避免连接字符串和密钥,并使用环境变量;但创建服务、订阅、用户、策略和后端等外部变更均未要求用户确认、最小 RBAC 范围、回滚或删除路径,且示例直接打印订阅主密钥并包含明文秘密/HTTP 后端,因此扣分。

2可靠稳定8 / 20 · 2.0/5

示例覆盖认证、同步客户端、长任务和多个 APIM 操作,整体指令一致;但没有异常处理、分页、重试、幂等性验证或可诊断失败反馈,引用文件也明确要求再次核对当前 API,因此按静态上限保守扣分。

3适用触发10 / 15 · 3.3/5

名称、描述和触发词清楚,覆盖服务、API、产品、订阅、策略、秘密、后端和用户场景;但未明确非适用边界、权限前提、异步实现和输入校验,且未讨论中国网络/区域可达性,因此扣分。

4规范维护10 / 15 · 3.3/5

具备 YAML 元数据、MIT 许可、版本号、安装说明、环境变量、分层参考文件、操作组表和生产检查清单,结构较清晰;但缺少变更日志、明确维护责任/更新流程、依赖版本约束、FAQ 和完整清理示例,因此扣分。

5有效结果6 / 15 · 2.0/5

技能能为常见 APIM 管理任务提供可直接改写的 Python 片段,覆盖面较广;但代码多依赖已存在的 client、资源组和权限,缺少端到端可运行项目、删除/回滚流程、错误处理和验证步骤,用户仍需较多整合与复核,因此未给满分。

6证据核验4 / 10 · 2.0/5

仓库提供修订固定的源码、参考文件、MIT 许可证以及通用 CI/测试基础设施,具备一定审计线索;但未提供该技能专属的验收标准、提交测试或第三方执行结果,结论主要来自静态文本,按静态上限扣分。

1 2 3 4 5 6

点击维度查看打分理由

评估于 2026年7月20日 审查版本 9ccaf7c3704a 评估证据[1][2][3][4][5][6][7][8][9][10][11][12]

证据充分度:低 — 主要依赖静态检查、作者材料或有限演示;适合发现线索,不适合做高风险决策。

查看完整评分方法 →

常见问题

这个技能需要 Azure 订阅吗?
需要。代码示例要求设置 `AZURE_SUBSCRIPTION_ID`,并通过 Azure 凭据访问 API Management。
推荐使用哪种认证方式?
技能建议优先使用 DefaultAzureCredential;生产环境应设置 `AZURE_TOKEN_CREDENTIALS=prod` 或指定凭据,也可直接使用 ManagedIdentityCredential。
它能管理 API 密钥和秘密吗?
它可以创建 APIM 命名值并将其标记为 secret,但来源没有说明外部密钥库集成。
它是否负责部署完整的 Azure 应用?
不是。它聚焦于通过 Python SDK 管理 APIM 资源和配置,来源未提供完整应用或基础设施部署流程。

同仓库的其他 Skills

均来自 microsoft/agent-skills

开发与工程 ✓ Microsoft · 官方

Azure Identity Python 认证技能

为 Python Azure 应用提供基于 Microsoft Entra ID 的可复用身份认证指导。

★ 2.7k FS 60 推荐 3 个月前
开发与工程 ✓ Microsoft · 官方

Azure Bot Service Python 管理技能

用 Python 创建、管理和配置 Azure Bot Service 机器人及其通信渠道。

★ 2.7k FS 52 谨慎使用 3 个月前
开发与工程 ✓ Microsoft · 官方

Azure API Center Python 管理技能

用 Python 管理 Azure API 清单、元数据与治理。

★ 2.7k FS 48 谨慎使用 3 个月前
开发与工程 ✓ Microsoft · 官方

Azure Identity TypeScript

为 TypeScript Azure 应用配置安全、可切换的 Microsoft Entra ID 身份验证。

★ 2.7k FS 57 谨慎使用 3 个月前
自动化与运维 ✓ Microsoft · 官方

Azure AI 网关治理

用 Azure API Management 统一治理 AI 模型、MCP 工具和智能体流量。

★ 2.7k FS 55 谨慎使用 3 个月前
开发与工程 ✓ Microsoft · 官方

Azure Queue Storage Python 技能

帮助编码代理使用 Python 构建安全、可靠的 Azure Queue Storage 异步消息处理。

★ 2.7k FS 55 谨慎使用 3 个月前
开发与工程 ✓ Microsoft · 官方

Azure Key Vault Python SDK 技能

帮助 Python 编码代理安全管理 Azure Key Vault 中的机密、加密密钥和证书。

★ 2.7k FS 54 谨慎使用 3 个月前
开发与工程 ✓ Microsoft · 官方

Azure AI 内容安全 Python 技能

帮助 Python 应用检测文本和图像中的有害内容,并管理自定义屏蔽词。

★ 2.7k FS 53 谨慎使用 3 个月前
开发与工程 ✓ Microsoft · 官方

Azure 应用配置 Python 技能

为 Python 应用集中管理配置、功能标志和动态设置。

★ 2.7k FS 53 谨慎使用 3 个月前
开发与工程 ✓ Microsoft · 官方

Azure 容器注册表 Python 技能

用 Python 管理 Azure 容器镜像、制品与仓库。

★ 2.7k FS 53 谨慎使用 3 个月前
开发与工程 ✓ Microsoft · 官方

Azure Monitor 自定义日志采集

帮助 Python 编码代理通过 Logs Ingestion API 发送自定义日志。

★ 2.7k FS 53 谨慎使用 3 个月前
开发与工程 ✓ Microsoft · 官方

Azure Identity for .NET

为 .NET Azure SDK 客户端提供 Microsoft Entra ID 身份验证指导。

★ 2.7k FS 50 谨慎使用 3 个月前
开发与工程 ✓ Microsoft · 官方

Azure Web PubSub Python 技能

帮助 Python 开发者构建基于 WebSocket 的 Azure 实时消息与发布订阅功能。

★ 2.7k FS 50 谨慎使用 3 个月前
开发与工程 ✓ Microsoft · 官方

Azure Event Hubs Python 技能

为 Python 应用提供高吞吐事件流的发送、接收与检查点模式。

★ 2.7k FS 49 谨慎使用 3 个月前
开发与工程 ✓ Microsoft · 官方

Azure API 管理 .NET 管理 SDK

用 .NET 创建、配置和治理 Azure API Management 资源。

★ 2.7k FS 48 谨慎使用 3 个月前
开发与工程 ✓ Microsoft · 官方

Azure Monitor Java 日志摄取

帮助 Java 应用通过 DCR 将自定义日志发送到 Azure Monitor。

★ 2.7k FS 48 谨慎使用 3 个月前
开发与工程 ✓ Microsoft · 官方

Azure AI 持久化智能体 Java SDK

帮助 Java 开发者构建、运行和管理带线程、消息与工具的持久化 Azure AI 智能体。

★ 2.7k FS 47 谨慎使用 3 个月前
开发与工程 ✓ Microsoft · 官方

Microsoft Foundry Python 项目技能

为编码代理提供使用 Azure AI Projects Python SDK 构建 Foundry AI 应用的可靠模式。

★ 2.7k FS 47 谨慎使用 3 个月前
开发与工程 ✓ Microsoft · 官方

Azure Rust 身份认证技能

为 Rust Azure SDK 客户端配置 Microsoft Entra ID 身份认证。

★ 2.7k FS 45 不推荐 3 个月前
开发与工程 ✓ Microsoft · 官方

Azure Service Bus Python 技能

为 Python 开发者提供 Azure Service Bus 队列与发布/订阅消息模式的实用指导。

★ 2.7k FS 45 不推荐 3 个月前

相关 Skills