azure-mgmt-botservice-dotnet

Name: azure-mgmt-botservice-dotnet
Author: sickn33

github.com/sickn33クラウド・DevOps48.7k49 回インストール今日更新

azure-mgmt-botservice-dotnet について

azure-mgmt-botservice-dotnetは、Azure Resource Managerを通じてAzure Bot Serviceリソースを管理する.NETスキルです。Botの作成やライフサイクル操作、チャネル設定、接続設定、キー再生成を扱い、過去の例の検証と認証情報や破壊的変更の慎重な管理を促します。

主な機能

01Botリソースの作成と更新
02対応チャネルの設定
03Botとチャネルの一覧表示
04OAuth接続設定の管理
05DirectLineキーの再生成

活用シーン

01Azure Botリソースの作成
02Web ChatまたはTeamsチャネルの設定
03設定済みBotチャネルの確認
04慎重なDirectLineキーのローテーション

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/sickn33/agentic-awesome-skills --skill azure-mgmt-botservice-dotnet

インストール後、Claude Code で/azure-mgmt-botservice-dotnetを入力して読み込まれたか確認します。

詳細

Azure.ResourceManager.BotService（.NET）

Azure Resource Manager を介して Azure Bot Service リソースをプロビジョニングおよび管理するための管理プレーン SDK です。

プロビジョニングとライフサイクルの対象範囲

これらは過去の SDK の断片です。リソースを作成する前に、現在のパッケージとサービスのライフサイクル、サポートされるアプリ ID の種類、対象テナントを確認してください。新しいボットで、すべてのチャネルやマルチテナント構成を利用できるとは限りません。意図しない既定値に頼らず、対象のサブスクリプションとリソースグループを正確に選択してください。パッケージのバージョンを固定し、署名とインポートを検証して、承認済みのテストリソースを使用してください。チャネルを作成するとメッセージングの接点が公開されます。また、ボットを削除したり DirectLine キーを再生成したりすると、クライアントが中断される場合があります。対応するユーザー権限を確認し、段階的にローテーションを行い、返されたキーがログに記録されないよう保護してください。本番環境で使用する資格情報チェーンは、意図的に選択してください。

インストール

dotnet add package Azure.ResourceManager.BotService
dotnet add package Azure.Identity

過去のサンプルバージョン：v1.1.1 / v1.1.0-beta.1。使用前に、サポートされるバージョンと移行ガイダンスを確認してください。

環境変数

AZURE_SUBSCRIPTION_ID=<your-subscription-id>
# For service principal auth (optional)
AZURE_TENANT_ID=<tenant-id>
AZURE_CLIENT_ID=<client-id>
AZURE_CLIENT_SECRET=<client-secret>

認証

using Azure.Identity;
using Azure.ResourceManager;
using Azure.ResourceManager.BotService;

// Authenticate using DefaultAzureCredential
var credential = new DefaultAzureCredential();
ArmClient armClient = new ArmClient(credential);

// Get subscription and resource group
SubscriptionResource subscription = await armClient.GetDefaultSubscriptionAsync();
ResourceGroupResource resourceGroup = await subscription.GetResourceGroups().GetAsync("myResourceGroup");

// Access bot collection
BotCollection botCollection = resourceGroup.GetBots();

リソース階層

ArmClient
└── SubscriptionResource
    └── ResourceGroupResource
        └── BotResource
            ├── BotChannelResource (DirectLine, Teams, Slack, etc.)
            ├── BotConnectionSettingResource (OAuth connections)
            └── BotServicePrivateEndpointConnectionResource

主なワークフロー

1. ボットリソースを作成する

using Azure.ResourceManager.BotService;
using Azure.ResourceManager.BotService.Models;

// Create bot data
var botData = new BotData(AzureLocation.WestUS2)
{
    Kind = BotServiceKind.Azurebot,
    Sku = new BotServiceSku(BotServiceSkuName.F0),
    Properties = new BotProperties(
        displayName: "MyBot",
        endpoint: new Uri("https://mybot.azurewebsites.net/api/messages"),
        msaAppId: "<your-msa-app-id>")
    {
        Description = "My Azure Bot",
        MsaAppType = BotMsaAppType.MultiTenant
    }
};

// Create or update the bot
ArmOperation<BotResource> operation = await botCollection.CreateOrUpdateAsync(
    WaitUntil.Completed, 
    "myBotName", 
    botData);
    
BotResource bot = operation.Value;
Console.WriteLine($"Bot created: {bot.Data.Name}");

2. DirectLine チャネルを構成する

// Get the bot
BotResource bot = await resourceGroup.GetBots().GetAsync("myBotName");

// Get channel collection
BotChannelCollection channels = bot.GetBotChannels();

// Create DirectLine channel configuration
var channelData = new BotChannelData(AzureLocation.WestUS2)
{
    Properties = new DirectLineChannel()
    {
        Properties = new DirectLineChannelProperties()
        {
            Sites = 
            {
                new DirectLineSite("Default Site")
                {
                    IsEnabled = true,
                    IsV1Enabled = false,
                    IsV3Enabled = true,
                    IsSecureSiteEnabled = true
                }
            }
        }
    }
};

// Create or update the channel
ArmOperation<BotChannelResource> channelOp = await channels.CreateOrUpdateAsync(
    WaitUntil.Completed,
    BotChannelName.DirectLineChannel,
    channelData);

Console.WriteLine("DirectLine channel configured");

3. Microsoft Teams チャネルを構成する

var teamsChannelData = new BotChannelData(AzureLocation.WestUS2)
{
    Properties = new MsTeamsChannel()
    {
        Properties = new MsTeamsChannelProperties()
        {
            IsEnabled = true,
            EnableCalling = false
        }
    }
};

await channels.CreateOrUpdateAsync(
    WaitUntil.Completed,
    BotChannelName.MsTeamsChannel,
    teamsChannelData);

4. Web Chat チャネルを構成する

var webChatChannelData = new BotChannelData(AzureLocation.WestUS2)
{
    Properties = new WebChatChannel()
    {
        Properties = new WebChatChannelProperties()
        {
            Sites =
            {
                new WebChatSite("Default Site")
                {
                    IsEnabled = true
                }
            }
        }
    }
};

await channels.CreateOrUpdateAsync(
    WaitUntil.Completed,
    BotChannelName.WebChatChannel,
    webChatChannelData);

5. ボットを取得してチャネルを一覧表示する

// Get bot
BotResource bot = await botCollection.GetAsync("myBotName");
Console.WriteLine($"Bot: {bot.Data.Properties.DisplayName}");
Console.WriteLine($"Endpoint: {bot.Data.Properties.Endpoint}");

// List channels
await foreach (BotChannelResource channel in bot.GetBotChannels().GetAllAsync())
{
    Console.WriteLine($"Channel: {channel.Data.Name}");
}

6. DirectLine キーを再生成する

var regenerateRequest = new BotChannelRegenerateKeysContent(BotChannelName.DirectLineChannel)
{
    SiteName = "Default Site"
};

BotChannelResource channelWithKeys = await bot.GetBotChannelWithRegenerateKeysAsync(regenerateRequest);

7. ボットを更新する

BotResource bot = await botCollection.GetAsync("myBotName");

// Update using patch
var updateData = new BotData(bot.Data.Location)
{
    Properties = new BotProperties(
        displayName: "Updated Bot Name",
        endpoint: bot.Data.Properties.Endpoint,
        msaAppId: bot.Data.Properties.MsaAppId)
    {
        Description = "Updated description"
    }
};

await bot.UpdateAsync(updateData);

8. ボットを削除する

BotResource bot = await botCollection.GetAsync("myBotName");
await bot.DeleteAsync(WaitUntil.Completed);

サポートされるチャネルの種類

チャネル	定数	クラス
Direct Line	`BotChannelName.DirectLineChannel`	`DirectLineChannel`
Direct Line Speech	`BotChannelName.DirectLineSpeechChannel`	`DirectLineSpeechChannel`
Microsoft Teams	`BotChannelName.MsTeamsChannel`	`MsTeamsChannel`
Web Chat	`BotChannelName.WebChatChannel`	`WebChatChannel`
Slack	`BotChannelName.SlackChannel`	`SlackChannel`
Facebook	`BotChannelName.FacebookChannel`	`FacebookChannel`
Email	`BotChannelName.EmailChannel`	`EmailChannel`
Telegram	`BotChannelName.TelegramChannel`	`TelegramChannel`
Telephony	`BotChannelName.TelephonyChannel`	`TelephonyChannel`

主な型のリファレンス

型	用途
`ArmClient`	すべての ARM 操作のエントリポイント
`BotResource`	Azure Bot リソースを表します
`BotCollection`	ボットの CRUD 操作用コレクション
`BotData`	ボットリソースの定義
`BotProperties`	ボットの構成プロパティ
`BotChannelResource`	チャネルの構成
`BotChannelCollection`	チャネルのコレクション
`BotChannelData`	チャネル構成データ
`BotConnectionSettingResource`	OAuth 接続設定

BotServiceKind の値

値	説明
`BotServiceKind.Azurebot`	Azure Bot（推奨）
`BotServiceKind.Bot`	従来の Bot Framework ボット
`BotServiceKind.Designer`	Composer ボット
`BotServiceKind.Function`	Function ボット
`BotServiceKind.Sdk`	SDK ボット

BotServiceSkuName の値

値	説明
`BotServiceSkuName.F0`	無料プラン
`BotServiceSkuName.S1`	Standard プラン

BotMsaAppType の値

値	説明
`BotMsaAppType.MultiTenant`	マルチテナントアプリ
`BotMsaAppType.SingleTenant`	シングルテナントアプリ
`BotMsaAppType.UserAssignedMSI`	ユーザー割り当てマネージド ID

ベストプラクティス

常に DefaultAzureCredential を使用する — 複数の認証方法をサポートします
同期操作には WaitUntil.Completed を使用する
API エラーには RequestFailedException を処理する
すべての操作で非同期メソッド（*Async）を使用する
MSA アプリの資格情報を安全に保存する — シークレットには Key Vault を使用する
本番環境のボットにはマネージド ID（BotMsaAppType.UserAssignedMSI）を使用する
本番環境の DirectLine チャネルではセキュアサイトを有効にする

エラー処理

using Azure;

try
{
    var operation = await botCollection.CreateOrUpdateAsync(
        WaitUntil.Completed, 
        botName, 
        botData);
}
catch (RequestFailedException ex) when (ex.Status == 409)
{
    Console.WriteLine("Bot already exists");
}
catch (RequestFailedException ex)
{
    Console.WriteLine($"ARM Error: {ex.Status} - {ex.ErrorCode}: {ex.Message}");
}

参考リンク

リソース	URL
NuGet パッケージ	https://www.nuget.org/packages/Azure.ResourceManager.BotService
API リファレンス	https://learn.microsoft.com/dotnet/api/azure.resourcemanager.botservice
GitHub ソース	https://github.com/Azure/azure-sdk-for-net/tree/main/sdk/botservice/Azure.ResourceManager.BotService
Azure Bot Service ドキュメント	https://learn.microsoft.com/azure/bot-service/

使用する場面

このスキルは、概要に記載されているワークフローまたはアクションを実行する場合に適用できます。

制限事項

このスキルは、タスクが上記の範囲に明確に該当する場合にのみ使用してください。
出力を、環境固有の検証、テスト、または専門家によるレビューの代替として扱わないでください。
必要な入力、権限、安全上の境界、または成功基準が不足している場合は、作業を中止して確認してください。

Markdown 対応

ログインしてコメント

基本情報

作者: sickn33
リポジトリ: sickn33/agentic-awesome-skills
カテゴリ: クラウド・DevOps
インストール数: 49
GitHub スター: 48,675

問題を報告

おすすめの Skills

すべての Skills

lark-apps

open.feishu.cn

732.0k

Miaoda（Spark/Miaoda）アプリの開発とホスティング：アプリの作成、ローカルでのフルスタック開発、クラウドでの生成と反復、クリエイティブデザイン（UI モックアップ／インタラクティブなプロトタイプ／ワイヤーフレーム／ランディングページ／ダッシュボード／スライドデッキ／ビジュアル探索）、AI 関連機能や Feishu プラットフォーム機能、その他の外部機能との統合、ログ／Trace／監視指標／PV／UV の確認、環境変数の管理、アプリのコラボレーターと共同作業権限の設定、アプリのロールとメンバーの管理、自動化トリガー（スケジュール／レコード変更／Webhook／Feishu 承認）。システム・ツール・プラットフォーム・アプリの開発や新規作成、ローカル／クラウドでの開発、変更、デプロイ、公開、リリース、共有可能なリンクの取得、HTML によるページやウェブサイトの作成と Miaoda へのデプロイ、デザイン／モックアップ／プロトタイプ／ワイヤーフレーム／PPT／デッキ／ビジュアル探索を希望する場合に使用。また、Miaoda/Spark/Miaoda アプリ（`/app/app_xxx` または `/page/<token>` 形式のリンク、*.aiforce.cloud 形式の実行時ドメイン）、アプリデータベース、アプリファイルストレージ、公開 API Key、公開範囲、アプリのコラボレーター／開発権限、アプリのロール／ロールメンバー、本番ログ、API リクエスト数、エラー数、レイテンシ、アクセス数、環境変数、Miaoda アプリの自動化タスク／スケジュールトリガー／承認後の自動トリガーに関する場合にも使用。通常のクラウドドライブへのファイルアップロード（lark-drive）、Feishu ドキュメントの編集（lark-doc）、ネイティブのスライド作成（lark-slides）は対象外。

azure-prepare

github.com/microsoft

571.7k

azd ベースの Azure プロジェクトをデプロイ用に準備します。Azure Developer CLI (azd) ワークフロー向けに azure.yaml、インフラストラクチャ (Bicep/Terraform)、Dockerfile を生成します。ユーザーが明示的に azd をデプロイメントツールとして使いたい場合、または既に azure.yaml ファイルが存在する場合にのみ使用してください。非 azd デプロイメント、Python App Service コードのみのデプロイ (python-appservice-deploy を使用)、クラウド間の移行 (azure-cloud-migrate を使用) には使用しないでください。用途：azd 用にアプリを準備、azure.yaml を作成、azd インフラストラクチャを設定、Azure 上でアプリを最新化、azd でデプロイ、関数アプリ、タイマートリガー、Service Bus トリガー、イベント駆動関数、マネージド ID、Bicep を生成、Terraform を生成、Azure に作成してデプロイ。

wizard

github.com/mattpocock

571.5k

人間にしか実行できない手順を案内する、対話型の bash ウィザードを生成します。インフラのプロビジョニング、認証情報や CI シークレットの設定、不慣れなサードパーティ製ダッシュボードの操作、一度限りの移行や切り替えに使用します。エージェント自身が実行できる手順には使用しません。

azure-ai

github.com/microsoft

571.2k

Azure AI（検索、音声、OpenAI、Document Intelligence）で使用します。検索、ベクトル/ハイブリッド検索、音声テキスト変換、テキスト音声変換、トランスクリプション、OCR に対応。用途：AI 検索、クエリ検索、ベクトル検索、ハイブリッド検索、セマンティック検索、音声テキスト変換、テキスト音声変換、トランスクリプション、OCR、テキストを音声に変換。

SDK	目的	インストール
`Azure.ResourceManager.BotService`	ボット管理（この SDK）	`dotnet add package Azure.ResourceManager.BotService`
`Microsoft.Bot.Builder`	Bot Framework SDK	`dotnet add package Microsoft.Bot.Builder`
`Microsoft.Bot.Builder.Integration.AspNet.Core`	ASP.NET Core 統合	`dotnet add package Microsoft.Bot.Builder.Integration.AspNet.Core`

azure-mgmt-botservice-dotnet

azure-mgmt-botservice-dotnet について

主な機能

活用シーン

インストール

詳細

Azure.ResourceManager.BotService（.NET）

プロビジョニングとライフサイクルの対象範囲

インストール

環境変数

認証

リソース階層

主なワークフロー

1. ボットリソースを作成する

2. DirectLine チャネルを構成する

3. Microsoft Teams チャネルを構成する

4. Web Chat チャネルを構成する

5. ボットを取得してチャネルを一覧表示する

6. DirectLine キーを再生成する

7. ボットを更新する

8. ボットを削除する

サポートされるチャネルの種類

主な型のリファレンス

BotServiceKind の値

BotServiceSkuName の値

BotMsaAppType の値

ベストプラクティス

エラー処理

関連 SDK

参考リンク

使用する場面

制限事項

コメント