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

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

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

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

前提条件

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

知っておくべき点

• エージェント をエクスポートする場合、 トピック レベルまたはノード レベルのコメント をエクスポートすることはできません。

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

  警告

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

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

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

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

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

1. 追従する「 ソリューションの作成と管理 Copilot Studio 」の手順に従って、新しいソリューションを作成します。

2. 作成したソリューションが自動的に開きます。 そうでない場合は、解決策のリストに 選択 してください。

3. 選択 既存のものを追加し、次に選択 エージェントし、次に エージェント を再度実行します。

4. 既存の副操縦士の追加 リストで、エクスポートする エージェント またはエージェントを 選択 し、次に 選択 追加します。

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

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

1. エージェント を含むソリューションを開きます。
2. オブジェクト ペインで、 エージェントの下にある エージェント を見つけます。
3. 選択 Commands (⋮), 選択 詳細、次に 選択 必要なオブジェクトを追加。

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

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

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

追従する 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