Azure Bot Service 管理 SDK(.NET)
帮助 .NET 开发者通过 ARM 创建和管理 Azure Bot 及其渠道。
技能说明了 Azure 身份认证方式、生产环境凭据限制、Key Vault、托管身份和 DirectLine 安全站点,且未见恶意行为或隐蔽外传;但创建、更新、重生成密钥和删除资源均可能产生外部影响,没有用户确认、最小 RBAC 权限、数据流披露、删除前备份或回滚方案,因此扣分。
安装、认证、资源层级、主要 CRUD 和错误处理路径基本一致,并提供 RequestFailedException 示例;但代码未执行验证,缺少针对该技能的测试、输入校验、幂等/并发说明、重试策略和更完整的异常诊断,且 SDK 版本与 API 兼容性未被文件内证明,因此按静态上限保守扣分。
名称、描述、场景触发词、.NET SDK 范围和核心工作流较清楚;但未声明不适用场景、输入输出边界、权限前置条件或服务限制,未提供中文使用说明,也没有证据说明在中国大陆网络环境中的可达性,因此扣分。
结构清晰,包含安装、环境变量、认证、工作流、类型表、最佳实践、错误处理、相关 SDK、MIT 许可、作者和版本元数据;但缺少变更日志、维护责任与更新流程、常见问题、已知限制和可验证的版本来源,当前版本说明也可能随 SDK 更新而过时,因此扣分。
内容覆盖创建 Bot、配置多个频道、查询、更新、密钥重生成和删除,示例对常见 ARM 管理任务具有直接参考价值;但没有执行结果或 skill-specific 验证,缺少连接设置、权限配置、分页/重试、资源存在性和生产部署细节,生成代码仍需较多审查,因此限制在静态上限内并扣分。
技能提供 NuGet、API、GitHub 和 Azure 文档引用,仓库还提供通用 CI 与测试基础设施;但这些文件没有证明该技能示例已成功编译或运行,没有针对该路径的提交测试或第三方执行证据,且引用未在本材料中进行修订固定或交叉验证,因此只能给有限分数。
- 执行删除、更新或密钥重生成前必须由用户明确确认,并先确认订阅、资源组、资源名和目标环境。
- 不要把 AZURE_CLIENT_SECRET、MSA 应用凭据或 DirectLine 密钥写入源代码、日志或提示词;应使用托管身份或 Key Vault。
- 示例未证明与当前 Azure.ResourceManager.BotService 版本可编译,使用前应按锁定版本进行本地编译和集成验证。
- 未提供中国大陆网络可达性、区域可用性或服务限制说明。
它能做什么 & 适用场景
这是一个面向 Azure Bot Service 管理平面的 Agent Skill,使用 Azure.ResourceManager.BotService 和 Azure.Identity。它指导开发者通过 Azure Resource Manager 创建、读取、更新和删除 Bot 资源,并配置 Direct Line、Microsoft Teams、Web Chat、Slack 等渠道。内容还涵盖 DefaultAzureCredential、资源层级、密钥重新生成、错误处理和生产环境最佳实践。它适合负责 Azure Bot 基础设施与渠道配置的 .NET 开发者,而不是主要用于编写 Bot 对话逻辑。
指导 Agent 生成和解释 .NET C# 代码:安装 Azure.ResourceManager.BotService 与 Azure.Identity,配置 Azure 身份验证,获取订阅和资源组,创建或更新 BotResource,列出和配置 BotChannelResource,重新生成 Direct Line 密钥,读取 Bot 信息,更新或删除 Bot,并处理 RequestFailedException。
- 负责 Azure 基础设施的 .NET 开发者需要以代码创建 Azure Bot 资源。
- 团队需要为现有 Azure Bot 配置 Direct Line、Microsoft Teams 或 Web Chat 渠道。
- 运维或平台工程师需要批量读取、更新或删除资源组中的 Bot。
- 开发者需要使用 DefaultAzureCredential、服务主体或托管身份连接 Azure Resource Manager。
优缺点一览
- 覆盖 Bot 资源的完整 CRUD 管理流程。
- 提供 Direct Line、Teams、Web Chat、Slack 等多种渠道配置示例。
- 包含 DefaultAzureCredential、托管身份、异步操作和错误处理建议。
- 明确列出关键类型、SKU、Bot 类型和 MSA 应用类型。
- 范围集中在 Azure Bot Service 管理平面,不负责 Bot 对话逻辑或 Bot Framework 应用实现。
- 示例依赖真实 Azure 订阅、资源组、身份凭据和网络访问。
- 源材料未说明所需的 Azure RBAC 角色、区域限制或具体权限配置。
- 当前版本信息列出稳定版 v1.1.1 和预览版 v1.1.0-beta.1,但未提供版本选择策略。
如何安装
安装整个技能集合:运行 npx skills add microsoft/skills,然后在向导中选择所需技能。该技能位于 .github/plugins/azure-sdk-dotnet/skills/azure-mgmt-botservice-dotnet/SKILL.md。源材料未说明特定 Agent 客户端中的额外启用或调用步骤。
如何使用
向编码 Agent 提出包含触发词的请求,例如“用 .NET 创建 Azure Bot”或“配置 Azure Bot 的 DirectLine 和 Teams 渠道”。技能提供的代码使用 dotnet add package Azure.ResourceManager.BotService 和 dotnet add package Azure.Identity,并通过 ArmClient 操作订阅、资源组、Bot 和渠道。
对比同类
与源材料列出的 Microsoft.Bot.Builder 不同,本技能面向 Azure Bot 资源和渠道的 ARM 管理;Microsoft.Bot.Builder 用于 Bot Framework 应用开发。两者可以配合使用,但用途不同。