技能 Azure.ResourceManager.BotService (.NET)
📦

Azure.ResourceManager.BotService (.NET)

安全

使用 .NET SDK 管理 Azure Bot Service 资源

开发人员需要高效地预配和配置 Azure Bot Service 资源。本技能提供全面的指导，帮助用户使用 Azure Resource Manager .NET SDK 管理机器人资源、通道和连接设置。

支持: Claude Codex Code(CC)
🥉 72 青铜
1

下载技能 ZIP

2

在 Claude 中上传

前往 设置 → 功能 → 技能 → 上传技能

3

开启并开始使用

测试它

正在使用“Azure.ResourceManager.BotService (.NET)”。 在 West US 2 创建名为 'CustomerSupportBot' 的机器人并启用 Teams 通道

预期结果:

机器人 'CustomerSupportBot' 在 West US 2 创建成功。Teams 通道已配置（呼叫功能已禁用）。机器人端点：https://customer-support-bot.azurewebsites.net/api/messages

正在使用“Azure.ResourceManager.BotService (.NET)”。 列出机器人 'MyAssistant' 的所有通道

预期结果:

MyAssistant 的通道：
- DirectLineChannel (已启用：True, 安全站点：True)
- MsTeamsChannel (已启用：True, 呼叫：False)
- WebChatChannel (已启用：True)

正在使用“Azure.ResourceManager.BotService (.NET)”。 为 Default Site 再生 DirectLine 密钥

预期结果:

已成功为 'Default Site' 再生 DirectLine 密钥。新的主密钥已可用。旧密钥将在过渡期间保持有效 10 分钟。

安全审计

安全
v1 • 2/25/2026

This skill contains documentation and code examples for the Azure Resource Manager BotService SDK. Static analysis scanned 0 files with 0 lines, detecting no security patterns. The skill is prompt-only content with no executable code, making it safe for publication. All code examples demonstrate proper Azure SDK patterns including DefaultAzureCredential for authentication.

0
已扫描文件
0
分析行数
0
发现项
1
审计总数
未发现安全问题
审计者: claude

质量评分

38
架构
100
可维护性
87
内容
50
社区
100
安全
74
规范符合性

你能构建什么

自动化机器人部署的 DevOps 工程师

使用 CI/CD 流水线自动化跨多个环境的机器人资源预配，并实现适当的凭证管理。

构建多通道机器人的开发人员

为单个机器人资源配置多个通信通道，以便通过 Teams、Web Chat 和 DirectLine 集成触达用户。

管理机器人凭证的安全管理员

为具有严格安全要求的企业机器人部署实施密钥轮换策略并管理 OAuth 连接设置。

试试这些提示

初学者：创建基础机器人资源 
帮助我在订阅中创建一个新的 Azure Bot 资源。我需要使用 DefaultAzureCredential 进行身份验证，在需要时创建资源组，并使用免费层级 (F0) SKU 部署机器人。请展示包含适当错误处理的完整 C# 代码。
中级：配置多个通道 
我已有一个现有的机器人资源，需要启用 Microsoft Teams 和 DirectLine 通道。请展示如何配置 Teams 通道（禁用呼叫功能）并设置具有安全站点的 DirectLine。包含验证通道成功创建的代码。
高级：实施密钥轮换 
我们的安全策略要求每季度轮换 DirectLine 通道密钥。请展示如何以编程方式为 Default Site 再生密钥、检索新密钥，并使用 Azure SDK 将轮换后的凭据更新到 Azure Key Vault。
专家级：多环境机器人管理 
我需要在开发、暂存和生产环境中部署相同的机器人配置，但各环境具有特定设置。创建一个使用 ARM SDK 的解决方案，用于创建具有不同 SKU 的机器人（开发环境使用 F0，生产环境使用 S1），相应地配置通道，并为每个环境实现适当的错误处理。

最佳实践

  • 使用 DefaultAzureCredential 实现灵活的身份验证，支持开发和生产环境
  • 将 MSA App ID 和密钥等敏感凭据存储在 Azure Key Vault 中，而不是环境变量中
  • 在生产环境中为 DirectLine 通道启用安全站点，要求基于令牌的身份验证

避免

  • 将客户端密钥或连接字符串直接硬编码在源代码中
  • 对于新部署使用传统的 BotServiceKind.Bot 而不是推荐的 Azurebot 类型
  • 对必须在继续前完成的操作跳过 WaitUntil.Completed

常见问题

此 SDK 支持哪些身份验证方法？
SDK 使用 Azure.Identity 的 DefaultAzureCredential，支持多种方法：Visual Studio 凭据、Azure CLI 凭据、托管标识、环境变量和基于证书的服务主体。它按顺序尝试每种方法直到成功认证。
我可以使用此 SDK 从我的机器人发送消息吗？
不，此 SDK 仅处理管理平面操作（创建、更新、删除机器人资源）。要发送和接收消息，请改用 Microsoft.Bot.Builder SDK 包。
如何处理 Azure Resource Manager API 的速率限制？
SDK 会在遇到速率限制响应时自动重试。对于自定义处理，请捕获 RequestFailedException 并检查 ErrorCode 是否指示节流。对于高容量操作，请考虑实施指数退避。
创建机器人资源需要哪些权限？
您需要在资源组上具有 Contributor 或 Owner 角色，或者具有 Microsoft.BotService/bots/write 和 Microsoft.BotService/bots/channels/write 权限的自定义角色。读取操作请使用 Microsoft.BotService/bots/read。
如何为我的机器人配置 OAuth 连接？
使用 BotConnectionSettingResource 创建 OAuth 连接设置。这需要配置具有适当重定向 URI 和目标身份提供商权限的 Azure AD 应用注册。
我可以跨多个订阅管理机器人吗？
是的，为每个订阅创建单独的 ArmClient 实例，或使用 ArmClient 按 ID 获取特定订阅。您可以遍历凭据可访问的所有订阅以实现跨订阅管理。

开发者详情

作者

sickn33

许可证

MIT

仓库

https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/azure-mgmt-botservice-dotnet

引用

main

文件结构

📄 SKILL.md