コンポーネントコレクションは、エージェント間で再利用可能なコンポーネントを作成・共有することを可能にします。
コレクションを使用すると、次のことができます。
- Copilot Studio のサイド バーからコンポーネント コレクションを管理、検索、作成します、エージェントを開く必要がなく、共有文書パーツの検索と再利用が容易になります。
- ワンクリックエクスポートと簡略化されたインポートを使用します。 Copilot Studio は、バージョン管理されたソリューションにコレクションをパッケージ化し、エージェント設定から直接インポートして、作成者のエクスペリエンスを合理化できます。
- 編集アクセスを制御しながらチームメイトとコレクションを共有し、安全なコラボレーションを可能にし、コア資産を保護します。
- コレクションを制限して 、意図したエージェント ( プライマリ エージェント) のみが使用できるようにし、チームが意図しない再利用なしに大規模なコパイロットや機密性の高いコパイロットをモジュール化できるようにします。
- コンポーネントコレクションワークスペースから直接、さまざまなエージェントでコレクションがどのように動作するかをテストして、反復を高速化し、一貫した結果を確保します。
- 子エージェント、モデル コンテキスト プロトコル、コネクタ、フローなどの新しいコネクタ タイプを収集して共有します。
- 依存関係を削除または調整して資産を分離し、チーム間で独立したリリース サイクルをサポートします。
エージェントのコンポーネントには、次のものが含まれます。
- topics
- ナレッジ
- ツール
- 子エージェント
- モデル コンテキスト プロトコル
- コネクタ
- flows
- エンティティ
コンポーネント コレクションを編集したり、コンポーネント コレクションをエージェントに追加したりするには、コレクションを作成したユーザーであるか、システム カスタマイザー またはシステム管理者 ロール のユーザーである必要があります。 エージェントでコンポーネントコレクションが使用可能になると、すべてのエージェント作成者はコレクションを表示して使用できますが、コレクション内のコンポーネントを変更することはできません。 詳細については、環境でのユーザー セキュリティの構成 を参照してください。
コンポーネント コレクションを作成する
コンポーネントコレクションは、エージェントの [ 設定 ] ページ、または [コンポーネントコレクション] ページから直接作成します。 エージェントからコレクションにコンポーネントを追加すると、コンポーネントはコレクションに移動され、エージェントはコレクション内のコンポーネントを参照します。
コレクションを環境内の他のエージェントと共有したり、エクスポートして他の環境にインポートしたりできます。
エージェントからコンポーネント コレクションを作成する
コンポーネント コレクションとして利用可能にするコンポーネントを含むエージェントを開きます。
設定 に移動し、コンポーネント コレクション を選択します。
環境で最初のコンポーネント コレクションを作成する場合は、作成を選択します。 それ以外の場合は、新規を選択します。
コンポーネント コレクションの名前と説明を入力します。
次へを選択します。
コンポーネント コレクションを追加するコンポーネントを選択します。 カテゴリと [検索] フィールドを使用して、コンポーネントのリストを絞り込むことができます。 コレクションの確認時に子エージェントを接続できます。
コンポーネントの依存関係は自動的に選択され、コレクションに追加されます。 依存関係を除外できるのは、 コンポーネント コレクションのプライマリ エージェントを設定している場合のみです。
プライマリ・エージェントは、コレクション内のコンポーネントを所有するエージェントです。 プライマリエージェントを設定しない場合、コンポーネントコレクションは環境によって所有されるため、依存関係にアクセスする必要があります。
ヒント
エージェントのナレッジ ソースとしてアップロードした ファイル 場合、そのようなファイルをコンポーネント コレクションに追加すると、元のエージェントから削除されます。
回避策として、このようなファイルをコンポーネント コレクションから元のエージェントに戻すことができます。次へを選択します。
コレクションの内容を確認し、作成を選択します。
環境レベルでのコンポーネント コレクションの作成
サイドバーで3つの点(...)を選択し、その後 コンポーネントコレクションを選択します。
新規追加、コンポーネント コレクションの順に選択します。
コンポーネント コレクションの名前と説明を入力します。
完了を選択します。
共有するコンポーネントを含むエージェントを新しいコンポーネント コレクションに接続します。
選択したエージェントからコレクションにコンポーネントを追加します。
エージェントをコンポーネント コレクションに接続する
サイドバーで3つの点(...)を選択し、その後 コンポーネントコレクションを選択します。
エージェントに接続するコレクションを選択します。
[ 接続されたエージェント] セクションで、 [ エージェントの追加] を選択します。 接続するエージェントを選択し、[ 追加] を選択します。
接続されたエージェントの任意のコンポーネントをコンポーネント コレクションに追加できます。 接続されているすべてのエージェントは、そのコレクションの任意のコンポーネントを使用することもできます。
エージェントからコレクションにコンポーネントを追加する
サイドバーで3つの点(...)を選択し、その後 コンポーネントコレクションを選択します。
コンポーネントを追加するコレクションを選択します。
コレクションで再利用するコンポーネントを含むエージェントをまだ接続していない場合は、接続します。
[ コンポーネントの追加 ] セクションで、[ エージェントからの追加] を選択します。
Note
エージェントをコンポーネント コレクションに接続していない場合、エージェントからコンポーネントを追加するオプションは使用できません。
希望するエージェントを選択してから次へ を選択します。
コンポーネント コレクションを追加するコンポーネントを選択します。 カテゴリラベルと [ コンポーネントの検索 ] フィールドを使用して、コンポーネントのリストを絞り込むことができます。
次へを選択します。
コレクションの内容を確認し、コレクションに追加を選択します。
コンポーネント コレクションのプライマリ エージェントを設定し、依存関係を除外する
1 つのエージェントをコンポーネント・コレクションのプライマリ・エージェントとして設定できます。 作成者は、1 つの特定のエージェントだけにコンポーネント コレクションを使用させる場合、プライマリ エージェントを選択することができます。
コレクションに複数の接続エージェントがある場合、プライマリ エージェントを設定することはできません。 最初に他のすべてのエージェントを切断する必要があります。
プライマリエージェントを設定するときに、そのエージェントからコンポーネントを追加するときに依存関係を除外することもできます。 これにより、すべての依存関係を含まない小さなコンポーネントコレクションを作成できるため、特定のコンポーネントのみを共有する場合に役立ちます。
サイドバーで3つの点(...)を選択し、その後 コンポーネントコレクションを選択します。
プライマリエージェントを設定するコレクションを選択します。
「接続されたエージェント」セクションで、エージェントの横にある3つの点(...)を選択し、「メインエージェントを設定する」を選択してください。
Important
コレクションに複数の接続エージェントがある場合、プライマリ エージェントを設定するオプションは使用できません。 プライマリとして設定するエージェント以外のエージェントごとに、[ エージェントから切断] を選択します。
プライマリエージェントからコンポーネントを追加するときに依存関係を除外するには:
コンポーネントコレクションの エージェントから追加 を選択します。
プライマリ エージェントを選択し、[ 次へ] を選択します。
コンポーネント コレクションを追加するコンポーネントを選択します。 [コンポーネントの依存関係を含める] をオフにします。
次へを選択します。
コレクションの内容を確認し、コレクションに追加を選択します。
コンポーネントコレクションの共有
コンポーネント・コレクションを組織内の他のユーザーと共有し、そのユーザーが 閲覧 者権限または 編集者 権限を持っているかどうかを指定できます。 Copilot Studio ユーザーのアクセス許可ロールの詳細については、「エージェントの共有方法の制御を参照してください。
サイドバーで3つの点(...)を選択し、その後 コンポーネントコレクションを選択します。
共有するコレクションを選択します。
上部のメニュー バーで、 [共有] を選択します。
共有パネルで、コンポーネントコレクションを共有する他のユーザーの名前または電子メールアドレスを入力します。 ユーザーごとに、権限ロール (閲覧者 または 編集者) を指定します。
コレクションのインポートとエクスポート
コレクションをエクスポートして、他の環境にインポートできます。 コレクションをエクスポートすると、管理対象になります。 管理せずにコレクションをエクスポートするには、「 複雑なコレクションにソリューションを使用する」を参照してください。
コレクションをエクスポートするには:
サイドバーで3つの点(...)を選択し、その後 コンポーネントコレクションを選択します。
エクスポートするコレクションを開きます。
上部のメニュー バーで、[ エクスポート] を選択します。
エクスポートが開始され、通知バーが表示されます。 エクスポートの準備ができると、通知が変更され、コレクションを .zip ファイルとしてダウンロードするためのリンクが含まれます。
コレクションをインポートするには:
Copilot Studio で、コレクションをインポートする環境が選択されていることを確認します。
コレクションに接続するエージェントを開き、上部のバーで 設定 を選択します。
サイド メニューの コンポーネント コレクション を選択し、 ソリューションのインポート を選択します。
表示されるパネルで、[ ファイルの参照 ] を選択し、エクスポートされたコレクションを選択します。
コレクションの詳細が表示されます。 プラグインのステップとフローは、 詳細設定 セクションで除外できます。
ヒント
コレクションをエクスポート元と同じ環境にインポートしようとすると、エラー メッセージが表示されます。 コレクションが含まれていないターゲット環境にいることを確認します。
次へを選択します。 インポートパネルが閉じられ、コレクションが正常にインポートされたというメッセージが表示されます。
複雑なコレクションにソリューションを使用する
また、ソリューションを使用して、ある環境からエージェント・コンポーネントをエクスポートし、別の環境にインポートすることもできます。 このソリューションは、コンポーネントのキャリアとして機能します。 1 つのソリューションで複数のエージェント コンポーネントをエクスポートおよびインポートできます。
一般に、複雑なコンポーネント コレクションにはソリューションを使用します。 たとえば、コレクションに コネクタ または 環境変数がある場合などです。
ソリューションの作成
ソリューション ページに移動します。
新しいソリューションを選択します。
新しいソリューションに関する次の情報を入力します:
- 表示名: ソリューションのリストに表示される名前。 これは後で変更できます。
- 名前: 表示名から生成されたソリューションの一意の名前。 ソリューションを保存する前にのみ変更できます。
- 発行元: 既定の発行元を選択するか、または新しい発行元を作成します。 単一の発行者を作成し、ソリューションのすべての環境で一貫して使用することを検討してください。 ソリューション発行者に関する詳細。
- バージョン: ソリューションのバージョン番号を入力します。 バージョン番号は、ソリューションをエクスポートしたときにファイル名に含まれます。
作成を選択します。
ソリューションにコンポーネント コレクションを追加する
ソリューション ページに移動し、目的のソリューションを開きます。
既存を追加を選択し、エージェントをポイントし、コンポーネント コレクションを選択します。
パネルが表示され、使用可能なすべてのコンポーネント コレクションが表示されます。
エクスポートするコンポーネント コレクションを選択し、パネルの下部にある 追加 を選択します。
ソリューションをエクスポートして他の環境でコンポーネント コレクションを共有する
コンポーネント コレクションを含むソリューションをある環境から別の環境にエクスポートおよびインポートすることにより、コンポーネント コレクションをエクスポートおよびインポートします。
ソリューション ページに移動します。
エクスポートしたいコンポーネントコレクションを含むソリューションの3つの点(⋮)を選択し、「 ソリューションをエクスポート」を選択します。
以下のオプションを入力または選択します:
- バージョン番号: Copilot Studio によってソリューションのバージョンが自動的にインクリメントされます。 既定を受け入れるか、独自に入力できます。
- エクスポート方式: 管理 、または 非管理 のパッケージ タイプを選択します。 詳細については、マネージドおよびアンマネージド ソリューションを参照してください。
エクスポートを選択します。 エクスポートが完了するまでに数分かかる場合があります。 ソリューション ページの上部にあるステータス メッセージに注目します。
エクスポートが終了したら、ダウンロード ボタンを選択して .ZIP ファイルをダウンロードします。
ファイル名の形式は SolutionName_Version_SolutionType.zip (ContosoSolution_1_0_0_1_managed.zip など) です。
ソリューションをインポートしてコンポーネント コレクションを環境に追加する
ソリューション ページに移動します。
コンポーネント コレクションをインポートする環境を選択します。
ソリューションのインポートを選択します。
インポート パネルで 参照を選択し、コンポーネント コレクションを含むソリューションを含む .ZIP ファイルを選択して、次へを選択します。
[ インポート] を選択します。 インポートが完了するまでに数分かかる場合があります。 ソリューション ページの上部にあるステータス メッセージに注目します。
インポートが完了するまでしばらく待ちます。
インポートが失敗した場合は、ログ ファイルのダウンロードを選択して、インポートが失敗した原因に関する詳細を含む XML ファイルをダウンロードします。 インポートの失敗の最も一般的な原因は、ソリューションに必要コンポーネントが含まれていないことです。
インポートしたコンポーネント コレクションをエージェントに追加する
コンポーネントコレクションをインポートした後、エージェントで使用できます。
コンポーネント コレクションを使用するエージェントを開きます。
設定ページに移動し、コンポーネント コレクション を選択します。
インポートされたコンポーネント コレクションの横にある 3 つのドット (...) を選択し、エージェントに追加を選択します。
確認を求めるメッセージが表示されます。
[ エージェントに追加] を選択します。
エージェントの名前は、このコンポーネント コレクションの アクティブ対象 の下に表示されます。
インポートされたコレクションのコンポーネントを確認し、エージェントを公開して、顧客が変更を使用できるようにします。
カスタム ソリューションのコンポーネント コレクションにコンポーネントを追加する
Copilot Studio のコンポーネント コレクションに新しいエージェント コンポーネントを追加する場合は、そのコンポーネント コレクションを参照するアンマネージド ソリューションにも追加する必要があります。
ソリューション ページに移動し、更新するコンポーネント コレクションを含むアンマネージド ソリューションを開きます。
オブジェクト ペインで、エージェント コンポーネント コレクションを選択します。
更新したいコレクションの3つの点(⋮)を選択し、「 Advanced」を指し、「 必要なオブジェクトを追加」を選択します。
[OK] を選択.
オブジェクト ペインで、エージェント コンポーネント を選択して、必要なコンポーネントが表示されることを確認できます。
ソリューション エクスプローラーを開く
Copilot Studio で、3 つのドット (...サイド バーの ) を選択し、Solutions を選択します。
ソリューション ページが新しいブラウザー タブに表示されます。