Azure portal を使用して Azure Bot リソースを作成する

この記事の対象: SDK v4

Azure Bot リソース (ボット リソース) を使用すると、ボットを Azure AI Bot Service に登録し、ボットをチャンネルに接続することができます。 ボットを構築、接続、管理して、アプリや Web サイトから Teams、Messenger、その他の多くのチャンネルまで、どこにいてもユーザーと対話できます。

この記事では、Azure portal を使用してボット リソースを作成する方法について説明します。

• ボットを作成する方法については、「Bot Framework SDK を使用してボットを作成する」クイック スタートを参照してください。
• ボットをプロビジョニングして Azure に発行する方法については、「Azure でボットを配置する」方法を参照してください。

リソースの管理

ボット リソースを作成すると、Azure によって関連するリソースが作成されます。 作成されるリソースの一部は、ボットの ID を管理する方法によって異なります。

ボット ID は、いくつかの方法で Azure で管理できます。

• ボットの認証情報を自分で管理する必要がないように、ユーザー割り当てマネージド ID として管理する。
• シングルテナント アプリとして管理する。
• マルチテナント アプリとして管理する。

ユーザー割り当てマネージド ID とシングルテナント アプリの種類に関するサポートは、Bot Framework SDK for C#、JavaScript、および Python に追加されました。 これらの種類のアプリは、他の言語、Bot Framework Composer、Bot Framework Emulator、または開発トンネルではサポートされていません。

前提条件

• Azure サブスクリプションをお持ちでない場合は、開始する前に無料アカウントを作成してください。
• ユーザー割り当てマネージド ID とシングルテナント ボット用の Bot Framework SDK for C# または JavaScript バージョン 4.15.0 以降。

リソースを作成する

Azure Bot リソースを作成します。これにより、ボットを Azure AI Bot Service に登録できます。

1. Azure ポータルにアクセスします。

2. 右側のウィンドウで、 [リソースの作成] を選びます。

3. 検索ボックスに「bot」と入力し、Enter キーを押します。

4. Azure Bot カードを選択します。

   

5. ［作成］ を選択します

6. 必須フィールドに値を入力し、設定の確認と更新を行います。

   1. [プロジェクトの詳細] に情報を入力します。 ボットにグローバル データ所在地とローカル データ所在地のどちらを使用するかを選択します。 現在、ローカル データ所在地機能は、「westeurope」および「centralindia」リージョンのリソースで使用できます。 詳細については、「Azure AI Bot Service での登録」を参照してください。

      

   2. [Microsoft アプリ ID] に情報を入力します。 Azure でボット ID を管理する方法と、新しい ID を作成するか、既存の ID を使用するかを選択します。

      

7. [Review + create](レビュー + 作成) を選択します。

8. 検証テストに合格したら、[作成] を選びます。

9. デプロイが完了したら、[リソースに移動] を選択します。 選択したリソース グループにボットと関連リソースが一覧表示されます。

10. Bot Framework SDK をまだお持ちでない場合は、[GitHub からダウンロード] を選択して、優先する言語のパッケージを使用する方法を確認してください。

    

これで、Bot Framework SDK を使用してボットを構築する準備ができました。

ボット ID 情報

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

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

App Service を更新するには

ボットの既存の App Service リソース (Web アプリ) があり、ボットが ユーザー割り当てマネージド ID アプリケーションである場合は、ボットの App Service を更新する必要がある場合があります。

1. ボットの Web アプリの App Service ブレードに移動します。
2. [設定] にある [ID] を選択します。
3. [ID] ブレードで [ユーザー割り当て] タブを選択し、[追加] (+) を選択します。
4. ユーザー割り当てマネージド ID の追加 ブレード上:

   1. サブスクリプションを選択します。

   2. ユーザー割り当てマネージド ID の場合 は、ボットのマネージド ID を選択します。 マネージド ID が自動的に生成された場合は、ボットと同じ名前になります。

   3. ボットにこの ID を使用するには、[追加] を選択します。

      

アプリまたはテナント ID を取得するには

ボットのアプリまたはテナント ID を取得するには:

1. ボットの [Azure Bot リソース] ブレードに移動します。
2. ボットの [構成] ブレードに移動します。 このブレードから、ボットの Microsoft アプリ ID またはアプリ テナント ID をコピーできます。

新しいパスワードを生成するには

シングルテナント ボットとマルチテナント ボットには、一部の操作に必要となるアプリ シークレットまたはパスワードがあります。 Azure AI Bot Service では、ボット シークレットが非表示になります。 ただし、ボットの App Service リソースの所有者は、新しいパスワードを生成できます。

1. ボットの [Azure Bot リソース] ブレードに移動します。
2. ボットの [構成] ブレードに移動します。
3. [Microsoft アプリ ID] の横にある [管理] を選択して、App Service の [証明書 + シークレット] ブレードに移動します。
4. ブレードの指示に従って新しいクライアント シークレットを作成し、安全な場所に値を記録します。

追加情報

• Microsoft Entra ID を使用した ID 管理の詳細については、「Microsoft Entra ID とは」を参照してください。
• Azure App Service と App Service プランの詳細については、「App Serviceの概要」を参照してください。
• Azure リソースと一般的な管理方法の詳細については、「Azure Resource Manager の概要」を参照してください。

スキル サポート

スキル コンシューマーの種類によっては、一部の種類のスキル ボットを使用できません。 次の表に、サポートされている組み合わせについて説明します。

スキルまたはスキル コンシューマーを構成する方法については、「スキルの実装」または「スキル コンシューマーの実装」を参照してください。

次のステップ

• Bot Framework Composer を使用してボットを作成する
• Bot Framework SDK を使用してボットを作成する