ボット登録設定を構成する

この記事の対象: SDK v4

表示名、アイコン、説明などの Azure Bot リソース設定は、ボット プロファイル ウィンドウで表示および変更できます。 メッセージング エンドポイント、Microsoft アプリ ID、Application Insights などの Azure Bot リソース設定は、[構成] ウィンドウで表示および変更できます。

ボット プロファイル

ボット プロファイル フィールドの一覧を次に示します。

フィールド	説明
アイコン	各チャネルでボットを視覚的に識別したり、Microsoft Teams や他のサービスでボットをアイコンとして使用するためのカスタム アイコンです。
[表示名]	チャネルやディレクトリでのボットの名前です。 この値は後で変更できます。
ボット ハンドル	ボットの一意識別子です。 この値は、Bot Service を使ってボットを作成した後には変更できません。
説明	ボットの説明です。 一部のチャネルには説明が表示されます。 この値は後で変更できます。

変更内容を保存するには、ページの下部にある [OK] を選択します。

構成

構成フィールドの一覧を次に示します。

フィールド	説明
メッセージング エンドポイント	ボットと通信するためのエンドポイントです。
Microsoft アプリ ID	ボットの一意識別子です。 この値は変更できません。 [管理] リンクをクリックすると、新しいパスワードを生成できます。
スキーマ変換のバージョン	このボットに使用するボット スキーマ変換バージョン。 詳細情報については、「ボットをチャネルに接続する」を参照してください。
Application Insights インストルメンテーション キー	ボット テレメトリの一意キーです。 このボットのボット テレメトリを受信する場合は、このフィールドに Azure Application Insights キーをコピーします。 この値は省略可能です。 このフィールドについて詳しくは、「Application Insights キー」をご覧ください。
Application Insights API キー	ボット分析の一意キーです。 ボットに関する分析をダッシュ ボードに表示する場合は、このフィールドに Azure Application Insights API キーをコピーします。 この値は省略可能です。 このフィールドについて詳しくは、「Application Insights キー」をご覧ください。
Application Insights アプリケーション ID	ボット分析の一意の ID です。 ボットに関する分析をダッシュ ボードに表示する場合は、このフィールドに Azure Insights アプリケーション ID キーをコピーします。 この値は省略可能です。 このフィールドについて詳しくは、「Application Insights キー」をご覧ください。

変更内容を保存するには、ページの下部にある [OK] を選択します。

ボットの ID 情報

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

重要

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

Language	ファイル名	メモ
C#	appsettings.json	ボットの ID を管理するための 3 種類のアプリケーションがすべてサポートされています。
JavaScript	.env	ボットの ID を管理するための 3 種類のアプリケーションがすべてサポートされています。
Java	application.properties	マルチテナント ボットのみをサポートします。
Python	config.py	ボットの ID を管理するための 3 種類のアプリケーションがすべてサポートされています。

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

ユーザー割り当てマネージド ID

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

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

シングルテナント

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

プロパティ	値
MicrosoftAppType	SingleTenant
MicrosoftAppId	ボットのアプリ ID。
MicrosoftAppPassword	ボットのアプリ パスワード。
MicrosoftAppTenantId	ボットのアプリ テナント ID。

マルチテナント

すべてのプログラミング言語 (C#、JavaScript、Java、Python) のボットで使用できます。

プロパティ	値
MicrosoftAppType	MultiTenant
MicrosoftAppId	ボットのアプリ ID。
MicrosoftAppPassword	ボットのアプリ パスワード。
MicrosoftAppTenantId	該当なし。 マルチテナント ボットの場合は、ここを空白のままにします。

追加情報

az bot update を使用すると、コマンド ラインからボット設定を更新できます。