Microsoft Visual Studio CodeでMicrosoft Copilot Studioエージェントをクローンする

Microsoft Copilot Studioのエージェントを拡張でクローンすると、Copilot Studioからエージェントの定義および関連するコンポーネントの定義をローカルマシンにダウンロードします。これらのファイルはMicrosoft Visual Studio Codeを使って編集できます。クローン操作は、すべてのエージェントファイルを含む構造化ディレクトリ形式のローカルワークスペースを作成します。

[前提条件]

クローンエージェントのクローンを始める前に、いくつかの重要な前提条件と考慮事項があります。

作業場所を選ぶ

エージェントファイルに適切なローカルフォルダを選択します。この場所は拡張機能がエージェントファイルを保存する場所です。場所を選ぶ際の重要なポイントをいくつかご紹介します。

十分なディスク容量を確保しましょう。典型的なエージェントは、成分数によってサイズがさまざまです。
可能であればスペースのないパスを使いましょう。ただしスペースはサポートされています。
Gitで既に追跡されている場所を使うことを検討してください。

何がクローンされるのかを理解する

エージェントをクローンすると、エージェントファイルは選んだ場所にローカルでクローンされ、Visual Studio Code Explorerで次のような構造定義が作成されます。

my-agent/
├── actions                   # Connectors
│   ├── DevOpsAction.mcs.yml  
│   └── GetItems.mcs.yml      
├── knowledge/files                # Knowledge sources
│   ├── source1.yaml
│   └── source2.yaml
├── topics/                   # Conversation topics
│   ├── greeting.mcs.yaml
│   ├── help.mcs.yaml
│   └── escalate.mcs.yaml
├── workflows/                    # Agent tools and actions
│   └── GetDevOpsItems
│       ├── metadata.yaml
│       └── workflow.json
│   └── GetMeetings
│       ├── metadata.yaml
│       └── workflow.json
├── trigger/                 # Event triggers
│   └── welcometrigger.mcs.yaml
├── agent.mcs.yaml                # Main agent definition
├── icon.png                      # Icon used for the agent, visible in test panel and in supported channels
├── settings.mcs.yml              # Configuration settings for the agent
└── connectioreferences.mcs.yml   # Connection References used by Connectors and other actions

クローン方法

拡張機能を初めて使う場合や、Visual Studio Codeを初めて使う場合、エージェントをクローンする最も簡単な方法は、拡張機能のペインが開いているときに「Clone Agent」を選択することです。ただし、すでにエージェントをクローンしてローカルで開いている場合はこのオプションは利用できません。代わりに以下の方法が用いられます:

方法1:エージェントのパネルからクローン(推奨)

これはエージェントをクローンする最もシンプルで推奨される方法です。

アクティビティバーのCopilot Studioアイコンを選択して、Copilot Studio拡張機能を開きます。また、 Ctrl+Shift+P を押して「Copilot Studio: Focus on Agents View」と入力することもできます。サイドバーでCopilot Studioのペインが開きます。
エージェントペインで、ドロップダウンリスト(例:「環境1」)からターゲット環境を選択すると、その環境内のエージェントのリストが表示されます。
```
> Environment 1
  Environment 2
  Environment 3
```
リストからクローンするエージェントを選択します。エージェントは最終修正日を表示する。エージェント名を右クリックして「 クローンエージェント」を選択してください。
```
> Customer Support Agent
    HR Assistant
    Sales Agent
    IT Helpdesk Agent
```
ファイルピッカーのダイアログが開きます。
ファイルピッカーのダイアログで希望の場所に移動し、新しいフォルダを作成して「 フォルダ選択」を選択してください。クローン作成のプロセスが始まります。
クローン作成が完了するまで待ちましょう。「エージェントのクローン:カスタマーサポートボット」という進行状況通知が表示され、その後に「エージェントの成功した」という成功メッセージが表示されます。このプロセスは通常10〜30秒かかります。
クローン作成が成功したか確認してください。エージェントフォルダはVisual Studio Codeエクスプローラーで開き、ソース管理のペインにはクリーンな動作ツリーが表示され、ファイルウィンドウにはフォルダ名が表示されます。

方法3:コマンドパレットを使ったクローン

キーボード重視のワークフローが好きならこの方法を使いましょう。

コマンドパレットを開くには Ctrl+Shift+Pキーキーがあります。
「Copilot Studio: Clone Agent」と入力し、 Enterを押してください。コマンドが実行され、プロンプトが表示されます。
プロンプトに従って環境を選択し、エージェントを選び、宛先フォルダを選び、クローンが完了するのを待ちます。エージェントはあなたが選んだ場所にクローンされます。

方法3:エージェントURLを使ったクローン

この方法は、誰かがエージェントのURLを共有してくれた場合に役立ちます。

Copilot Studioのウェブポータルでエージェントを開いてください。
設定>エージェント詳細を選択し、エージェントURLをコピーします。 URLのフォーマットは https://copilotstudio.microsoft.com/environments/{guid}/bots/{guid}であるべきです。 URLは今やクリップボードに入っています。
Visual Studio Codeに戻り、Copilot Studio拡張機能を開きます。
ク ローンエージェントを選択。拡張機能はクリップボード内のURLを検出し、「(from clipboard)」とマークされたエージェントを表示します。
「(クリップボードから)」とマークされたエージェントを選択し、宛先フォルダを選択してクローンが完了するまで待ちます。エージェントはあなたが選んだ場所にクローンされます。

一般的なクローン作成シナリオ

ここでは、エージェントのクローン作成が有用な一般的なシナリオと、推奨されるワークフローの概要をいくつか紹介します。

シナリオ1:ソロ開発のためのクローン

目標: 一人でエージェントを手配してみてください

エージェントをローカルフォルダにクローンします。
ナビゲーションのSource ControlからGitリポジトリを初期化します。
ローカルに変更を加えます。
コミットをしてください。
準備ができたらCopilot Studioに変更を適用してください。

シナリオ2:チームコラボレーションのためのクローン

目標: 複数の開発者が同じエージェントで作業しています

最初の開発者がエージェントをクローンします。
最初の開発者はGitを初期化し、コンテンツを共有リポジトリ(GitHub、Azure DevOps)にプッシュします。
共有のGitリポジトリから他の開発者がクローンをした場合も。
各開発者は Copilot Studio: Reattach Agent を実行し、ローカルフォルダをCopilot Studioに接続しています。
チームはGitを使ってコラボレーションや変更の追跡を行い、Visual Studio Code拡張機能を使ってエージェントの作業を行っています。
各開発者は、ソフトウェア開発ライフサイクルや自動化されたパイプラインに基づいて、テストのためにCopilot Studioに変更を適用したり、別の下流環境にプッシュしたりします。

シナリオ3:複数の環境をクローンする

目標: 開発、テスト、本番バージョンの管理

複数の環境での展開に推奨されるアプローチはソリューションを使うことです。パイプラインのように監査可能でスケーラブルな組織プロセスを備えた自動化展開プロセスを考えてみてください。ソリューションを使わないユーザー向けに、Copilot Studio拡張はローカルマシンから別の環境へCopilot Studioエージェント定義を同期する機能を提供します。技術資産を下流環境に移し、監査、テレメトリ、その他の重要なコンポーネントを提供できるよう、顧客やエンドユーザーにソフトウェアを出荷する際の組織的プロセスも考慮すべきです。

開発環境からローカルの開発フォルダにエージェントをクローンします。
開発フォルダで変更を加えてください。
その変更を適用し、同じ環境でテストします。
Copilot Studio: Reattached Agentを使ってエージェントを代替環境に接続してください。
Copilot Studioのテストウィンドウでエージェントをテストしてください。

ベストプラクティス

推奨

すべてのエージェントを一定の場所にクローンしてください。
クローン直後にGitを初期化してください。
意味のあるフォルダ名を使いましょう。
変更する前にクローンが動作しているか確認してください。
クローンの場所はバックアップ(例えばGitHubやAzure DevOps)に保管してください。
クローンの場所はチーム内のウィキやドキュメントに記録してください。

できません

一時的なディレクトリにクローンしないでください。
異なる場所に複数回クローンしないでください。そうすると混乱を招くことがあります。

次のステップ

エージェントをクローンした後:

エージェントコンポーネントの編集方法を学びましょう。
同期を理解しましょう。

フィードバック

このページはお役に立ちましたか?

Last updated on 2026-01-14