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

[前提条件]

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 環境にアクセスするためのアクセス許可
  • エージェント権限: 編集予定のエージェントへのアクセスを読み書きします

インストール手順

Visual Studio Codeで Copilot Studio 拡張機能をインストールするには、次の 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 マーケットプレースに拡張機能が見つかりません

Problem: 検索時に Copilot Studio 拡張機能が見つかりません。

Solution:

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

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

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

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

拡張を外すには:

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

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

  3. リストの項目で「管理 (歯車アイコン)」を選択し、「>」を実行します。

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

注

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

次のステップ

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

  • Last updated on