ソリューションを使用したボットのエクスポートとインポート

  • [アーティクル]

ソリューションを使用してボットをエクスポートおよびインポートできるため、複数の環境間でボットを移動することができます。

これは、さまざまな目的でさまざまな環境を使用している場合、またはリング展開方法を採用している場合に役立ちます。 たとえば、特定の環境でボットを内部でテストおよび検証する、別の環境でユーザーのサブセットのみを対象にボットをテストする、最終的な運用環境で顧客やエンド ユーザーとボットを共有する場合があります。

Note

トピック レベル、またはノード レベルのコメントは、ボットのエクスポート時にはエクスポートできません。

前提条件

重要

このトピックは Power Virtual Agents プレビューのドキュメントを含み、今後変更される可能性があります。

プレビュー機能は運用環境での使用を想定しておらず、機能が制限される可能性があります。 これらの機能は公式リリースの前に使用できるため、一足先にアクセスして フィードバックを送る ことができます。

運用に対応したボットを構築する場合は、Power Virtual Agents の概要 を参照してください。

ソリューションを使用してボットをエクスポートおよびインポートすることにより、環境全体でボットを移動します。 ボットのエクスポートおよびインポートは、さまざまな目的でさまざまな環境を使用している場合、またはリング展開方法を採用している場合に役立ちます。 たとえば、ある環境でボットを内部テストおよび検証する、別の環境でユーザーのサブセットを使用してボットをテストする、運用環境で顧客とボットを共有する場合があります。

知っておくべき点

  • トピック レベル、またはノード レベルのコメントは、ボットのエクスポート時にはエクスポートできません。

  • ソリューションからボットを削除しても、そのコンポーネントはソリューションから削除されません。 コンポーネントの削除は個別に行う必要があります。

    警告

    ソリューションからボットを削除していない限り、ボット トピックなどのアンマネージド ボット コンポーネントを Power Apps ポータルから直接削除しないでください。

    Power Virtual Agents からのみトピックに変更を加える必要があります。 ボットのコンポーネントを Power Apps から削除または変更すると、エクスポートおよびインポートが失敗します。

  • マネージド ソリューションはエクスポートできません。 ソリューションを作成すると、既定ではアンマネージドになります。 マネージド ソリューションに変更すると、エクスポートできなくなります。 新しいソリューションを作成する必要があります。

  • ボットに多数のコンポーネント (たとえば、250 以上のトピックまたは 100 以上のエンティティ) がある場合は、代わりにクラシック Power Apps ポータルを使用してエクスポートします。

注意

ソリューションを使用してボットをエクスポートおよびインポートするには、最小限のシステム カスタマイザー セキュリティ ロールが必要です。 詳細については、環境内のリソースに対するユーザー セキュリティの構成を参照してください。

ソリューションを作成し、エクスポートおよびインポートを管理する

ソリューションを使用して、ある環境からボットをエクスポートし、別の環境にインポートします。 ソリューションは、ボットの "キャリア" として機能します。 1 つのソリューションで複数のボットをエクスポートおよびインポートできます。

  1. Power Virtual Agents で、エクスポートするボットを開きます。

注意

クラシック ボットを使用している場合は、ナビゲーション メニューで チャットボット を選択し、チャットボット ページを開き、この環境でアクセスできるすべてのボットを表示します。

  1. ナビゲーション メニューの、設定で、ボットの詳細を選択してから、エクスポートを選択します。

    [エクスポート] ボタンが強調表示されている、Power Virtual Agents のボット詳細設定ページのスクリーンショット。

注意

クラシック ボットを使用している場合は、エクスポートするボットを選択し、チャットボットのエクスポート を選択します。

全般設定ページのエクスポート ボタンのスクリーンショット。

  1. Power Apps ソリューションに移動するを選択します。

    ボット エクスポート プロンプトのスクリーンショット。

  2. Power Apps の、ソリューション タブで、新しいソリューションを選択します。

    新しいソリューション ボタンが強調表示された Power Apps ソリューション ページのスクリーンショット。

  3. 新しいソリューションに関する次の情報を入力します:

    Field Description
    表示名称 ソリューションの一覧に表示される名前。 これは後で変更できます。
    件名 表示名から生成された、ソリューションの一意の名前。 ソリューションを保存する前に編集できますが、保存後は変更できません。
    発行者 既定の発行者を選択するか、または新しい発行元を作成します。 ソリューションを使用する環境全体で一貫して使用できるように、発行元を作成することをお勧めします。 ソリューション発行者に関する詳細。
    Version ソリューションのバージョン番号を入力します。 バージョン番号は、ソリューションをエクスポートしたときにファイル名に含まれます。

  4. 作成を選択します。

ボットをソリューションに追加する

  1. 作成したソリューションが開きます。 開かない場合は、ソリューションの一覧で選択します。

  2. 既存の追加を選択してから、チャットボットを選択します。

  3. 既存のチャットボットを追加する一覧で、エクスポートするボットを選択してから、追加を選択します。

注意

以下は、クラシック ボットに適用されます。

  1. スキルを使用している場合、このソリューションから削除を選択してスキルの環境変数現在の値を削除します。

    [このソリューションから削除] ボタンを示すスクリーンショット。

Note

ソリューションからボットを削除しても、そのコンポーネントはソリューションから削除されません。 コンポーネントの削除は個別に行う必要があります。

警告

ソリューションからボット自体を削除していない限り、アンマネージド チャットボックス サブコンポーネント (ボット トピックなど) を Power Apps ポータルから直接削除しないでください。

Power Virtual Agents ポータル内からのみトピックに変更を加える必要があります。

チャットボットのサブコンポーネントを Power Apps 内部から削除または変更すると、エクスポートおよびインポートが失敗します。

ボットでソリューションをエクスポートする

ボットを含むソリューションをある環境から別の環境にエクスポートおよびインポートすることにより、ボットをエクスポートおよびインポートします。

重要

ボットに多数のコンポーネント (たとえば、250 以上のトピックまたは 100 以上のエンティティ) がある場合は、クラシック エクスペリエンスを使用してエクスポートするが表示されます。

  1. Power Apps ソリューション ページで、ボットを含むソリューションを選択してから、ソリューションのエクスポートを選択します。

    Power Apps のソリューションのエクスポート ボタンのスクリーンショット。

  2. エクスポートする前ウィンドウで、次へを選択します。

  3. 以下のオプションを入力または選択します:

    回答内容 Description
    バージョン番号 Power Virtual Agents は、ソリューション バージョンを自動的に増分します。 既定を受け入れるか、独自に入力できます。
    エクスポート形式 マネージドまたはアンマネージドのパッケージ タイプを選択します。 詳細については、マネージドおよびアンマネージド ソリューションを参照してください。

  4. エクスポート を選択します。

エクスポートが完了するまでに数分かかる場合があります。 ソリューション ページの上部にあるステータス メッセージに注目します。 エクスポートが完了すると、ブラウザーは .zip ファイルをダウンロードします。 ファイル名は SolutionName_Version_ManagementType.zip の形式です; たとえば、MyBotPublisher_1.0.0.0.1_Unmanaged.zip ZIP のようになります。

ボットでソリューションをインポートする

  1. Power Apps で、ポータルをインポートする環境を選択します。

    選択している Power Apps 環境のスクリーンショット。

  2. ソリューション ページで、ソリューションが選択されていないことを確認し、ソリューションのインポートを選択します。

    ソリューションのインポート ボタンが強調表示された Power Apps ソリューション ページのスクリーンショット。

  3. ソリューションのインポート ウィンドウで、参照を選択し、ボットでソリューションを含む .zip ファイルを選択してから、次へを選択します。

  4. インポートを選択します。

  5. インポートが完了するまでしばらく待ちます。 結果を表示し、閉じる を選択します。

    インポートが失敗した場合は、ログ ファイルのダウンロードを選択して、インポートが失敗した原因に関する詳細を含む XML ファイルをダウンロードします。 インポートが失敗する最も一般的な原因は、ソリューションに必要なコンポーネントが含まれていなかったことです。

  6. ボットでユーザー認証が有効になっている場合は、再度構成する必要があります。

  7. オブジェクト ウィンドウでチャットボットを選択します。 その後、ボットの名前を選択し、Power Virtual Agents ポータルでボットを開きます。

    Power Virtual Agents のボットと環境のリストのスクリーンショット。

    Power Virtual Agents を直接開いてから、インポートした環境でボットを開くこともできます。

重要

カスタム ソリューションのチャットボットにコンポーネントを追加する

ボット コンポーネント (トピックやフローなど) を Power Virtual Agents のボットに追加する場合、アンマネージド ソリューションのボットに追加する必要もあります。

  1. Power Apps ポータルでソリューションを開きます。

  2. チャットボットを選択してから、一覧でボットを選択します。

  3. コマンド (⋮) を選択し、詳細を選択してから、+ 必須オブジェクトを追加を選択します。

    Power Apps のコマンド メニューの下にある必須コンポーネントの追加オプションを強調表示したスクリーンショット。

チャットボットを使用してソリューションをアップグレードまたは更新する

ソリューションの更新またはアップグレードする方法について説明します。

マネージド チャットボットからアンマネージド レイヤーを削除する

マネージド ソリューションとアンマネージド ソリューションは、Microsoft Dataverse 環境内のさまざまなレベルに存在します。 詳細については、ソリューションの階層を参照してください。

マネージド コンポーネント (トピックまたはフローなど) を編集すると、アンマネージド "アクティブ" 層が取得されます。 ソリューションの展開後に最新のアップデートを表示するには、そのレイヤーを削除する必要があります。

ソリューション レイヤーを表示オプションを使用して、コンポーネントが含まれているすべてのソリューションを表示します。 また、何かを直接変更した場合は、他のすべてのソリューションの上に 1 つの "アクティブ" ソリューションが表示されます。

  1. Power Apps ポータルでソリューションを開きます。

  2. チャットボットを選択してから、一覧でボットを選択します。

  3. コマンド (⋮) を選択し、詳細を選択してから、ソリューション レイヤーの表示を選択します。

    Power Apps のコマンド メニューの下にあるソリューション レイヤーを表示するオプションを強調表示したスクリーンショット。

  4. ソリューション レイヤー ページで、アンマネージド レイヤーを選択してから、アンマネージド レイヤーを削除するを選択します。