Microsoft Visual Studio Code のMicrosoft Copilot Studio拡張機能をインストールする

Note

本記事では 、標準ハーネスで駆動されるエージェントやエージェントフローで使用される機能について説明します。

Prerequisites

Microsoft Visual Studio Code のMicrosoft Copilot Studio拡張機能をインストールする前に、次の要件を満たしていることを確認してください。

システム要件

  • オペレーティング システム：
    • Windows (x64 アーキテクチャ)
      • Windows 10 バージョン 1809 以降
      • Windows 11 (任意のバージョン)
    • macOS
  • Visual Studio Code: バージョン 1.80 以降 (最新の安定バージョンを推奨)
  • インターネット接続: インストールおよび認証に必要

アカウント要件

  • Microsoft アカウント: Copilot Studio のライセンスまたはアクセス権を持つアクティブな Microsoft アカウント
  • Copilot Studio license: アカウントに割り当てられた適切なライセンス
  • Environment access: 少なくとも 1 つの Copilot Studio 環境にアクセスするためのアクセス許可
  • エージェント権限: 編集予定のエージェントへのアクセスを読み書きします

インストール手順

Copilot Studio拡張機能は、Visual Studio Codeに2つの方法でインストールできます:

  • Visual Studio Code内からインストールする
  • Visual Studio Code Marketplace Web サイトからインストールする

方法 1: Visual Studio Codeからインストールする

  1. アクティビティバーの 拡張機能 アイコンを選択するか、 Ctrl+Shift+Xを押してください。 Extensions ペインがVisual Studio Codeで開きます。

  2. 検索バーに「Copilot Studio」と入力します。結果一覧で公式の Copilot Studio 拡張機能を探します。 出版社が「Microsoft」であることを確認しましょう。

  3. 正しい拡張機能を見つけたら、それを選択して拡張機能の詳細ページを開きます。

  4. インストール を選択してインストール を開始してください。

  5. インストールが完了するまで待ちます。 Visual Studio Codeの再読み込みを求めるプロンプトが表示される場合があります。その場合は、プロンプトが表示されたら Reload を選択します。

  6. 設置状況を確認してください。 アクティビティ バーで Copilot Studio アイコンを探します。 アイコンは、Copilot Studio のブランド化と共に表示されます。

方法 2: Visual Studio Code Marketplace Web サイトからインストールする

  1. https://marketplace.visualstudio.com/ に移動し、"Copilot Studio" を検索します。直接リンク (https://marketplace.visualstudio.com/items?itemName=ms-CopilotStudio.vscode-copilotstudio) を使用することもできます。

  2. マーケットプレイスページで 「インストール 」を選択してください。 ブラウザーでVisual Studio Codeを開くように求めるメッセージが表示される前に、Visual Studio Codeをダウンロードするように求められる場合があります。

  3. ブラウザーでVisual Studio Codeを開き、アクティビティ バーで拡張機能アイコンを探してインストールを確認できるようにします。

初期構成

初回打ち上げ

  1. アクティビティ バーの Copilot Studio アイコンを選択します。 拡張機能はアプリケーションパネルとして開きます。 ポップアップ通知が表示され、Copilot Studio拡張機能にサインインが必要であることを示します。

  2. ポップアップで 「サインイン 」を選択し、その後 「許可」を選択します。 デフォルトのブラウザはMicrosoft認証ページに開きます。

  3. 認証情報を入力し、必要に応じて多要素認証を行ってください。

  4. 要求された許可内容を確認してください:

    • Copilot Studio エージェントの読み取りと書き込み
    • 環境情報へのアクセス
    • ファイルをクラウドに同期する

    「承認」または「許可」を選択してください。 ブラウザーから、ウィンドウを閉じてVisual Studio Codeに戻ることができるというメッセージが表示されます。

  5. Visual Studio Code に戻ります。 拡張機能のペインは、アクセス可能な環境とそれらの環境内のエージェントを読み込みます。

セットアップが成功しているか確認してください

認証後、Visual Studio CodeのCopilot Studio拡張機能内のAgentsパネルの下に構造が表示されます。 環境グループのリストが見えます。環境とエージェントはネストされており、以下の構造に似ています。

AGENTS
  └─ Environment Group (for example, developer, default, sandbox, production)
      ├─ Example Environment 1
      │   ├─ Agent 1
      │   └─ Agent 2
      └─ Example Environment 2
          └─ Agent 3

インストールのトラブルシューティング

以下のトラブルシューティング手順は、Copilot Studio Visual Studio Code拡張機能のインストールや設定時に起こりうる問題の一部に対応します。

拡張が表示されません

Problem: Copilot Studio アイコンがアクティビティ バーに表示されません。

Solution:

  1. Visual Studio Codeを再読み込みします。
  2. 拡張機能を選択し、インストールリストで拡張機能を探してください。 拡張機能が無効化されていないか確認してください。
  3. Visual Studio Codeを最新バージョンに更新します。
  4. 拡張機能を再インストールしてください。

認証エラー

問題点: 認証が失敗したり、繰り返しループしたりします。

Solution:

  1. ブラウザのキャッシュとクッキーを microsoft.comためにクリアしてください。

  2. 別のブラウザでサインインしてみてください。 このブラウザを一時的にデフォルトに設定してください。

  3. 認証をブロックする可能性のあるブラウザ拡張機能を無効にしましょう。

  4. 企業のファイアウォールとプロキシの設定を確認してください。

  5. サポートされているアカウントタイプを使っていることを確認してください。

Visual Studio Code マーケットプレースに拡張機能が見つかりません

問題点:検索してもCopilot Studio拡張機能が見つかりません。

Solution:

  1. 検索はウェブ検索ではなく 拡張機能 のパネルで検索してください。

  2. スペル チェック: "Copilot Studio"。

  3. 管理者に問い合わせて、組織がマーケットプレースへのアクセスVisual Studio Code制限しているかどうかを確認します。

拡張機能をアンインストールする

拡張機能を削除するには:

  1. 拡張機能の窓を開いてください。

  2. インストールされている拡張機能で Copilot Studio を見つけます。

  3. リストの項目で「 管理 」アイコンを選択し、「 アンインストール」を選択してください。

  4. メッセージが表示されたら、Visual Studio Codeを再読み込みします。

Note

拡張機能をアンインストールしても、ローカルにクローンされたエージェントファイルは削除されません。 これらのファイルは手動で削除する必要があります。

次のステップ

拡張機能をインストールし、Copilot Studio で認証したら、次の準備が整います。

  • Last updated on