ボットの管理
適用対象: SDK v4
ブラウザーで Azure portal に移動します。 Azure Bot などのボット リソースを選択します。 ナビゲーション ウィンドウには、以下で説明するセクションが表示されます。
Azure Bot リソースの設定
Azure Bot リソースには、以下で説明する設定が含まれています。
全般
ナビゲーション ウィンドウの上部には、ボットに適用できる一般的な情報のリンクがあります。
| Link | 説明 |
|---|---|
| 概要 | ボットの サブスクリプション ID や メッセージング エンドポイントなど、ボットに関する高レベルの情報が含まれます。 概要ウィンドウで、ボットのソース コードをダウンロードすることもできます。 |
| アクティビティ ログ | Azure リソースと、それらが依存する Azure プラットフォームの詳細な診断および監査情報を提供します。 詳細については、「Azure プラットフォーム ログの概要」を参照してください。 |
| アクセス制御 (IAM) | ユーザーまたは他のセキュリティ プリンシパルが Azure リソースに対して持っているアクセス権を表示します。 詳細については、「Azure リソースに対するユーザーのアクセス権を表示する」を参照してください。 |
| タグ | Azure リソース、リソース グループ、サブスクリプションへのタグを表示して、それらを論理的に分類に整理します。 詳細については、タグを使用した Azure リソースの整理に関するページを参照してください。 |
設定
[ 設定] セクションには、ボットのほとんどの管理オプションのリンクがあります。
| Link | 説明 |
|---|---|
| ボット プロファイル | 表示名、アイコン、説明など、さまざまなボット プロファイル設定を管理します。 |
| 構成 | 分析、メッセージング エンドポイント、OAuth 接続設定など、さまざまなボット設定を管理します。 |
| Channels | ボットがユーザーとの通信に使用するチャネルを構成します。 |
| 料金 | ボット サービスの価格レベルを管理します。 |
| Test in Web Chat | 統合されたWeb チャット コントロールを使用して、ボットをすばやくテストします。 |
| 暗号化 | 暗号化キーを管理します。 |
| Properties | リソース ID、サブスクリプション ID、リソース グループ ID など、ボット リソースのプロパティを一覧表示します。 |
| Locks | リソース ロックを管理します。 |
監視
[ 監視 ] セクションには、ボットのほとんどの監視オプションのリンクがあります。
| Link | 説明 |
|---|---|
| 会話分析 | Application Insights を使用して、収集されたデータを分析で表示できるようにします。 この [分析] ブレードは非推奨になります。 詳細については、「 ボットにテレメトリを追加する 」および「 ボットのテレメトリ データを分析する」を参照してください。 |
| 警告 | アラート ルールを構成し、発生したアラートに参加して、Azure リソースを効率的に監視します。 詳細については、「Microsoft Azure のアラートの概要」を参照してください。 |
| メトリック | メトリックを選択して、適切なグラフにデータを表示します。 |
| 診断設定 | リソースのプラットフォーム ログとメトリックを自分が選んだ宛先にストリーム配信するためのエクスポートは、診断設定を使用して構成します。 詳細については、「 診断設定」を参照してください。 |
| ログ | Azure Monitor ログから分析情報を生成します。 |
アプリケーション サービスの設定
アプリケーション サービス (App Service) とも呼ばれるボット アプリケーションには、Azure portalを介してアクセスできる一連のアプリケーション設定があります。 これらは、ボット アプリケーション コードに渡される環境変数です。 詳細については、「Azure portalでApp Service アプリを構成する」を参照してください。
- ブラウザーで Azure portal に移動します。
- ボット アプリ サービスを検索し、その名前を選択します。
- ボット アプリ サービスの情報が表示されます。
ボット ID 情報
ボットの構成ファイルに ID 情報を追加するには、次の手順に従います。 ファイルは、ボットの作成に使用するプログラミング言語によって異なります。
重要
Bot Framework SDK の Java バージョンと Python バージョンでは、マルチテナント ボットのみがサポートされます。 C# と JavaScript のバージョンでは、ボットの ID を管理するための 3 つのアプリケーションの種類すべてがサポートされています。
| 言語 | ファイル名 | Notes |
|---|---|---|
| C# | appsettings.json | ボットの ID を管理するための 3 つのアプリケーションの種類をすべてサポートします。 |
| JavaScript | .env | ボットの ID を管理するための 3 つのアプリケーションの種類をすべてサポートします。 |
| Java | application.properties | マルチテナント ボットのみがサポートされます。 |
| Python | config.py | マルチテナント ボットのみがサポートされます。 ID プロパティをメソッド呼び出しの os.environ.get 引数として指定します。 |
追加する必要がある ID 情報は、ボットのアプリケーションの種類によって異なります。 構成ファイルに次の値を指定します。
C# および JavaScript ボットでのみ使用できます。
| プロパティ | 値 |
|---|---|
MicrosoftAppType |
UserAssignedMSI |
MicrosoftAppId |
ユーザー割り当てマネージド ID のクライアント ID。 |
MicrosoftAppPassword |
適用不可。 ユーザー割り当てマネージド ID ボットの場合は、この値を空白のままにします。 |
MicrosoftAppTenantId |
ユーザー割り当てマネージド ID のテナント ID。 |
次のステップ
Azure portalの [Bot Service] ブレードを調べてきたので、Bot Framework Service、ボットがユーザーと通信する方法、アクティビティ、チャネル、HTTP POST 要求などについて学習します。