GitHub Codespaces を使用したエージェント開発キットのインストール

  • 適用対象: ✅ Microsoft Copilot

GitHub Codespaces には、キットがプレインストールされたブラウザーでクラウドでホストされる Visual Studio Code が用意されています。 自分のコンピューターには何もインストールしません。 手順全体に必要な時間は約 5 分です。

Codespaces は、次のような場合に使用します。

  • ソフトウェアをローカル (企業が管理するデバイス、ロックダウンされた環境) にインストールすることはできません。
  • macOS、Linux、または Windows 以外のマシンを使用している。
  • ローカルにインストールするかどうかを決定する前に、キットを試してみたい場合。

開始する前に

必要なもの:

  • アクティブな GitHub Copilot サブスクリプションを持つ GitHub アカウント。
  • 最新のブラウザー。

Codespaces には、1 か月あたり 120 コア時間 (キットで使用される 2 コア マシンでは 60 時間) の 無料利用枠 が含まれています。 Codespace は、非アクティブな状態が 30 分間続くと自動的に一時停止するため、アクティブな作業時間に対してのみ課金されます。

GitHub アカウントが organization の一部であり、Codespaces を使用できない場合は、管理者が有効にする必要がある場合があります。 「organization の Codespaces の管理」を参照してください。

Codespace を作成する

  1. ブラウザーでこのリンクを開きます。

    https://github.com/codespaces/new?repo=microsoft/Employee-Self-Service-Agent-Developer-Kit&ref=main&devcontainer_path=.devcontainer%2Fdevcontainer.json

  2. メッセージが表示されたら、GitHub にサインインします。

  3. [ コード空間の作成 ] ページでは、既定値のままにして、 2 コア のマシンの種類を選択します。

  4. [ codespace の作成] を選択します。

GitHub により Codespace がビルドされます。 最初のビルドでは、Python、キットの依存関係、GitHub Copilot 拡張機能がインストールされるため、数分かかります。 同じ Codespace を後続起動すると高速になります。

正しいフォルダーを開く

Codespace のビルドが完了したら、ブラウザーのリポジトリ ルートで VS Code に移動します。 キットのコマンドは、 ess-maker-skills がワークスペースのルートである場合にのみ機能します。

  1. メニューから、[ファイル]>フォルダーを開く を選択します。
  2. /workspaces/Employee-Self-Service-Agent-Developer-Kit/solutions/ess-maker-skillsと入力します。
  3. [OK] を選択します。

VS Code は、右側のフォルダーを開いた状態で再読み込みされます。

次の内容が表示されます

エクスプローラー ウィンドウの上部に ESS-MAKER-SKILLS が表示され、すぐ下にこれらのフォルダーが表示されます。

ESS-MAKER-SKILLS
  .github
  .vscode
  scripts
  src

エクスプローラー上部に完全なリポジトリ名が表示され、samples、solutions、tests などの追加のフォルダーが表示される場合は、間違ったフォルダーを開いています。 もう一度 [ファイル>フォルダーを開く] を選択し、前のセクションのパスを使用します。

キットは、モデルにツールを検出し、マルチステップの指示に従い、有効な YAML を書き込むように要求します。 すべてのモデルがこれらのアクションを等しくうまく行うわけではありません。

Copilot Chat ウィンドウ (アクティビティ バーの [Chat] アイコン) を開きます。 チャット ウィンドウの上部には、モデル ピッカーがあります。 次のいずれかのファミリから現在のフロンティア モデルを選択します。

モデル ファミリ メリット
Claude Sonnet (最新利用可能) 推奨。 信頼性の高い工具検出とマルチステップの指示に従う。
Claude Opus (最新利用可能) 推奨。 ソネットと同じ強み。高品質は高く、速度はやや遅くなります。
OpenAI Codex または GPT-5 クラス (最新利用可能) 推奨。 キットのセットアップ フローに適しています。

注

ピッカー内のモデルは、新しいバージョンが出荷されると、時間の経過と共に変更されます。 正確なバージョン番号ではなく、上記に記載されているファミリのいずれかで利用可能な最新バージョンを選択します。

ピッカーにこれらのファミリが表示されない場合は、organization によって有効になっていない可能性があります。 最も近い等価なものを選択します。 後でキットがツールが見つからないと報告された場合の最も一般的な修正方法は、推奨モデルに切り替えることです。

Codespace を管理する

github.com/codespaces から Codespace を停止、再起動、および削除できます。 作業はセッション間で保存されます。 キットが完了したら、Codespace を削除してストレージ クォータを解放します。

次の手順

「 最初のコマンドの実行」に進みます。

Codespace がビルドされなかった場合、または正しいフォルダーが開かない場合は、「は じめにトラブルシューティング」を参照してください。

  • 最終更新: