Azure Event Grid Python 技能
帮助 Python 开发者使用 Azure Event Grid 构建可靠的事件发布流程。
文档推荐DefaultAzureCredential、生产环境限制凭据链，并避免连接字符串和API密钥，体现了较好的最小权限与凭据轮换意识；但发布事件会产生明确的外部副作用，未要求用户确认、未说明事件数据流、敏感数据处理、失败后的撤回或补偿机制，因此扣分。
同步和异步客户端、上下文管理和重试原则有说明，核心发布路径基本连贯；但不同文件对CloudEvent导入位置存在不一致，Namespace Topics示例的客户端参数和调用方式也不完全一致，未提供该技能专属测试或异常输入处理，静态证据不足，因此按上限保守扣分。
名称、场景和触发词较明确，覆盖CloudEvents、EventGridEvent、同步/异步发布及Namespace Topics；但未清楚声明接收事件、订阅管理等非适用边界，也未讨论中文使用和中国大陆网络可达性，触发精度与环境适配证据有限。
文档结构清晰，包含安装、环境变量、认证、事件类型、示例、最佳实践、引用文件，且声明MIT许可证、作者和1.0.0版本；但依赖未锁定版本，缺少变更日志、维护责任与更新路径、故障排查和已知限制，部分引用内容与主文档重复或不一致。
对常见的Python Event Grid事件发布任务提供了可直接改写的示例，涵盖单事件、批量、两种事件格式、异步和Namespace Topics，具有实际价值；但“handling CloudEvents”和完整事件驱动架构支持未被充分实现，示例缺少重试、错误处理、验证和生产级可观测性，且存在API一致性疑问，因此扣分并受静态评审上限约束。
文件提供了明确的代码、包名、环境变量和API引用线索，仓库还显示存在通用CI与测试基础设施；但所给材料没有该技能专属测试套件、真实执行结果或第三方交叉验证，结论主要来自静态文档审阅，因此不超过静态上限。
- 发布示例会向Azure Event Grid发送外部事件；在真实环境中应先确认端点、权限、事件内容和重复发布风险。
- 主文档与引用文件对CloudEvent导入路径及Namespace Topics参数用法不一致，应先对照当前SDK文档或锁定版本验证。
- 依赖版本未固定，且未提供接收/订阅、错误处理、死信或补偿流程；不宜直接视为完整生产方案。
- 未说明中国大陆网络可达性、代理或区域服务限制，相关环境需单独验证。
它能做什么 & 适用场景
此技能面向使用 Azure Event Grid SDK for Python 的开发者，指导发布 CloudEvents 和 Azure 原生 EventGridEvent。它涵盖同步与异步发布、命名空间主题、事件属性、批量发送以及重试等实践。技能推荐使用 DefaultAzureCredential，并要求客户端使用上下文管理器释放资源。它适合构建基于发布/订阅语义的事件驱动应用，但不提供完整的事件订阅消费或部署指南。
指导安装 azure-eventgrid 和 azure-identity；配置主题或命名空间端点；使用 EventGridPublisherClient 发布单个或批量 CloudEvent、EventGridEvent；配置事件类型、来源、主题、数据和扩展属性；使用同步或异步客户端；通过 DefaultAzureCredential 进行身份验证；为生产环境设置 AZURE_TOKEN_CREDENTIALS；使用上下文管理器管理客户端和异步凭据生命周期。
- Python 开发者需要从应用向 Azure Event Grid 主题发布订单创建等业务事件时。
- 团队需要采用 CloudEvents 1.0 作为可互操作事件格式时。
- 开发者需要批量发送事件并设置有意义的 subject，以支持路由和筛选时。
- 高吞吐场景需要使用 azure.eventgrid.aio 异步客户端发布事件时。
- 使用 Event Grid Namespaces 和 namespace_topic 发布事件时。
优缺点一览
- 覆盖 CloudEvents 1.0 与 Event Grid Schema 两种事件格式。
- 同时提供同步、异步和命名空间主题发布示例。
- 明确推荐 DefaultAzureCredential，并强调客户端资源的确定性释放。
- 包含批量发送、事件属性、路由筛选和重试等实践建议。
- 内容聚焦事件发布，没有提供完整的事件订阅、消费处理或接收端实现。
- 示例没有固定 azure-eventgrid 或 azure-identity 的版本。
- 需要可用的 Azure Event Grid 端点和 Entra 身份验证环境；具体权限配置未在源材料中展开。
- 仓库 README 介绍的是包含约 190 个技能的集合，不能将其他技能的能力归入本技能。
如何安装
在目标 Python 环境中运行：
pip install azure-eventgrid azure-identity
如果要安装整个仓库的技能集合，可运行 npx skills add microsoft/skills，并在向导中选择需要的技能。仓库会将技能安装到所选 Agent 的目录；本技能位于 .github/plugins/azure-sdk-python/skills/azure-eventgrid-py/。
如何使用
当任务涉及“event grid”“EventGridPublisherClient”“CloudEvent”“EventGridEvent”或“publish events”时使用此技能。先设置 EVENTGRID_TOPIC_ENDPOINT，或在命名空间场景设置 EVENTGRID_NAMESPACE_ENDPOINT；使用 DefaultAzureCredential 创建客户端，并以 with 或 async with 包裹客户端。生产环境可设置 AZURE_TOKEN_CREDENTIALS=prod。