ソリューションを使用してエージェントのエクスポートとインポートを行う

ソリューションを使用してエージェントをエクスポー/びインポートできるため、複数の環境間でエージェントを移動できます。

まず、カスタム ソリューションを作成し、それにエージェントを追加します。 次に、エージェントを使用してソリューションをエクスポートし、別の環境にインポートします。 さらに、エージェントを使用してソリューションをアップグレードまたは更新したり、マネージド エージェントからアンマネージド レイヤーを削除したりすることもできます。

Copilot Studio のソリューション エクスプローラーの詳細については、Copilot Studio でのソリューションの表示と管理に関する記事を参照してください。

前提条件

• この機能を使用するには、少なくともシステム カスタマイザーのセキュリティ ロールが必要です。 詳細については、環境でのユーザー セキュリティの構成 を参照してください。
• ソリューションの概念および Copilot Studio でソリューションを作成および管理するで説明されているソリューションの概念を理解している必要があります。

知っておくべき点...

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

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

  警告

  エージェントをソリューションから削除しない限り、エージェント トピックなどの管理されていないエージェント コンポーネントをソリューションから直接削除しないでください。

  トピックに変更を加える必要があるのは、Copilot Studio UI の標準作成プロセスの一部としてのみです。 エージェントのコンポーネントをソリューションから直接削除または変更すると、エクスポートとインポートが失敗します。

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

• トピック名にピリオド (.) が含まれるエージェントを含むソリューションはエクスポートできません。

カスタム ソリューションを作成してエージェントを追加する

1. Copilot Studio でのソリューションの作成と管理の手順に従って、Copilot Studio ソリューション エクスプローラーで新しいソリューションを作成します。

2. 作成したソリューションが自動的に開きます。 開かない場合は、ソリューションの一覧から選択します。

3. 既存の追加を選択し、エージェントを選択した後で再度エージェントを選択します。

4. 既存のエージェントを追加リストで、エクスポートするエージェントを選択し、追加を選択します。

カスタム ソリューションのエージェントにコンポーネントを追加する

Copilot Studio でエージェントにトピックやフローなどのコンポーネントを追加する場合は、エクスポートする前に、アンマネージド ソリューションのエージェントにもそれらを追加する必要があります。

1. Copilot Studio でソリューション エクスプローラーを開きます。

2. エージェントを含むソリューションを選択します。

3. オブジェクト ペインで、エージェント配下でエージェントを見つけます。

4. 3つの点(⋮)を選択し、「 Advanced」を選択し、「 必要なオブジェクトを追加」を選択します。

Power Apps のドキュメントに記載されている手順と要件に従って、既存のコンポーネントをソリューションに追加する必要もあります。

エージェントを使用してソリューションをエクスポートする

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

エージェントと共にソリューションをエクスポートするには、次の手順に従います。

1. Copilot Studio でソリューション エクスプローラーを開きます。

2. アンマネージド ソリューションの一覧で、エージェントを含むソリューションを選択します。

3. ソリューションのエクスポート を選択します。 Power Apps エクスポート ソリューション エクスペリエンスと同様に、エクスポートする前に右側のペインが表示されます。

4. 残りの手順は、Power Apps でソリューションをエクスポートする場合と同じです。 ソリューションのエクスポートを完了するには、Power Apps ドキュメントの指示と要件に従ってください。

エージェントを使用してソリューションをインポートする

エージェントと共にソリューションを別の環境にインポートするには、次の手順に従います。

1. ターゲット環境で、Copilot Studio でソリューション エクスプローラーを開きます。

2. ソリューションのインポートを選択します。 Power Apps のソリューションのインポート エクスペリエンスと同様、ソリューションのインポートの右側のペインが表示されます。

3. 残りの手順は、Power Apps でソリューションをインポートする場合と同じです。 ソリューションのインポートを完了するには、Power Apps ドキュメントの指示と要件に従ってください。

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

1. ソリューション エクスプローラーで、インポートされた新しいソリューションを一覧から選択します。

2. オブジェクトペインでエージェントを選択します。 次に、エージェントの名前を選択して、新しいタブで Copilot Studio でエージェントを開きます。

3. エージェントのユーザー認証を再度構成します。

Teams のエージェントのエクスポートとインポート

Microsoft Teams では、Power Apps Teams アプリを使用して、個々のチーム間でエージェントをエクスポートおよびインポートできます。

たとえば、Teams チーム (チーム A) から作業エージェントをエクスポートし、それをチーム B にインポートする場合、チーム B 用に最初から構築する必要はありません。

Dataverse for Teams からカスタマイズをエクスポートするの手順に従います。

エクスポートするカスタマイズを選択する際は、エクスポートするエージェントを選択します。 サイド ペインのフィルタを使用して、特定のチームのエージェントのみを表示することができます。

エージェントは、コンピューターのダウンロード フォルダーに保存されます。

Teams にインポートするには、カスタマイズを Dataverse for Teams にインポートするの手順に従います。

エージェントは、Teams の Copilot Studio アプリで、インポートしたチームの下に表示されます。