次の方法で共有


再利用できるコンポーネント コレクションを作成する (プレビュー)

コンポーネント・コレクションは、再利用可能なエージェント・コンポーネントの集合です。 Copilot コンポーネントには、トピック、ナレッジ、アクション、エンティティが含まれます。 環境内の複数のエージェント間でコンポーネント コレクションを共有できます。 また、ソリューションを使用してコンポーネント コレクションをエクスポートおよびインポートし、そのコンテンツを複数の環境間で移動し、アプリケーション ライフサイクル管理 (ALM) シナリオを満たすことができます。

コンポーネント コレクションを編集したり、コンポーネント コレクションをエージェントに追加したりするには、コレクションを作成したユーザーであるか、システム カスタマイザー またはシステム管理者 ロール のユーザーである必要があります。 エージェントでコンポーネントコレクションが使用可能になると、すべてのエージェント作成者はコレクションを表示して使用できますが、コレクション内のコンポーネントを変更することはできません。 詳細については、環境でのユーザー セキュリティの構成 を参照してください。

コンポーネント コレクションを作成する

コンポーネント コレクションは、エージェントの 設定 ページから直接作成できます。 また、ライブラリ ページから作成することもできます。 エージェント コンポーネントをコレクションに追加すると、この操作により、選択したコンポーネントがコレクションに移動されます。 発信元エージェントには、コレクション内のこれらのコンポーネントへの参照が含まれます。 これで、コレクションを環境内の他のエージェントと共有したり、ソリューションにパッケージ化して他の環境にインポートしたりできるようになりました。

エージェントからコンポーネント コレクションを作成する

  1. コンポーネント コレクションとして利用可能にするコンポーネントを含むエージェントを開きます。

  2. 設定 に移動し、コンポーネント コレクション を選択します。

  3. 環境で最初のコンポーネント コレクションを作成する場合は、作成を選択します。 それ以外の場合は、新規を選択します。

  4. コンポーネント コレクションの名前と説明を入力します。

  5. 次へを選択します。

  6. コンポーネント コレクションを追加するコンポーネントを選択します。 カテゴリと [検索] フィールドを使用して、コンポーネントのリストを絞り込むことができます。

  7. 次へを選択します。

  8. コレクションの内容を確認し、作成を選択します。

ライブラリからコンポーネント コレクションを作成する

  1. サイド ナビゲーションでライブラリを選択します。

  2. 新規追加コンポーネント コレクションの順に選択します。

  3. コンポーネント コレクションの名前と説明を入力します。

  4. 完了を選択します。

  5. 共有するコンポーネントを含むエージェントを新しいコンポーネント コレクションに接続します。

  6. 選択したエージェントからコレクションにコンポーネントを追加します

エージェントをコンポーネント コレクションに接続する

  1. ライブラリに移動し、目的のコンポーネント コレクションを選択します。 コンポーネント コレクション カテゴリと検索フィールドを選択して、コンポーネント コレクションのリストを絞り込むことができます。

  2. インストール先 領域で、エージェントの追加を選択します。

  3. コンポーネント コレクションを使用するエージェントを選択し、追加を選択します。

    接続されたエージェントの任意のコンポーネントをコンポーネント コレクションに追加できます。 接続されているすべてのエージェントは、そのコレクションの任意のコンポーネントを使用することもできます。

エージェントからコレクションにコンポーネントを追加する

  1. ライブラリに移動し、目的のコンポーネント コレクションを選択します。 コンポーネント コレクション カテゴリと検索フィールドを選択して、コンポーネント コレクションのリストを絞り込むことができます。

  2. インストール先領域にまだリストされていない場合は、コンポーネント コレクションに追加する[エージェントを接続します](#connect-an agent-to-a-component-collection)。

  3. 追加を選択してからエージェントから追加するを選択します。

  4. 希望するエージェントを選択してから次へ を選択します。

  5. コンポーネント コレクションを追加するコンポーネントを選択します。 カテゴリと [検索] フィールドを使用して、コンポーネントのリストを絞り込むことができます。

  6. 次へを選択します。

  7. コレクションの内容を確認し、コレクションに追加を選択します。

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

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

  1. ソリューション ページに移動します。

  2. 新しいソリューション を選択します。

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

    • 表示名: ソリューションのリストに表示される名前。 これは後で変更できます。
    • 名前: 表示名から生成されたソリューションの一意の名前。 ソリューションを保存する前にのみ変更できます。
    • 発行元: 既定の発行元を選択するか、または新しい発行元を作成します。 単一の発行者を作成し、ソリューションのすべての環境で一貫して使用することを検討してください。 ソリューション発行者に関する詳細。
    • バージョン: ソリューションのバージョン番号を入力します。 バージョン番号は、ソリューションをエクスポートしたときにファイル名に含まれます。
  4. 作成を選択します。

ソリューションにコンポーネント コレクションを追加する

  1. ソリューション ページに移動し、目的のソリューションを開きます。

  2. 既存を追加を選択し、エージェントをポイントし、コンポーネント コレクションを選択します。

    パネルが表示され、使用可能なすべてのコンポーネント コレクションが表示されます。

  3. エクスポートするコンポーネント コレクションを選択し、パネルの下部にある 追加 を選択します。

ソリューションをエクスポートして他の環境でコンポーネント コレクションを共有する

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

  1. ソリューション ページに移動します。

  2. エクスポートするコンポーネント コレクションを含むソリューションの コマンド アイコン () を選択し、ソリューションのエクスポートを選択します。

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

    • バージョン番号: Copilot Studio は、ソリューションのバージョンを自動的に増分します。 既定を受け入れるか、独自に入力できます。
    • エクスポート方式: 管理 、または 非管理 のパッケージ タイプを選択します。 詳細については、マネージドおよびアンマネージド ソリューションを参照してください。
  4. エクスポートを選択します。 エクスポートが完了するまでに数分かかる場合があります。 ソリューション ページの上部にあるステータス メッセージに注目します。

  5. エクスポートが終了したら、ダウンロード ボタンを選択して .ZIP ファイルをダウンロードします。

    ファイル名の形式は SolutionName_Version_SolutionType.zip (ContosoSolution_1_0_0_1_managed.zip など) です。

ソリューションをインポートしてコンポーネント コレクションを環境に追加する

  1. ソリューション ページに移動します。

  2. コンポーネント コレクションをインポートする環境を選択します。

  3. ソリューションのインポートを選択します。

  4. インポート パネルで 参照を選択し、コンポーネント コレクションを含むソリューションを含む .ZIP ファイルを選択して、次へを選択します。

  5. インポートを選択します。 インポートが完了するまでに数分かかる場合があります。 ソリューション ページの上部にあるステータス メッセージに注目します。

  6. インポートが完了するまでしばらく待ちます。

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

インポートしたコンポーネント コレクションをエージェントに追加する

コンポーネントコレクションをインポートした後、エージェントで使用できます。

  1. コンポーネント コレクションを使用するエージェントを開きます。

  2. 設定ページに移動し、コンポーネント コレクション を選択します。

  3. インポートされたコンポーネント コレクションの横にある 3 つのドット (...) を選択し、エージェントに追加を選択します。

    確認を求めるメッセージが表示されます。

  4. エージェントの追加を選択します。

    エージェントの名前は、このコンポーネント コレクションの アクティブ対象 の下に表示されます。

  5. インポートされたコレクションのコンポーネントを確認し、エージェントを公開して、顧客が変更を使用できるようにします。

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

Copilot Studio のコンポーネント コレクションに新しいエージェント コンポーネントを追加する場合は、このコンポーネント コレクションを参照するアンマネージド ソリューションにも追加する必要があります。

  1. ソリューション ページに移動し、更新するコンポーネント コレクションを含むアンマネージド ソリューションを開きます。

  2. オブジェクト ペインで、エージェント コンポーネント コレクションを選択します。

  3. 更新するコレクションの コマンド アイコン()を選択し、詳細設定をポイントして 必要なオブジェクトの追加を選択します。

  4. OK を選びます。

    オブジェクト ペインで、エージェント コンポーネント を選択して、必要なコンポーネントが表示されることを確認できます。

ソリューション エクスプローラーを開く

Copilot Studio で、サイド ナビゲーションの 3 つのドット (...) を選択し、ソリューションを選択します。

ソリューション ページが新しいブラウザー タブに表示されます。

既知の問題

エージェントのナレッジ ソースとしてアップロードした ファイル 場合、そのようなファイルをコンポーネント コレクションに追加すると、元のエージェントから削除されます。 回避策として、このようなファイルをコンポーネント コレクションから元のエージェントに戻すことができます。