ソリューションを使用してエージェントをエクスポー/びインポートできるため、複数の環境間でエージェントを移動できます。
まず、カスタム ソリューションを作成し、それにエージェントを追加します。 次に、エージェントを使用してソリューションをエクスポートし、別の環境にインポートします。 さらに、エージェントを使用してソリューションをアップグレードまたは更新したり、マネージド エージェントからアンマネージド レイヤーを削除したりすることもできます。
Copilot Studio のソリューション エクスプローラーの詳細については、「 Copilot Studio でのソリューションの表示と管理を参照してください。
注意
トピック レベル、またはノード レベルのコメントは、エージェントのエクスポート時にはエクスポートできません。
前提条件
- この機能を使用するには、少なくともシステム カスタマイザーのセキュリティ ロールが必要です。 詳細については、環境でのユーザー セキュリティの構成 を参照してください。
- ソリューションの概念については、「ソリューションの概念、Copilot Studio でのソリューションの作成と管理で説明されているように理解しておく必要があります。
知っておくべき点...
トピック レベル、またはノード レベルのコメントは、エージェントのエクスポート時にはエクスポートできません。
ソリューションからエージェントを削除しても、そのコンポーネントはソリューションから削除されません。 コンポーネントの削除は個別に行う必要があります。
警告
エージェントをソリューションから削除しない限り、エージェント トピックなどの管理されていないエージェント コンポーネントをソリューションから直接削除しないでください。
トピックに変更を加える必要があるのは、Copilot Studio UI の標準的な作成プロセスの一環としてのみです。 エージェントのコンポーネントをソリューションから直接削除または変更すると、エクスポートとインポートが失敗します。
マネージド ソリューションはエクスポートできません。 ソリューションを作成すると、既定ではアンマネージドになります。 管理ソリューションに変更した場合、エクスポートすることはできません。 新しいソリューションを作成する必要があります。
トピック名にピリオド () が含まれるエージェントを含むソリューションはエクスポートできません。
カスタム ソリューションを作成してエージェントを追加する
Copilot Studio ソリューション エクスプローラーで新しいソリューションを作成するには、Copilot Studio でソリューションを作成および管理するの手順に従います。
作成したソリューションが自動的に開きます。 開かない場合は、ソリューションの一覧から選択します。
既存の追加を選択し、エージェントを選択した後、再びエージェントを選択します。
既存のエージェントを追加リストで、エクスポートするエージェントを選択し、追加を選択します。
注意
クラシック チャットボットの場合:
スキルを使用している場合、このソリューションから削除を選択してスキルの環境変数現在の値を削除します。
[このソリューションから削除] ボタンを示すスクリーンショット。
ソリューションからエージェントを削除しても、そのコンポーネントはソリューションから削除されません。 コンポーネントを個別に削除する必要があります。
カスタム ソリューションのエージェントにコンポーネントを追加する
Copilot Studio でトピックやフローなどのコンポーネントをエージェントに追加する場合は、エクスポートする前に、それらをアンマネージド ソリューションのエージェントに追加する必要もあります。
エージェントを含むソリューションを選択します。
オブジェクト ペインで、「エージェント」セクションにあるあなたのエージェントを見つけます。
3つの点(⋮)を選択し、「 Advanced」を選択し、「 必要なオブジェクトを追加」を選択します。
また、Power Apps ドキュメントの手順と要件を確認して、既存のコンポーネントをソリューションに追加する必要があります。
カスタムコネクターを追加してください
もしエージェントがカスタムコネクタを使用している場合は、「 ソリューションにカスタムコネクタを作成」 の手順に従い、既知の制限について学びましょう。
重要
まずカスタムコネクタをインポートし、その後エージェントソリューションで接続参照をインポートする必要があります。
Power Automate フローを追加する
フローや環境変数を使用する場合は、フローや環境変数に必要なオブジェクトを追加してください。
エージェントを含むソリューションを選択します。
オブジェクトペインでワークフローを見つけてください。
3つの点(⋮)を選択し、「 Advanced」を選択し、「 必要なオブジェクトを追加」を選択します。
環境変数の追加
環境変数を追加するには、以下の手順に従ってください:
エージェントを含むソリューションを選択します。
もし解決策に環境変数が存在しない場合は、「 既存の変数を追加」を選択し、「 その他」を選択し、その後 「環境変数」を選択します。
必要な環境変数を選択してください。
「次へ」を選んでから「追加」を選択します。
すべての環境変数が解決策に存在する場合は、3つの点(⋮)を選択し、「 Advanced」を選択し、「 必要なオブジェクトを追加 」を選択して、すべての依存関係が解決策に追加されることを確認します。
管理ソリューション向けのコンポーネントをカスタマイズ
管理型ソリューションでコンポーネントをカスタマイズ可能にするには、「 View and edit table managed properties」をご覧ください。
マネージドソリューションをインポートする前に、環境でカスタマイズが可能であることを確認しましょう。 環境がカスタマイズや管理されていないソリューションをブロックしていないか確認しましょう。 詳細は Dataverseの「ブロックされた管理されていないカスタマイズ」をご覧ください。
エージェントを使用してソリューションをエクスポートする
エージェントをエクスポートおよびインポートするには、エージェントを含むソリューションをある環境から別の環境にエクスポートおよびインポートします。
エージェントと共にソリューションをエクスポートするには、次の手順に従います。
アンマネージド ソリューションの一覧で、エージェントを含むソリューションを選択します。
ソリューションのエクスポート を選択します。 Power Apps export ソリューション エクスペリエンスと同様に、エクスポート前右側のウィンドウが表示されます。
残りの手順は、Power Appsでソリューションをエクスポートする場合と同じです。 ソリューションのエクスポートを完了するには、Power Appsドキュメントの指示と要件に従います。
重要
エージェントに多数のコンポーネント (たとえば、250 以上のトピックまたは 100 以上のエンティティ) がある場合は、クラシック エクスペリエンスを使用してエクスポートするを参照してください。
エージェントを使用してソリューションをインポートする
エージェントと共にソリューションを別の環境にインポートするには、次の手順に従います。
ターゲット環境で、Copilot Studio でソリューション エクスプローラーを開きます。
ソリューションのインポートを選択します。 Power Apps ソリューションのインポートエクスペリエンスと同様に、ソリューションのインポート右側のウィンドウが表示されます。
残りの手順は、Power Appsでソリューションをインポートする場合と同じです。 ソリューションのインポートを完了するには、Power Appsドキュメントの指示と要件に従います。
インポートが失敗した場合は、ログ ファイルのダウンロードを選択して、インポートが失敗した原因に関する詳細を含む XML ファイルをダウンロードします。 インポートの失敗の最も一般的な原因は、ソリューションに必要コンポーネントが含まれていないことです。
ソリューション エクスプローラーで、インポートされた新しいソリューションを一覧から選択します。
オブジェクトペインでエージェントを選択します。 次に、エージェントの名前を選択して、Copilot Studio の新しいタブでエージェントを開きます。
エージェントのユーザー認証を再度構成します。
重要
- 共有する前に、インポートしたエージェントを公開する必要があります。
- エージェントのアイコンがどこにでも表示されるまで、最大 24 時間かかる場合があります。
Teams でのエージェントのエクスポートとインポート
Microsoft Teamsでは、Power Apps Teams アプリを使用して、個々のチーム間でエージェントをエクスポートおよびインポートできます。
たとえば、Teams チーム (チーム A) から作業エージェントをエクスポートし、それをチーム B にインポートする場合、チーム B 用に最初から構築する必要はありません。
Dataverse for Teams からカスタマイズをエクスポートするの手順に従います。
エクスポートするカスタマイズを選択する際は、エクスポートするエージェントを選択します。 サイド ペインのフィルタを使用して、特定のチームのエージェントのみを表示することができます。
エージェントは、コンピューターのダウンロード フォルダーに保存されます。
Teams にインポートするには、カスタマイズを Dataverse for Teams にインポートするの手順に従います。
エージェントは、インポートしたチームに紐づけられた Teams の Copilot Studio アプリに表示されます。