Installieren des Agent Developer Kit mit GitHub Codespaces

  • Gilt für:: ✅ Microsoft Copilot

GitHub Codespaces bietet Ihnen ein in der Cloud gehostetes Visual Studio Code im Browser, wobei das Kit vorinstalliert ist. Sie installieren nichts auf Ihrem eigenen Computer. Der gesamte Schritt dauert etwa 5 Minuten.

Verwenden Sie Codespaces in folgenden Fällen:

  • Software kann nicht lokal installiert werden (vom Unternehmen verwaltetes Gerät, gesperrte Umgebung).
  • Sie verwenden macOS, Linux oder einen anderen Windows-Computer.
  • Sie möchten das Kit ausprobieren, bevor Sie entscheiden, ob es lokal installiert werden soll.

Vorbereitende Schritte

Du brauchst:

  • Ein GitHub-Konto mit einem aktiven GitHub Copilot-Abonnement.
  • Ein moderner Browser.

Codespaces umfasst einen Free-Tarif von 120 Kernstunden pro Monat (60 Stunden auf dem 2-Kern-Computer, den das Kit verwendet). Der Codespace wird nach 30 Minuten Inaktivität automatisch angehalten, sodass Ihnen nur die Zeit in Rechnung gestellt wird, die Sie aktiv arbeiten.

Wenn Ihr GitHub-Konto Teil eines organization ist und Codespaces nicht verfügbar ist, muss Ihr Administrator es möglicherweise aktivieren. Weitere Informationen finden Sie unter Verwalten von Codespaces für Ihre organization.

Erstellen des Codespace

  1. Öffnen Sie diesen Link in Ihrem Browser:

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

  2. Melden Sie sich bei GitHub an, wenn Sie dazu aufgefordert werden.

  3. Übernehmen Sie auf der Seite Codespace erstellen die Standardwerte, und wählen Sie den 2-Kern-Computertyp aus.

  4. Wählen Sie Codespace erstellen aus.

GitHub erstellt den Codespace. Der erste Build dauert einige Minuten, da Python, die Abhängigkeiten des Kits und die GitHub Copilot Erweiterungen installiert werden. Nachfolgende Starts desselben Codespace sind schneller.

Öffnen des richtigen Ordners

Wenn der Codespace fertig ist, landen Sie in VS Code im Browser am Repositorystamm. Die Befehle des Kits funktionieren nur, wenn ess-maker-skills der Arbeitsbereichsstamm ist.

  1. Wählen Sie im Menü Datei>Ordner öffnen aus.
  2. /workspaces/Employee-Self-Service-Agent-Developer-Kit/solutions/ess-maker-skills eingeben.
  3. Wählen Sie OK aus.

VS Code wird mit geöffnetem rechten Ordner neu geladen.

Sie sollten sehen, dass

Der bereich Explorer wird oben mit den folgenden Ordnern direkt darunter angezeigtESS-MAKER-SKILLS:

ESS-MAKER-SKILLS
  .github
  .vscode
  scripts
  src

Wenn der Explorer oben den vollständigen Repositorynamen mit zusätzlichen Ordnern wie samples, solutionsund testsanzeigt, haben Sie den falschen Ordner geöffnet. Wählen Sie Erneut Datei>Ordner öffnen aus, und verwenden Sie den Pfad im vorherigen Abschnitt.

Das Kit fordert das Modell auf, Tools zu erkennen, anweisungen in mehreren Schritten zu befolgen und gültige YAML zu schreiben. Nicht alle Modelle führen diese Aktionen gleichermaßen gut aus.

Öffnen Sie den Bereich Copilot Chat (das Symbol Chat auf der Aktivitätsleiste). Oben im Chatbereich befindet sich eine Modellauswahl. Wählen Sie ein aktuelles Grenzmodell aus einer der folgenden Familien aus:

Modellfamilie Warum
Claude Sonnet (neueste verfügbare Version) Empfohlen. Zuverlässige Toolerkennung und mehrstufige Anleitung.
Claude Opus (neueste Verfügbarkeit) Empfohlen. Dieselben Stärken wie Sonnet; höhere Qualität, etwas langsamer.
OpenAI Codex- oder GPT-5-Klasse (neueste verfügbare Klasse) Empfohlen. Eignet sich gut für die Setupflows des Kits.

Hinweis

Die Modelle in der Auswahl ändern sich im Laufe der Zeit, wenn neue Versionen ausgeliefert werden. Wählen Sie die neueste Version aus, die in einer der zuvor aufgeführten Familien verfügbar ist, anstatt eine genaue Versionsnummer.

Wenn keine dieser Familien in der Auswahl angezeigt wird, werden sie möglicherweise nicht durch Ihre organization aktiviert. Wählen Sie die nächstgelegene Entsprechung aus. Wenn das Kit später meldet, dass es seine Tools nicht finden kann, besteht die häufigste Lösung darin, zu einem empfohlenen Modell zu wechseln.

Verwalten Ihres Codespace

Sie können Ihren Codespace aus github.com/codespaces beenden, neu starten und löschen. Ihre Arbeit wird zwischen Sitzungen gespeichert. Wenn Sie mit dem Kit fertig sind, löschen Sie den Codespace, um Ihr Speicherkontingent freizugeben.

Nächster Schritt

Fahren Sie mit Run your first command (Ersten Befehl ausführen) fort.

Wenn der Codespace nicht erstellt wurde oder den richtigen Ordner nicht öffnet, finden Sie weitere Informationen unter Problembehandlung bei den ersten Schritten.

  • Last updated on