mcpField
A
azure-api-center

azure-api-center

github.com/microsoftdocs开发796179 次安装3 天前更新
代码仓库

关于 azure-api-center

面向 Azure API Center 的 Agent 技能，涵盖 API 治理、安全、配置、集成和部署。它结合本地速查内容与远程文档获取，适用于管理 API 目录和自动化治理流程的团队。

主要功能

  1. 01API 风格检查与治理
  2. 02授权方案和门户权限
  3. 03元数据与实例配置
  4. 04API 清单同步和通知自动化
  5. 05部署与注册自动化

适用场景

  1. 01为 API 应用风格检查
  2. 02配置 API 授权与门户访问
  3. 03同步 API Management 中的 API
  4. 04自动注册 API 并发送通知

MCP 相关

技能可通过 mcp_microsoftdocs 的 microsoft_docs_fetch 获取文档，也可使用 fetch_webpage 作为备用。

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/microsoftdocs/agent-skills --skill azure-api-center

安装后在 Claude Code 中输入/azure-api-center确认已加载。

详细介绍

Azure Api Center 技能

此技能为 Azure Api Center 提供专业指导，涵盖最佳实践、安全性、配置、集成与编码模式，以及部署。它结合了本地快速参考内容和远程文档获取功能。

如何使用此技能

IMPORTANT for Agent：使用下方的类别索引查找相关章节。对于标有行范围的类别（例如，L35-L120），请使用 read_file 读取指定行。对于带有文件链接的类别（例如，[security.md](security.md)），请使用 read_file 读取链接的参考文件

IMPORTANT for Agent：如果 metadata.generated_at 的时间超过 3 个月，请建议用户从仓库拉取最新版本。如果无法使用 mcp_microsoftdocs 工具，请建议用户安装该工具：安装指南

此技能需要网络访问权限以获取文档内容：

  • 首选：使用 mcp_microsoftdocs:microsoft_docs_fetch，并将查询字符串设为 from=learn-agent-skill。返回 Markdown。
  • 备用：使用 fetch_webpage，并将查询字符串设为 from=learn-agent-skill&accept=text/markdown。返回 Markdown。

类别索引

类别行描述
最佳实践L33-L38API Center 中 API 治理的最佳实践：使用托管 linting 确保风格合规，并通过 VS Code 扩展实施左移检查。
安全性L39-L44在 API Center 中配置 API 身份验证方案（密钥、OAuth 等），并通过 VS Code 扩展管理门户访问权限
配置L45-L55配置和部署 Azure API Center：备份/还原、插件市场终结点、ARM/Bicep/CLI 预配，以及定义/自定义治理元数据架构。
集成与编码模式L56-L62在 API Center 与 API Management、Amazon API Gateway 和 Copilot Studio 等平台之间同步 API 的模式和脚本，以及通过 Azure CLI 和 Logic Apps/Teams 实现自动化
部署L63-L67自动对 Azure API Center 中的 API 进行 lint 检查和注册（例如，通过 GitHub Actions），以及自托管 Azure API Center 门户的说明。
最佳实践
主题URL
使用托管 linting 确保 Azure API Center 中的 API 风格合规https://learn.microsoft.com/en-us/azure/api-center/enable-managed-api-analysis-linting
使用 VS Code 扩展实施左移 API 治理https://learn.microsoft.com/en-us/azure/api-center/govern-apis-vscode-extension
安全性
主题URL
配置 Azure API Center 中的 API 授权方案https://learn.microsoft.com/en-us/azure/api-center/authorize-api-access
通过 VS Code 扩展控制 API Center 门户访问权限https://learn.microsoft.com/en-us/azure/api-center/enable-api-center-portal-vs-code-extension
配置
主题URL
配置 Azure API Center 的备份和还原https://learn.microsoft.com/en-us/azure/api-center/backup-restore
配置 Azure API Center 插件市场终结点https://learn.microsoft.com/en-us/azure/api-center/enable-api-center-plugin-marketplace
配置 Azure API Center 治理的元数据架构https://learn.microsoft.com/en-us/azure/api-center/metadata
通过 ARM 模板创建 Azure API Centerhttps://learn.microsoft.com/en-us/azure/api-center/set-up-api-center-arm-template
使用 Azure CLI 预配 Azure API Centerhttps://learn.microsoft.com/en-us/azure/api-center/set-up-api-center-azure-cli
使用 Bicep 模板部署 Azure API Centerhttps://learn.microsoft.com/en-us/azure/api-center/set-up-api-center-bicep
在 Azure API Center 中定义自定义元数据架构https://learn.microsoft.com/en-us/azure/api-center/tutorials/add-metadata-properties
集成与编码模式
主题URL
将 Azure API Management API 导入 API Centerhttps://learn.microsoft.com/en-us/azure/api-center/import-api-management-apis
使用 Azure CLI 编写脚本管理 API Center 清单https://learn.microsoft.com/en-us/azure/api-center/manage-apis-azure-cli
使用 Logic Apps 和 Teams 自动化 API 注册通知https://learn.microsoft.com/en-us/azure/api-center/set-up-notification-workflow
部署
主题URL
在 Azure API Center 中自动化 API linting 部署https://learn.microsoft.com/en-us/azure/api-center/enable-api-analysis-linting
使用 GitHub Actions 自动将 API 注册到 API Centerhttps://learn.microsoft.com/en-us/azure/api-center/register-apis-github-actions

评论

支持 Markdown