Microsoft Visual Studio Code でMicrosoft Copilot Studio エージェントを複製する

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

前提条件

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

作業場所を選ぶ

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

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

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

エージェントを複製すると、エージェント ファイルは選択した場所にローカルに複製され、Visual Studio Code エクスプローラーで次のような構造定義が作成されます。

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 自体が初めての場合、エージェントをクローンする最も簡単な方法は、拡張機能ペインが開いている状態でエージェントをクローンするを選択することです。 ただし、すでにエージェントをクローンしてローカルで開いている場合はこのオプションは利用できません。 代わりに以下の方法が用いられます:

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

  1. アクティビティ バーの Copilot Studio アイコンを選択して、Copilot Studio 拡張機能を開きます。 Ctrl+Shift+P を押して、「Copilot Studio: Focus on Agents View」と入力することもできます。サイドバーに Copilot Studio ペインが開きます。

  2. エージェントペインで、ドロップダウンリスト(例:「環境1」)からターゲット環境を選択すると、その環境内のエージェントのリストが表示されます。

    > Environment 1
  Environment 2
  Environment 3

  3. リストからクローンするエージェントを選択します。 エージェントは最終修正日を表示する。 エージェント名を右クリックして「 クローンエージェント」を選択してください。

    > Customer Support Agent
    HR Assistant
    Sales Agent
    IT Helpdesk Agent

    ファイルピッカーのダイアログが開きます。

  4. ファイルピッカーのダイアログで希望の場所に移動し、新しいフォルダを作成して「 フォルダ選択」を選択してください。 クローン作成のプロセスが始まります。

  5. クローン作成が完了するまで待ちましょう。 「エージェントのクローン:カスタマーサポートボット」という進行状況通知が表示され、その後に「エージェントの成功した」という成功メッセージが表示されます。このプロセスは通常10〜30秒かかります。

  6. クローン作成が成功したか確認してください。 Visual Studio Codeのエクスプローラーでエージェントフォルダーが開き、ソース管理パネルにはクリーンな状態の作業ツリーが表示され、ファイルウィンドウにフォルダーの名前が表示されます。

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

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

  1. コマンドパレットを開くには Ctrl+Shift+Pキーを押してください。

  2. 「Copilot Studio: Clone Agent」と入力し、Enter キーを押します。 コマンドが実行され、プロンプトが表示されます。

  3. プロンプトに従って環境を選択し、エージェントを選び、宛先フォルダを選び、クローンが完了するのを待ちます。 エージェントはあなたが選んだ場所にクローンされます。

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

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

  1. Copilot Studio Web ポータルでエージェントを開きます。

  2. 設定>を選択し、エージェントURLをコピーします。 URLのフォーマットは https://copilotstudio.microsoft.com/environments/{guid}/bots/{guid}であるべきです。 URLは今やクリップボードに入っています。

  3. Visual Studio Codeに戻り、Copilot Studio 拡張機能を開きます。

  4. クローンエージェントを選択。 拡張機能はクリップボード内のURLを検出し、「(from clipboard)」とマークされたエージェントを表示します。

  5. 「(クリップボードから)」とマークされたエージェントを選択し、宛先フォルダを選択してクローンが完了するまで待ちます。 エージェントはあなたが選んだ場所にクローンされます。

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

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

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

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

  1. エージェントをローカルフォルダにクローンします。

  2. ナビゲーションのSource ControlからGitリポジトリを初期化します。

  3. ローカルに変更を加えます。

  4. コミットをしてください。

  5. 準備ができたら、Copilot Studio に変更を適用します。

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

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

  1. 最初の開発者がエージェントをクローンします。

  2. 最初の開発者は Git を初期化し、コンテンツを共有リポジトリ (GitHub、Azure DevOps) にプッシュします。

  3. 他の開発者は共有のGitリポジトリからクローンを作成します。

  4. 各開発者は Copilot Studio: Reattach Agent を実行して、ローカル フォルダーを Copilot Studio に接続します。

  5. チームは、コラボレーションと変更の追跡に Git を使用し、Visual Studio Code拡張機能を使用してエージェントで作業します。

  6. その後、各開発者は、ソフトウェア開発ライフサイクルまたは自動化されたパイプラインに基づいて、Copilot Studio に変更を適用してテストまたは別のダウンストリーム環境にプッシュします。

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

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

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

  1. 開発環境からローカルの開発フォルダにエージェントをクローンします。

  2. 開発フォルダで変更を加えてください。

  3. その変更を適用し、同じ環境でテストします。

  4. Copilot Studio: Reattach Agent を使用して、エージェントを別の環境に接続します。

  5. Copilot Studio のテスト ウィンドウでエージェントをテストします。

ベスト プラクティス

すべきこと

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

できません

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

次のステップ

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

  • Last updated on