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

  • [アーティクル]

この記事の対象: 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 バージョンでは、マルチテナント ボットのみがサポートされています。 Python バージョンの Bot Framework SDK では、マルチテナント ボットとシングルテナント ボットがサポートされています。 C# バージョンと JavaScript バージョンでは、ボットの ID を管理するための 3 種類のアプリケーションがすべてサポートされています。

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

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

Java と C# ボットでのみ使用できます。

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

追加情報

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