ボットの管理

  • [アーティクル]

この記事の対象: SDK v4

ブラウザーで Azure portal に移動します。 Azure Bot などのボット リソースを選択します。 ナビゲーション ウィンドウには、以下で説明するセクションが表示されます。

Azure Bot リソースの設定

Azure Bot リソースには、以下で説明する設定が含まれています。

全般

ナビゲーション ウィンドウの上部には、ボットに適用できる一般的な情報のリンクがあります。

リンク 説明
概要 ボットのサブスクリプション ID やメッセージング エンドポイントなど、ボットに関する高レベルの情報が含まれています。 概要ウィンドウでは、ボットのソース コードをダウンロードすることもできます。
アクティビティ ログ Azure リソースとそれらが依存している Azure プラットフォームの詳細な診断情報と監査情報が提供されます。 詳細については、「Azure プラットフォーム ログの概要」を参照してください。
アクセス制御 (IAM) ユーザーまたは他のセキュリティ プリンシパルが Azure リソースに対して持つアクセス権を表示します。 詳細については、「Azure リソースに対するユーザーのアクセス権を表示する」を参照してください。
タグ Azure リソース、リソース グループ、サブスクリプションのタグを表示して、それらを論理的に分類できます。 詳細については、タグを使用した Azure リソースの整理に関するページを参照してください。

設定

[設定]セクションには、ほとんどのボット管理オプションのリンクがあります。

リンク 説明
ボット プロファイル 表示名、アイコン、説明など、さまざまなボット プロファイル設定を管理します。
Configuration 分析、メッセージング エンドポイント、OAuth 接続設定など、さまざまなボット設定を管理します。
チャネル ボットがユーザーとの通信に使用するチャネルを構成します。
料金 ボット サービスの価格レベルを管理します。
Web チャットでのテスト 統合 Web チャット コントロールを使用して、ボットを簡単にテストします。
暗号化 暗号化キーを管理します。
プロパティ リソース ID、サブスクリプション ID、リソース グループ ID など、ボット リソースのプロパティを一覧表示します。
Locks リソース ロックを管理します。

監視

[監視] セクションには、ほとんどのボット監視オプションのリンクがあります。

リンク 説明
会話分析 Application Insights を使用して、収集されたデータを分析で表示できるようにします。 この [分析] ブレードは非推奨になります。 詳細については、「ボットにテレメトリを追加する」および「ボットのテレメトリ データを分析する」を参照してください。
警告 監視効率を向上させるには、Azure リソースに関する警告ルールを構成し、起動したアラートに対応してください。 詳細については、「Microsoft Azure のアラートの概要」を参照してください。
メトリック メトリックを選択して、適切なグラフにデータを表示します。
診断設定 リソースのプラットフォーム ログとメトリックの選択した宛先へのストリーミング エクスポートを構成するため、診断設定を使用します。 詳細については、「診断の設定」を参照してください。
ログ Azure Monitor ログから分析情報を生成します。

アプリケーション サービスの設定

アプリケーション サービス (App Service) とも呼ばれるボット アプリケーションには、Azure portal からアクセスできる一連のアプリケーション設定があります。 これらは、ボット アプリケーション コードに渡される環境変数です。 詳細については、「Azure portal での App Service アプリの構成」を参照してください。

  1. ブラウザーで Azure portal に移動します。
  2. ボット アプリ サービスを検索し、その名前を選択します。
  3. ボット アプリ サービス情報が表示されます。

ボットの ID 情報

ボットの構成ファイルに ID 情報を追加するには、次の手順に従います。 ファイルは、ボットの作成に使用するプログラミング言語によって異なります。

重要

Java バージョンと Python バージョンの Bot Framework SDK では、マルチテナント ボットのみがサポートされます。 C# バージョンと JavaScript バージョンでは、ボットの ID を管理するための 3 種類のアプリケーションがすべてサポートされています。

言語 ファイル名 メモ
C# appsettings.json ボットの ID を管理するための 3 つのアプリケーションの種類がすべてサポートされています。
JavaScript .env ボットの ID を管理するための 3 つのアプリケーションの種類がすべてサポートされています。
Java アプリケーション プロパティ: マルチテナント ボットのみサポートしています。
Python config.py マルチテナント ボットのみサポートしています。 os.environ.get メソッド呼び出しの引数として ID プロパティを指定します。

追加する必要がある ID 情報は、ボットのアプリケーションの種類によって異なります。 構成ファイルに次の値を指定します。

C# および JavaScript ボットでのみ使用できます。

プロパティ 値
MicrosoftAppType UserAssignedMSI
MicrosoftAppId ユーザー割り当てマネージド ID のクライアント ID。
MicrosoftAppPassword 該当なし。 ユーザー割り当てマネージド ID ボットの場合は、ここを空白のままにします。
MicrosoftAppTenantId ユーザー割り当てマネージド ID のテナント ID。

次のステップ

これでAzure portal の [Bot Service] ブレードを確認できました。次は、Bot Framework Service、ボットがユーザーと通信する方法、アクティビティ、チャネル、HTTP POST 要求などについて学習します。

ボットのしくみ