Azure Bot Service Python 管理技能
用 Python 创建、管理和配置 Azure Bot Service 机器人及其通信渠道。
文档推荐 DefaultAzureCredential、生产环境限制凭据链、使用托管身份、通过 Key Vault 保管密钥，并提示减少启用频道，显示出一定的最小权限和敏感数据意识；但示例会直接打印 Direct Line key，主文档中的 OAuth secret 仍以占位符传入，删除操作没有确认、回滚或恢复说明，也未披露具体 RBAC 权限和完整数据流，因此扣分。
安装、认证、客户端生命周期和主要 CRUD/频道流程结构清晰，且引用文件补充了分页、长耗时操作和错误处理应验证的清单；但这些事项未实际实现或示范，未固定 SDK 版本，未提供异常输入、失败诊断或可复现测试，并且 require_envvar=True 与“本地可直接使用”存在潜在配置不一致，因此静态评分受限。
目标受众、SDK 范围、触发词和主要场景较明确，涵盖 Bot、频道及 OAuth 连接；但未清楚声明不适用范围、输入输出约束或语义误触发边界，异步场景只在原则中提及而无示例，也没有中文使用或中国大陆网络可达性说明，因此扣分。
SKILL.md 采用安装、认证、场景、操作表、最佳实践和引用文件的分层结构，包含 MIT、作者和版本元数据；仓库 README、LICENSE、SECURITY.md、CI 和维护声明提供了治理与更新背景。但该技能缺少 SDK 兼容矩阵、变更记录、FAQ、故障排查、维护责任人和明确更新路径，且引用内容有重复，因此未满分。
文档提供可直接改造的 Bot 创建、查询、列表、更新、删除、频道配置和连接设置代码，能覆盖核心管理任务；但示例缺少完整生产级错误处理、长耗时/分页模式、幂等性、删除恢复和异步实现，且未有该技能关键路径的文件内执行证据，仍需较多人工核验，因此按静态上限保守扣分。
技能内容、引用文件和仓库治理文件均可审计，仓库存在 CI、评估工作流和测试基础设施；但提供的测试未覆盖该技能的关键 Azure Bot Service 路径，也没有该技能专属验收标准、提交测试结果或第三方交叉佐证，静态证据有限。
- 不要在日志、终端输出或持久化文件中打印 Direct Line keys；应改用安全存储并说明轮换和撤销流程。
- 执行 create、update 或 delete 前应明确用户确认、目标资源范围、所需 RBAC 权限及失败后的恢复策略。
- 使用前应对照当前 azure-mgmt-botservice SDK/API 文档核验模型、方法名、长耗时操作、分页和版本兼容性；本评估未执行代码。
- 若面向中国大陆用户，应单独验证 Azure 服务端点、身份登录和依赖安装的网络可达性。
它能做什么 & 适用场景
该技能面向使用 Azure Bot Service Management SDK for Python 的开发者。它覆盖机器人的创建、查询、列表、更新和删除，以及 Teams、Direct Line 和 Web Chat 等渠道配置。技能还提供 Bot Service OAuth 连接设置和渠道密钥操作示例。认证建议使用 DefaultAzureCredential，并要求客户端使用上下文管理器释放资源。
指导安装 azure-mgmt-botservice 与 azure-identity，设置订阅和资源组环境变量，并编写 Python 代码调用 AzureBotService 客户端。代码可创建、读取、列出、更新和删除机器人，配置 Teams、Direct Line 和 Web Chat 渠道，读取渠道详情和密钥，创建并列出 OAuth 连接设置。示例还涵盖同步客户端、DefaultAzureCredential、托管身份、SKU 选择以及客户端上下文管理。
- 需要以 Python 为 Azure 订阅中的新机器人创建 Bot Service 资源的后端开发者。
- 需要在资源组或整个订阅中盘点、读取、更新或删除机器人资源的 Azure 工程师。
- 需要为机器人接入 Microsoft Teams、Direct Line 或嵌入式 Web Chat 的应用开发者。
- 需要为机器人配置 OAuth 连接设置，例如访问 Microsoft Graph 的开发团队。
- 需要在本地开发与 Azure 生产环境之间采用一致 Entra 身份认证方式的团队。
优缺点一览
- 覆盖机器人资源、渠道和 OAuth 连接设置等核心管理操作。
- 提供可复制的 Python SDK 示例，而非仅给出概念说明。
- 明确推荐 DefaultAzureCredential、托管身份和客户端上下文管理器。
- 包含 Teams、Direct Line 和 Web Chat 等常见渠道配置示例。
- 内容聚焦 Azure Bot Service 管理面，不涵盖机器人对话逻辑或消息处理应用本身。
- 示例依赖有效的 Azure 订阅、资源组和相应权限；来源未说明具体 RBAC 角色。
- 来源没有提供该单项技能的测试覆盖或失败排查清单。
- 异步客户端的原则有说明，但没有完整异步业务示例。
如何安装
安装依赖：
pip install azure-mgmt-botservice
pip install azure-identity
将该技能文件夹放入所用 Agent 的技能目录；README 明确支持通过 npx skills add microsoft/skills 安装整个集合，并可从集合中选择技能。单独安装该技能的具体命令未在来源中说明。
如何使用
向编码 Agent 提出包含以下触发词的请求：azure-mgmt-botservice、AzureBotService、bot management、conversational AI 或 bot channels。使用前设置 AZURE_SUBSCRIPTION_ID 和 AZURE_RESOURCE_GROUP；若生产环境使用 DefaultAzureCredential，还应设置 AZURE_TOKEN_CREDENTIALS=prod。随后让 Agent 生成或修改 Python 代码，例如“创建一个 F0 Azure Bot，并启用 Teams 渠道”。