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

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

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

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

前提条件

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

知っておくべき点

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

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

  警告

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

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

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

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

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

1. 新しいソリューションを作成する際は、ソリューションの作成と管理Copilot Studioの手順に従ってください。

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

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

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

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

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

1. エージェントを含むソリューションを開きます。
2. オブジェクト ペインで、エージェント配下でエージェントを見つけます。
3. コマンド (⋮)を選択し、詳細を選択してから、必須オブジェクトの追加を選択します。

また、既存のコンポーネントをソリューションに追加する場合は、Power Apps ドキュメントの指示と要件を確認する必要があります。

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

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

Power Apps ドキュメントの指示と要件に従ってソリューションをエクスポートします。

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

Power Apps ドキュメントの指示と要件に従ってソリューションをインポートします。

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

1. ドユーザー認証を再度構成します。

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

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

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

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

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

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

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

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

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