开发与工程 ✓ Microsoft · 官方 azure-bot-servicedotnetazure-resource-managerbot-managementdirectlinemicrosoft-teamsazure-identity

Azure Bot Service 管理 SDK(.NET)

帮助 .NET 开发者通过 ARM 创建和管理 Azure Bot 及其渠道。

FollowSkills 评估 · FSRS-2.0
不推荐
48/ 100 五分制 2.4 / 5
信任安全14 / 25 · 2.8/5

技能说明了 Azure 身份认证方式、生产环境凭据限制、Key Vault、托管身份和 DirectLine 安全站点,且未见恶意行为或隐蔽外传;但创建、更新、重生成密钥和删除资源均可能产生外部影响,没有用户确认、最小 RBAC 权限、数据流披露、删除前备份或回滚方案,因此扣分。

可靠稳定8 / 20 · 2.0/5

安装、认证、资源层级、主要 CRUD 和错误处理路径基本一致,并提供 RequestFailedException 示例;但代码未执行验证,缺少针对该技能的测试、输入校验、幂等/并发说明、重试策略和更完整的异常诊断,且 SDK 版本与 API 兼容性未被文件内证明,因此按静态上限保守扣分。

适用触发8 / 15 · 2.7/5

名称、描述、场景触发词、.NET SDK 范围和核心工作流较清楚;但未声明不适用场景、输入输出边界、权限前置条件或服务限制,未提供中文使用说明,也没有证据说明在中国大陆网络环境中的可达性,因此扣分。

规范维护8 / 15 · 2.7/5

结构清晰,包含安装、环境变量、认证、工作流、类型表、最佳实践、错误处理、相关 SDK、MIT 许可、作者和版本元数据;但缺少变更日志、维护责任与更新流程、常见问题、已知限制和可验证的版本来源,当前版本说明也可能随 SDK 更新而过时,因此扣分。

有效结果6 / 15 · 2.0/5

内容覆盖创建 Bot、配置多个频道、查询、更新、密钥重生成和删除,示例对常见 ARM 管理任务具有直接参考价值;但没有执行结果或 skill-specific 验证,缺少连接设置、权限配置、分页/重试、资源存在性和生产部署细节,生成代码仍需较多审查,因此限制在静态上限内并扣分。

证据核验4 / 10 · 2.0/5

技能提供 NuGet、API、GitHub 和 Azure 文档引用,仓库还提供通用 CI 与测试基础设施;但这些文件没有证明该技能示例已成功编译或运行,没有针对该路径的提交测试或第三方执行证据,且引用未在本材料中进行修订固定或交叉验证,因此只能给有限分数。

证据充分度: 评估于 2026年7月20日 审查版本 9ccaf7c3704a
使用前请注意
  • 执行删除、更新或密钥重生成前必须由用户明确确认,并先确认订阅、资源组、资源名和目标环境。
  • 不要把 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。

  1. 负责 Azure 基础设施的 .NET 开发者需要以代码创建 Azure Bot 资源。
  2. 团队需要为现有 Azure Bot 配置 Direct Line、Microsoft Teams 或 Web Chat 渠道。
  3. 运维或平台工程师需要批量读取、更新或删除资源组中的 Bot。
  4. 开发者需要使用 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.BotServicedotnet add package Azure.Identity,并通过 ArmClient 操作订阅、资源组、Bot 和渠道。

对比同类

与源材料列出的 Microsoft.Bot.Builder 不同,本技能面向 Azure Bot 资源和渠道的 ARM 管理;Microsoft.Bot.Builder 用于 Bot Framework 应用开发。两者可以配合使用,但用途不同。

常见问题

这个技能是否免费?
技能仓库采用 MIT 许可证。源材料未提供 Azure Bot 资源或相关服务的费用信息。
使用它需要哪些 Azure 信息?
示例要求 Azure 订阅 ID;使用服务主体时还可配置租户 ID、客户端 ID 和客户端密钥。生产环境建议使用托管身份或安全存储凭据。
它能管理哪些渠道?
源材料列出了 Direct Line、Direct Line Speech、Microsoft Teams、Web Chat、Slack、Facebook、Email、Telegram 和 Telephony。
如果 ARM 操作失败怎么办?
示例建议捕获 `RequestFailedException`,根据 HTTP 状态码和错误代码处理,例如将 409 识别为资源已存在。

同仓库的其他 Skills

均来自 microsoft/agent-skills

开发与工程 ✓ Microsoft · 官方

Azure Identity Python 认证技能

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

开发与工程 ✓ Microsoft · 官方

Azure Event Hubs Java 开发技能

帮助 Java 开发者构建高吞吐、可 checkpoint 的 Azure 事件流应用。

开发与工程 ✓ Microsoft · 官方

Azure Tables Python 技能

帮助 Python 开发者使用 Azure Tables 完成安全认证、实体管理、查询与批量事务操作。

开发与工程 ✓ Microsoft · 官方

Azure Identity TypeScript

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

自动化与运维 ✓ Microsoft · 官方

Azure 应用可靠性顾问

评估并提升 Azure Functions 与 App Service 的可靠性。

开发与工程 ✓ Microsoft · 官方

Azure 云架构师

帮助编码代理按照 Azure 架构中心最佳实践设计和审查生产级云系统。

开发与工程 ✓ Microsoft · 官方

Azure AI 文本分析 Python 技能

为 Python 开发者提供 Azure 文本分析与自然语言处理集成指导。

自动化与运维 ✓ Microsoft · 官方

Azure 资源架构可视化器

分析 Azure 资源组及其依赖关系,生成详细的 Mermaid 架构图。

开发与工程 ✓ Microsoft · 官方

Azure Maps .NET 开发技能

为 .NET 应用提供地理搜索、路线、地图、定位与天气开发指导。

开发与工程 ✓ Microsoft · 官方

Azure AI Vision 图像分析技能

为 Python 编码代理提供 Azure AI Vision 图像理解实现指南。

开发与工程 ✓ Microsoft · 官方

Azure Blob Storage Python 技能

帮助 Python 开发者安全高效地操作 Azure Blob Storage。

开发与工程 ✓ Microsoft · 官方

Azure Queue Storage Python 技能

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

自动化与运维 ✓ Microsoft · 官方

Azure AI 网关治理

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

自动化与运维 ✓ Microsoft · 官方

AKS Automatic 就绪评估

评估 Kubernetes 工作负载能否迁移到 AKS Automatic,并定位兼容性阻塞项。

开发与工程 ✓ Microsoft · 官方

Azure Cosmos DB .NET 资源管理技能

用 .NET 通过 ARM 部署和管理 Azure Cosmos DB 资源。

开发与工程 ✓ Microsoft · 官方

Azure Playwright 工作区管理技能

用 .NET 通过 Azure Resource Manager 配置和管理 Microsoft Playwright Testing 工作区。

开发与工程 ✓ Microsoft · 官方

Azure Cosmos DB Python 技能

帮助 Python 开发者可靠地构建和操作 Azure Cosmos DB NoSQL 应用。

开发与工程 ✓ Microsoft · 官方

Azure Key Vault Python SDK 技能

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

开发与工程 ✓ Microsoft · 官方

Azure API Management Python 技能

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

开发与工程 ✓ Microsoft · 官方

Azure Monitor 查询 Python 技能

帮助 Python 开发者查询 Azure Monitor 日志与指标。

相关 Skills