Installieren des Agent Developer Kit mit dem One-Shot-Installationsprogramm

  • Gilt für:: ✅ Microsoft Copilot

Das One-Shot-Installationsprogramm ist die schnellste Möglichkeit, das Kit auf einem Windows-Computer auszuführen. Ein Befehl installiert Visual Studio Code, Python, Git, PowerShell 7 und die GitHub CLI, klont das Kit, installiert die GitHub Copilot Chat-Erweiterung und öffnet den richtigen Ordner in VS Code. Der gesamte Schritt dauert etwa 10 Minuten, der großteil davon für Downloads.

Hinweis

Das One-Shot-Installationsprogramm ist nur Windows. Wenn Sie macOS oder Linux verwenden oder Software nicht lokal installieren können, verwenden Sie stattdessen GitHub Codespaces.

Vorbereitende Schritte

Du brauchst:

  • Ein Windows 10 oder Windows 11 Computer, auf dem Sie Software installieren können.
  • Ein GitHub-Konto mit einem aktiven GitHub Copilot-Abonnement. Wenn Sie nicht sicher sind, kann Ihr Administrator dies in den GitHub-organization Einstellungen bestätigen.
  • Berechtigung zum Ausführen von PowerShell mit Internetzugriff.

Ausführen des Installationsprogramms

  1. Öffnen Sie PowerShell (Windows-Taste, geben Sie einpowershell, wählen Sie Windows PowerShell aus).

  2. Fügen Sie diesen Befehl ein, und drücken Sie die EINGABETASTE:

    iex (irm https://raw.githubusercontent.com/microsoft/Employee-Self-Service-Agent-Developer-Kit/main/setup/bootstrap.ps1)

Das Installationsprogramm druckt, was es tun soll, und führt dann die Schritte aus. Möglicherweise werden Windows-Aufforderungen angezeigt, in denen Sie aufgefordert werden, Softwareinstallationen zu bestätigen. Genehmigen Sie jeden Einzelnen.

Funktionsweise des Installationsprogramms

Während der Ausführung führt das Installationsprogramm Folgendes aus:

  • Installiert Visual Studio Code, Python 3.12, Git, GitHub CLI und PowerShell 7 mit winget. Bereits installierte Tools werden übersprungen.
  • Installiert die Python-Pakete, die das Kit benötigt.
  • Klont das Repository Employee Self-Service Agent Developer Kit in Ihren Benutzerordner.
  • Installiert die Erweiterungen GitHub Copilot, GitHub Copilot Chat und Python in VS Code.
  • Öffnet VS Code im solutions/ess-maker-skills Ordner.

Das Installationsprogramm ist idempotent. Wenn etwas ihn unterbricht, führen Sie denselben Befehl erneut aus. Er nimmt dort auf, wo er aufgehört hat, und überspringt bereits erledigte Arbeiten.

Anmelden bei GitHub Copilot

Wenn VS Code geöffnet wird, wird in der unteren rechten Ecke eine Anmeldeaufforderung für GitHub Copilot angezeigt.

  1. Wählen Sie Bei GitHub anmelden aus.
  2. Ihr Browser wird mit GitHub geöffnet.
  3. Autorisieren Sie VS Code für die Verwendung Ihres GitHub-Kontos.
  4. Der Browser gibt Sie zu VS Code zurück. Das Kontosymbol unten links zeigt nun Ihren GitHub-Benutzernamen an.

Wenn VS Code meldet, dass Ihr Konto keinen Copilot-Zugriff hat, bestätigen Sie Ihr Abonnement unter github.com/settings/copilot.

Sie sollten sehen, dass

Wenn das Installationsprogramm abgeschlossen ist:

  • VS Code ist mit am oberen Rand des bereichs Explorer geöffnetESS-MAKER-SKILLS.
  • Die Explorer zeigt .github, .vscode, scriptsund src als oberste Ordner an.
  • Der bereich Copilot Chat ist über die Aktivitätsleiste auf der linken Seite verfügbar.

Wenn die Explorer oben mit zusätzlichen Ordnern (samples, , tests) angezeigt wirdEMPLOYEE-SELF-SERVICE-AGENT-DEVELOPER-KIT, solutionshat das Installationsprogramm den falschen Ordner geöffnet. Schließen Sie den Arbeitsbereich, und öffnen Sie erneut solutions/ess-maker-skills.

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.

Nächster Schritt

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

Wenn das Installationsprogramm nicht abgeschlossen wurde, finden Sie weitere Informationen unter Problembehandlung bei den ersten Schritten.

  • Last updated on