Bot Framework Azure についてのよくある質問

この記事では、Azure でよく寄せられる質問に回答します。

この記事の対象: SDK v4

アプリケーションの登録はどのように作成するのですか?

独自のアプリ登録は、次の場合に作成できます。

• Bot Framework ポータル でボットを作成します。
• Azure にアクセスできないサード パーティのアプリ登録を作成します。
• 独自のアプリ ID (とパスワード) を手動で作成する必要がある。

以下に説明されている手順を実行してください。

1. Azure アカウントにサインインします。 Azure アカウントを持っていない場合は、無料のアカウントにサインアップ できます。

2. [アプリの登録] ウィンドウにアクセスし、上部にある操作バーの [新しい登録] をクリックします。

   

3. [名前] フィールドにアプリケーション登録の表示名を入力し、サポートされているアカウントの種類を選択します。

   

4. [登録] を選択します

   しばらくすると、新しく作成されたアプリケーションの登録によって、ウィンドウが開きます。 [概要] ウィンドウで [アプリケーション (クライアント) ID] をコピーし、保存します。 この記事の後半で説明するように、関連するアプリ ID フィールドをボットの作成時に事前設定する必要があります。

   

Azure portal を使用するボットの作成

Azure Bot リソースを使用して Azure portal でボットを作成する場合は、アプリ登録用のシークレット キー (クライアント シークレット) を生成する必要があります。

1. アプリ登録のウィンドウの左側のナビゲーション列で [証明書とシークレット] を選択します。

2. ウィンドウの右側にある [新しいクライアント シークレット] ボタンを選択します。 ポップアップ表示されるダイアログ ボックスで、シークレットのオプションの説明を入力し、[有効期限] ラジオ ボタン グループから [有効期限あり] を選択します。

   

3. [追加] を選択します。

4. クライアント シークレットの下のテーブルからシークレットの値をコピーして保存します。

   

5. ボットの登録時、アプリ ID とパスワードを作成するときに、適切な入力ボックスに保存したアプリ ID とシークレットを次の図に示すように入力します。

   Note

   シークレットは、このブレード上にいる間のみ表示されます。そのページから移動すると、取得することができなくなります。 必ず、これを安全な場所にコピーしてください。

   

上記の手順を適用する方法の例については 、「ボットに認証を追加する」を参照してください。

デプロイのために圧縮する必要があるファイルは何ですか?

「コード ディレクトリを手動で zip 圧縮する」の手順 で説明されているように、プロジェクト内のすべてのファイルを含む zip アーカイブを手動で作成する必要があります。 必ず、ボットのプロジェクト フォルダー内のすべてのファイルとフォルダーを選択してください。 次に、プロジェクト フォルダー内で、下の図に示すように、選択したすべてのファイルとフォルダーを zip 圧縮します。

ボットをデプロイするには、どのバージョンの Azure CLI を使用する必要がありますか?

最新バージョンのAzure コマンド ライン インターフェイス (CLI) を使用してください。そうでない場合、非推奨コマンド エラーが発生します。 「Azure CLI のインストール」を参照してください。

Azure CLI の非推奨エラーが発生した場合はどうすればよいですか?

Azure CLI の最新バージョンにアップグレードします。 Azure CLI バージョン 2.2.0 以降の場合は、az deployment sub create や az deployment group create コマンドではなく、az deployment create や az group deployment create コマンドをそれぞれ使用する必要があります。

ボットを Azure にデプロイするために使用する Azure CLI コマンドの変更ログ

Azure ClI バージョン	Command1	コマンド 2
Azure CLI 2.2.0 とそれ以降のバージョン	az deployment group create	az deployment sub create
Azure CLI 2.1.0 とそれ以前のバージョン	az group deployment create	az deployment create

詳しくは、「Azure CLI 変更ログ」を参照してください。

'az deployment' に関連する CLI 非推奨コマンドは何ですか?

az deployment 非推奨のコマンドを次に示します。

非推奨	次のものに置き換えられます。
az deployment <create/list show/delete/validate/export/cancel>	az deployment **sub** <create/list/show/delete/validate/export/cancel>
az deployment operation <list/show>	az deployment operation **sub** <list/show>
az group deployment <create/list/show/delete/validate/export/cancel>	az deployment **group** <create/list/show/delete/validate/export/cancel>
az group deployment operation <list/show>	az deployment operation **group** < list/show>

どうすれば Azure CLI コマンドが非推奨かどうかを確認できますか?

Azure CLI コマンドが非推奨かどうかを確認するには、次の図に示すように 、-h (ヘルプ) オプションを使用してコマンドを実行します。

Azure CLI 変更ログ

「Azure CLI の変更ログ」の詳細を参照してください。

Azure Resource Management (ARM)

現在の Azure CLI 設計に適合するコマンドの統合リストを次に示します。az {command group} {?sub-command-group} {operation} {parameters}。

• az resource: リソース モジュールの例を改善します。
• az policy assignment list: 管理グループ スコープでのポリシー割り当ての一覧表示をサポートします。
• リソース グループでのテンプレートのデプロイ用に az deployment group と az deployment operation group を追加。 これは az group deployment と az group deployment operation の複製です。
• サブスクリプション スコープでのテンプレートのデプロイ用に az deployment sub と az deployment operation sub を追加。 これは az deployment と az deployment operation の複製です。
• 管理グループでのテンプレートのデプロイ用に az deployment mg と az deployment operation mg を追加する。
• テナント スコープでのテンプレートのデプロイ用に ad deployment tenant と az deployment operation tenant を追加。
• az policy assignment create: --location パラメーターに対する説明を追加する
• az group deployment create: クロス テナントをサポートするためにパラメーター --aux-tenants を追加する

Azure Bot リソースとは何ですか?

Azure Bot リソースは、Web アプリ ボットまたはボット チャネル登録からの更新プログラムであり、開発者が Bot Framework Composer ボット開発ツールの使用を簡単に開始できるようにします。 ボットの作成時に Web アプリなどのリソースを作成する代わりに、Bot Framework Composer を使用してリソースが作成されます。これにより、デプロイされるリソースの柔軟性が向上します。 Composer には、ボットの開発を容易にするビジュアル デザイン キャンバスが用意されています。

なぜ Web アプリ ボットとボット チャネルの登録が非推奨になっているのですか?

機能的には、Azure Bot、Web App Bot、Bot Channels Registration はすべて、"内部" では同じ方法で Bot Service を利用します。 Azure Bot のパスは、開発者にとってより簡単で構成しやすいです。 従来の項目は Azure Marketplace から削除されますが、既存のリソースは引き続き実行され、サポートされます。

Web アプリ ボットまたはボット チャネルの登録は機能し続けますか? また、どのくらいの期間機能し続けますか?

はい。Web アプリ ボットまたはボット チャネル登録ベースのリソースは引き続き実行されます。 既存のボット リソースのサポートを削除する予定はありません。

既存のボットを Azure Bot に移行する必要はありますか?

いいえ。既存のボットを移行する必要はありません。ボットは引き続きそのまま実行されます。

既存のボット リソースを Azure ボットに移行できますか?

現在、これはサポートされていません。 ボットが運用環境で使用されていない場合は、古いボット リソースを削除し、ボット名とアプリ ID を新しいボット リソースで再利用できます (古いレコードが削除されるまで少し待ってから)。 新しい Azure Bot は Composer を使用したボットの作成を中心に設計されているため、このような移行による利益は最小限になります。

Azure Botと Web アプリ ボットまたはボット チャネルの登録の違いは何ですか?

Azure Bot と Web App Bot/Bot Channels の登録の背後にある ボット サービスは同じです。Web アプリ、言語理解など、ボットで使用するリソースを作成する方法に変更が行われました。 1 つのサイズで Web アプリ ボットで使用されるすべてのテンプレートに適合させるのではなく、Bot Framework Composer を使用することで、Web アプリ ボット テンプレートよりもはるかに柔軟性の高いボットのリソースを作成できます。 Bot Channels Registration と Azure Bot は、名前は変更されていますが基本的に同じ機能です。 ユーザーが Bot Framework Composer に接続しやすいように、Azure portal では UX が若干異なります。

この記事では、Azure でよく寄せられる質問に回答します。

この記事の対象: SDK v4

独自のアプリ登録は、次の場合に作成できます。

• Bot Framework ポータル でボットを作成します。
• Azure にアクセスできないサード パーティのアプリ登録を作成します。
• 独自のアプリ ID (とパスワード) を手動で作成する必要がある。

以下に説明されている手順を実行してください。

1. Azure アカウントにサインインします。 Azure アカウントを持っていない場合は、無料のアカウントにサインアップ できます。

2. [アプリの登録] ウィンドウにアクセスし、上部にある操作バーの [新しい登録] をクリックします。

   

3. [名前] フィールドにアプリケーション登録の表示名を入力し、サポートされているアカウントの種類を選択します。

   

4. [登録] を選択します

   しばらくすると、新しく作成されたアプリケーションの登録によって、ウィンドウが開きます。 [概要] ウィンドウで [アプリケーション (クライアント) ID] をコピーし、保存します。 この記事の後半で説明するように、関連するアプリ ID フィールドをボットの作成時に事前設定する必要があります。

   

Azure portal を使用するボットの作成

Azure Bot リソースを使用して Azure portal でボットを作成する場合は、アプリ登録用のシークレット キー (クライアント シークレット) を生成する必要があります。

1. アプリ登録のウィンドウの左側のナビゲーション列で [証明書とシークレット] を選択します。

2. ウィンドウの右側にある [新しいクライアント シークレット] ボタンを選択します。 ポップアップ表示されるダイアログ ボックスで、シークレットのオプションの説明を入力し、[有効期限] ラジオ ボタン グループから [有効期限あり] を選択します。

   

3. [追加] を選択します。

4. クライアント シークレットの下のテーブルからシークレットの値をコピーして保存します。

   

5. ボットの登録時、アプリ ID とパスワードを作成するときに、適切な入力ボックスに保存したアプリ ID とシークレットを次の図に示すように入力します。

   Note

   シークレットは、このブレード上にいる間のみ表示されます。そのページから移動すると、取得することができなくなります。 必ず、これを安全な場所にコピーしてください。

   

上記の手順を適用する方法の例については 、「ボットに認証を追加する」を参照してください。

「コード ディレクトリを手動で zip 圧縮する」の手順 で説明されているように、プロジェクト内のすべてのファイルを含む zip アーカイブを手動で作成する必要があります。 必ず、ボットのプロジェクト フォルダー内のすべてのファイルとフォルダーを選択してください。 次に、プロジェクト フォルダー内で、下の図に示すように、選択したすべてのファイルとフォルダーを zip 圧縮します。

最新バージョンのAzure コマンド ライン インターフェイス (CLI) を使用してください。そうでない場合、非推奨コマンド エラーが発生します。 「Azure CLI のインストール」を参照してください。

Azure CLI の最新バージョンにアップグレードします。 Azure CLI バージョン 2.2.0 以降の場合は、az deployment sub create や az deployment group create コマンドではなく、az deployment create や az group deployment create コマンドをそれぞれ使用する必要があります。

ボットを Azure にデプロイするために使用する Azure CLI コマンドの変更ログ

Azure ClI バージョン	Command1	コマンド 2
Azure CLI 2.2.0 とそれ以降のバージョン	az deployment group create	az deployment sub create
Azure CLI 2.1.0 とそれ以前のバージョン	az group deployment create	az deployment create

詳しくは、「Azure CLI 変更ログ」を参照してください。

az deployment 非推奨のコマンドを次に示します。

非推奨	次のものに置き換えられます。
az deployment <create/list show/delete/validate/export/cancel>	az deployment **sub** <create/list/show/delete/validate/export/cancel>
az deployment operation <list/show>	az deployment operation **sub** <list/show>
az group deployment <create/list/show/delete/validate/export/cancel>	az deployment **group** <create/list/show/delete/validate/export/cancel>
az group deployment operation <list/show>	az deployment operation **group** < list/show>

Azure CLI コマンドが非推奨かどうかを確認するには、次の図に示すように 、-h (ヘルプ) オプションを使用してコマンドを実行します。

Azure CLI 変更ログ

「Azure CLI の変更ログ」の詳細を参照してください。

Azure Resource Management (ARM)

現在の Azure CLI 設計に適合するコマンドの統合リストを次に示します。az {command group} {?sub-command-group} {operation} {parameters}。

• az resource: リソース モジュールの例を改善します。
• az policy assignment list: 管理グループ スコープでのポリシー割り当ての一覧表示をサポートします。
• リソース グループでのテンプレートのデプロイ用に az deployment group と az deployment operation group を追加。 これは az group deployment と az group deployment operation の複製です。
• サブスクリプション スコープでのテンプレートのデプロイ用に az deployment sub と az deployment operation sub を追加。 これは az deployment と az deployment operation の複製です。
• 管理グループでのテンプレートのデプロイ用に az deployment mg と az deployment operation mg を追加する。
• テナント スコープでのテンプレートのデプロイ用に ad deployment tenant と az deployment operation tenant を追加。
• az policy assignment create: --location パラメーターに対する説明を追加する
• az group deployment create: クロス テナントをサポートするためにパラメーター --aux-tenants を追加する

Azure Bot リソースは、Web アプリ ボットまたはボット チャネル登録からの更新プログラムであり、開発者が Bot Framework Composer ボット開発ツールの使用を簡単に開始できるようにします。 ボットの作成時に Web アプリなどのリソースを作成する代わりに、Bot Framework Composer を使用してリソースが作成されます。これにより、デプロイされるリソースの柔軟性が向上します。 Composer には、ボットの開発を容易にするビジュアル デザイン キャンバスが用意されています。

機能的には、Azure Bot、Web App Bot、Bot Channels Registration はすべて、"内部" では同じ方法で Bot Service を利用します。 Azure Bot のパスは、開発者にとってより簡単で構成しやすいです。 従来の項目は Azure Marketplace から削除されますが、既存のリソースは引き続き実行され、サポートされます。

はい。Web アプリ ボットまたはボット チャネル登録ベースのリソースは引き続き実行されます。 既存のボット リソースのサポートを削除する予定はありません。

いいえ。既存のボットを移行する必要はありません。ボットは引き続きそのまま実行されます。

現在、これはサポートされていません。 ボットが運用環境で使用されていない場合は、古いボット リソースを削除し、ボット名とアプリ ID を新しいボット リソースで再利用できます (古いレコードが削除されるまで少し待ってから)。 新しい Azure Bot は Composer を使用したボットの作成を中心に設計されているため、このような移行による利益は最小限になります。

Azure Bot と Web App Bot/Bot Channels の登録の背後にある ボット サービスは同じです。Web アプリ、言語理解など、ボットで使用するリソースを作成する方法に変更が行われました。 1 つのサイズで Web アプリ ボットで使用されるすべてのテンプレートに適合させるのではなく、Bot Framework Composer を使用することで、Web アプリ ボット テンプレートよりもはるかに柔軟性の高いボットのリソースを作成できます。 Bot Channels Registration と Azure Bot は、名前は変更されていますが基本的に同じ機能です。 ユーザーが Bot Framework Composer に接続しやすいように、Azure portal では UX が若干異なります。