[前提条件]
Microsoft Visual Studio Code用のMicrosoft Copilot Studio拡張機能をインストールする前に、以下の要件を満たしていることを確認してください。
システム要件
-
オペレーティング システム:
- Windows(x64アーキテクチャ)
- Windows 10 バージョン 1809 以降
- Windows 11(どのバージョンでも)
- macOS
- Windows(x64アーキテクチャ)
- Visual Studio Code: バージョン1.80以降(最新の安定版推奨)
- インターネット接続: インストールおよび認証に必要
アカウント要件
- Microsoftアカウント: Copilot Studioライセンスまたはアクセス権を持つアクティブなMicrosoftアカウント
- コパイロットスタジオライセンス: アカウントに割り当てられた適切なライセンス
- 環境アクセス: 少なくとも1つのCopilot Studio環境へのアクセス権限
- エージェント権限: 編集予定のエージェントへのアクセスを読み書きします
インストール手順
Visual Studio CodeにCopilot Studio拡張機能をインストールする方法は2つあります:
- Visual Studio Code 内からインストールする
- Visual Studio Code Marketplaceのウェブサイトからインストール
方法1:Visual Studio Codeからインストール
アクティビティバーの 拡張機能 アイコンを選択するか、
Ctrl+Shift+Xを押してください。 拡張機能ペインはVisual Studio Codeで開きます。検索バーに「Copilot Studio」と入力してください。結果リストで公式のCopilot Studio拡張機能を探してください。 出版社が「Microsoft」であることを確認しましょう。
正しい拡張機能を見つけたら、それを選択して拡張機能の詳細ページを開きます。
インストール を選択してインストール を開始してください。
インストールが完了するまで待ちます。 Visual Studio Codeの再読み込みを求めるプロンプトが表示される場合、その場合は「 再読み込み 」を選択してください。
設置状況を確認してください。 アクティビティバーのCopilot Studioアイコンを探してください。 アイコンはCopilot Studioのブランドで表示されます。
方法2:Visual Studio Codeマーケットプレイスのウェブサイトからインストール
https://marketplace.visualstudio.com/に行って「Copilot Studio」を検索してください。直接リンクもご利用いただけます:https://marketplace.visualstudio.com/items?itemName=ms-CopilotStudio.vscode-copilotstudio。マーケットプレイスページで 「インストール 」を選択してください。 ブラウザのプロンプトがVisual Studio Codeのダウンロードを促し、その後にVisual Studio Codeを開くよう促すことがあります。
アクティビティバーの拡張機能アイコンを探して、ブラウザでVisual Studio Codeを開き、インストールを確認しましょう。
初期構成
初回打ち上げ
アクティビティバーのCopilot Studioアイコンを選択してください。 拡張機能はアプリケーションパネルとして開きます。 ポップアップ通知が表示され、Copilot Studio拡張機能がサインインを必要としていることを示します。
ポップアップで 「サインイン 」を選択し、次に 「許可」を選択します。 デフォルトのブラウザはMicrosoft認証ページに開きます。
認証情報を入力し、必要に応じて多要素認証を行ってください。
要求された許可内容を確認してください:
- Copilot Studioのエージェントを読み書きします
- 環境情報へのアクセス
- ファイルをクラウドに同期する
「承認」または「許可」を選択してください。 ブラウザはウィンドウを閉じてVisual Studio Codeに戻っていいと促します。
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拡張機能のインストールや設定時に発生する可能性のある問題のトラブルシューティング手順です。
拡張が表示されません
問題点: アクティビティバーにはCopilot Studioのアイコンが表示されません。
Solution:
- Visual Studio Code をリロード
- 拡張機能を選択し、インストールリストで拡張機能を探してください。 拡張機能が無効化されていないことを確認してください。
- Visual Studio Codeを最新バージョンにアップデートしてください。
- 拡張機能を再インストールしてください。
認証エラー
問題点: 認証が失敗したり、繰り返しループしたりします。
Solution:
ブラウザのキャッシュとクッキーを
microsoft.comためにクリアしてください。別のブラウザでサインインしてみてください。 このブラウザを一時的にデフォルトに設定してください。
認証をブロックする可能性のあるブラウザ拡張機能を無効にしましょう。
企業のファイアウォールとプロキシの設定を確認してください。
サポートされているアカウントタイプを使っていることを確認してください。
Visual Studio Codeマーケットプレイスに拡張機能が見つからない
問題点: Copilot Studioの拡張機能を探しても見つかりません。
Solution:
必ず拡張機能 のパネルで 検索しているか確認してください。ウェブ検索ではなく。
スペルを確認してください:「Copilot Studio」。
管理者に連絡して、組織がVisual Studio Codeマーケットプレイスのアクセスを制限しているかどうかを確認してください。
拡張機能をアンインストールする
拡張を外すには:
拡張機能の窓を開いてください。
インストール済み拡張機能で Copilot Studio を見つけてください。
リストの項目で「管理 (歯車アイコン)」 >アンインストール。
プロンプトがあればVisual Studio Codeを読み込み直してください。
注
拡張機能をアンインストールしても、ローカルにクローンされたエージェントファイルは削除されません。 これらのファイルは手動で削除する必要があります。
次のステップ
拡張機能をインストールし、Copilot Studioで認証した後、次の準備が整います: