技能 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)」。 在西區 2 建立名為 'CustomerSupportBot' 的機器人並啟用 Teams 頻道

預期結果:

機器人 'CustomerSupportBot' 已成功建立在西區 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 頻道金鑰。請示範如何使用 Azure SDK 以程式化方式為 Default Site 重新產生金鑰、擷取新金鑰,並將輪替後的憑證更新到 Azure Key Vault。
專家:多環境機器人管理
我需要跨開發、預備和生產環境部署具有環境特定設定的相同機器人配置。建立一個使用 ARM SDK 的解決方案,以建立具有不同 SKU 的機器人(開發環境使用 F0,生產環境使用 S1),適當配置頻道,並為每個環境實作適當的錯誤處理。

最佳實務

  • 使用 DefaultAzureCredential 進行彈性驗證,支援開發和生產環境
  • 將 MSA App ID 和密碼等敏感憑證儲存在 Azure Key Vault 中,而非環境變數
  • 在生產環境中為 DirectLine 頻道啟用安全站點,以要求基於 Token 的驗證

避免

  • 直接在原始程式碼中硬編碼客戶端密碼或連線字串
  • 對於新部署使用舊版的 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 會在遇到速率限制回應時自動重試。如需自訂處理,請catch 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 取得特定訂閱。您可以迭代憑證可存取的所有訂閱以進行跨訂閱管理。

開發者詳情

檔案結構

📄 SKILL.md