KI-gesteuerte Einrichtung für Agent 365

Der Lebenszyklus von Agent 365 Development umfasst mehrere Schritte: Installieren der CLI, Konfigurieren von Voraussetzungen, Erstellen eines Agent-Blueprints, Bereitstellen von Code und Veröffentlichen im Microsoft 365 Admin Center. Jeder Schritt hat seine eigenen Voraussetzungen, Validierungsprüfungen und Entscheidungspunkte.

Das AI-geführte Setup automatisiert diesen gesamten Workflow mithilfe eines AI-Codierungs-Agents (z. B. GitHub Copilot in VS Code), um die Lebenszyklusschritte in Ihrem Auftrag auszuführen. Anstatt zwischen mehreren Dokumentationsseiten zu navigieren und Befehle manuell auszuführen, stellen Sie dem KI-Agenten eine einzige Anweisungsdatei zur Verfügung, die Sie interaktiv durch den Prozess führt.

Vorteile

Das KI-gesteuerte Setup bietet mehrere Vorteile gegenüber dem manuellen Arbeitsablauf:

• Ein einziger Einstiegspunkt – Eine Anweisungsdatei ersetzt das Navigieren zwischen mehreren Dokumentationsseiten. Der KI-Agent folgt den Schritten in der Reihenfolge und übernimmt Übergänge automatisch.
• Automatierte Überprüfung der erforderlichen Komponenten – Der KI-Agent überprüft, ob die Azure CLI installiert und authentifiziert wird, dass die Registrierung Ihrer benutzerdefinierten Client-App über die richtigen Berechtigungen mit Administratorzustimmung verfügt und dass sprachspezifische Buildtools verfügbar sind – alles bevor a365 CLI-Befehle ausgeführt werden.
• Smart Defaults und automatische Erkennung — Der KI-Agent fragt Ihr Azure-Abonnement nach bestehenden Ressourcengruppen, App Service-Plänen und Benutzerinformationen ab und verwendet diese Werte dann als Vorschläge bei der Sammlung von Konfigurationseingaben.
• Abgeleitete Benennungskonventionen – Sie stellen einen einzelnen Basisnamen für Ihren Agent bereit, und der KI-Agent leitet alle zugehörigen Ressourcennamen (Identität, Blueprint, Benutzerprinzipalname, Web-App) mithilfe konsistenter Muster ab.
• Inline-Fehlerbehandlung – Wenn ein Befehl fehlschlägt, analysiert der KI-Agent den Fehler, schlägt eine Lösung vor und versucht es erneut – anstatt Sie durch die Fehlerbehebungsdokumentation suchen zu müssen.
• Nicht-interaktive Konfiguration – Der KI-Agent erstellt die a365.config.json Datei direkt und importiert sie, wodurch Probleme mit interaktiven CLI-Assistenten in automatisierten Umgebungen vermieden werden.

Voraussetzungen

Stellen Sie sicher, dass die folgenden Voraussetzungen erfüllt sind, bevor Sie beginnen:

Erforderliche Tools

• Visual Studio Code mit installierten Erweiterungen GitHub Copilot und GitHub Copilot Chat installiert. Das KI-gesteuerte Setup erfordert einen KI-Codierer mit Terminalzugriff.
• .NET 8.0 oder höher – Erforderlich für die Agent 365 CLI. Installieren Sie .NET.
• Azure CLI – Erforderlich für die Authentifizierung und Ressourcenverwaltung. Installieren Sie Azure CLI.

Erforderliche Konten und Berechtigungen

• Azure-Abonnement mit Mitwirkenderzugriff
• Microsoft Entra Mandant mit einer der folgenden Rollen:
  • Globaler Administrator
  • Agent-ID-Administrator
  • Agent-ID-Entwickler
• Registrierung einer benutzerdefinierten Client-App – Die KI-gesteuerte Einrichtung validiert diese App-Registrierung, aber die App muss bereits in Ihrem Tenant mit den erforderlichen Berechtigungen und der Admin-Zustimmung vorhanden sein. Informationen zum Erstellen finden Sie unter "Benutzerdefinierte Client-App-Registrierung".

Erforderlicher Agentencode

• Ein Arbeits-Agent-Projekt (Python, Node.jsoder .NET), das Sie bereitstellen möchten. Wenn du keine hast, fang mit einer der Quickstart-Proben an.

Hol dir die Datei für die Einrichtungsanweisungen

Das KI-gesteuerte Setup verwendet eine Befehlsdatei namens a365-setup-instructions.md. Das Agent365-devTools-Repository enthält diese Datei.

Wenn du das Repository geklont hast, befindet sich die Datei bei:

Agent365-devTools/docs/agent365-guided-setup/a365-setup-instructions.md

Wenn Sie das Repository nicht geklont haben, laden Sie die Datei direkt von GitHub herunter.

Führe das KI-gesteuerte Setup aus

Befolgen Sie diese Schritte, um die KI-gesteuerte Einrichtung in Ihrem Agentenprojekt zu starten.

Schritt 1: Öffnen Sie Ihr Agentenprojekt in VS Code

Öffnen Sie Ihr Agent-Projektverzeichnis in Visual Studio Code. Dieses Verzeichnis enthält deinen Agentencode (zum Beispiel das Verzeichnis mit deiner package.json, *.csproj, oder pyproject.toml Datei).

Schritt 2: Öffnen GitHub Copilot Chat im Agentmodus

Öffnen Sie den GitHub Copilot Chatbereich, und wechseln Sie zum Modus Agent. Der Agentmodus bietet GitHub Copilot die Möglichkeit, Terminalbefehle auszuführen, Dateien zu lesen und mit Ihrem Projekt zu interagieren – alle Funktionen, die vom KI-geführten Setup benötigt werden.

Schritt 3: Hänge die Anleitungsdatei an und starte

Fügen Sie in der Copilot Chateingabe die Datei a365-setup-instructions.md an, und senden Sie sie mit einer kurzen Eingabeaufforderung. Beispiel:

Follow the steps in #file:a365-setup-instructions.md

Der KI-Agent liest die Anweisungsdatei und startet das geführte Setup. Sie erstellt eine Aufgabenliste mit fünf Schritten und führt sie einzeln durch:

1. Verifiziere und installiere die Agent 365 CLI – Prüft die CLI, installiert oder aktualisiert sie und überprüft, ob sie funktioniert.
2. Validate prerequisites – Validiert die Azure CLI-Authentifizierung, überprüft die Registrierung und die Berechtigungen Ihrer benutzerdefinierten Client-App und stellt sicher, dass die Build-Tools für Ihren Projekttyp installiert sind.
3. Configure the Agent 365 CLI – Fragt, ob Sie Azure gehostete oder selbst gehostete Bereitstellung möchten, Konfigurationswerte sammelt, Ressourcennamen ableiten und die Datei a365.config.json erstellt.
4. Provision-Ressourcen – Führt a365 setup all aus, um die Azure-Infrastruktur und den Agent-Blueprint zu erstellen.
5. Publish and deploy – Überprüft das Manifest, veröffentlicht den Agent im Microsoft 365 Admin Center, stellt den Code für Azure bereit und stellt Anweisungen nach der Bereitstellung bereit.

Schritt 4: Reagieren Sie auf Aufforderungen

Der KI-Agent hält an bestimmten Stellen inne, um Eingaben von dir zu sammeln:

• Benutzerdefinierte Client-App-ID – Ihre Anwendungs-(Client-)ID für die Registrierung der benutzerdefinierten Client-App.
• Deployment-Typ – Ob sie eine Azure Web App (Azure gehostet) erstellen oder einen vorhandenen Endpunkt (selbst gehostet) verwenden möchten.
• Configuration-Werte – Ressourcengruppe, Standort, Agentname, Manager-E-Mail und App Service-Plan (für Azure gehostet) oder Agentname und Manager-E-Mail (für selbst gehostet).
• Abgeleitete Wertbestätigung – Überprüfen Sie automatisch generierte Namen für die Agentidentität, den Bauplan und den Benutzerprinzipal.
• Manifest-Überprüfung — Bestätigen Sie, dass Ihr manifest.json mit dem Namen des Agenten, einer Beschreibung und den Informationen zum Entwickler aktualisiert ist.

Schritt 5: Erledigen Sie Aufgaben nach dem Einsatz

Nachdem die CLI-Befehle abgeschlossen sind, gibt der KI-Agent Anweisungen für manuelle Schritte, die eine Browserinteraktion erfordern:

1. Konfigurieren Sie den Agenten im Teams Developer Portal – Setzen Sie den Agententyp und die Bot-ID ein.
2. Erstellen Sie eine Agenteninstanz – Fordern Sie eine Instanz aus Teams an und lassen Sie sie von einem Administrator genehmigen.
3. Testen Sie den Agenten – Senden Sie Nachrichten an Ihren Agenten in Teams, um zu überprüfen, ob alles funktioniert.

Für detaillierte Anweisungen zu diesen Schritten nach der Bereitstellung siehe Agenteninstanzen erstellen.

Was das KI-gesteuerte Setup abdeckt

Das KI-gesteuerte Setup automatisiert die folgenden Entwicklungsphasen:

Problembehandlung

Der KI-Agent führt keine Terminalbefehle aus

Wenn der KI-Agent Befehle beschreibt, diese aber nicht ausführt, stellen Sie sicher, dass Sie AgentModus im GitHub Copilot Chat verwenden. Die Modi "fragen" und "Bearbeiten" haben keinen Terminalzugriff.

KI-Agent überspringt Validierungsschritte

Die Befehlsdatei erzwingt eine strikte Schrittreihenfolge. Wenn der KI-Agent einen Schritt überspringt, erinnern Sie ihn daran, die Anweisungen von Anfang an zu befolgen. Beispiel:

Please start from Step 1 in the setup instructions and work through each step in order.

CLI-Befehle scheitern mit Berechtigungsfehlern

Wenn a365 CLI-Befehle durch Autorisierungsfehler ausfallen, ist die häufigste Ursache eine fehlende oder unvollständige Registrierung der benutzerdefinierten Client-App. Der KI-Agent validiert diese Registrierung in Schritt 2, aber falls du diese Validierung übersprungen hast, geh zurück und führe sie durch. Die vollständige Einrichtungsanleitung finden Sie unter Registrierung der benutzerdefinierten Client-App.

Konfigurationswerte sind falsch

Wenn Sie nach der Erstellung der a365.config.json Datei die Konfigurationswerte ändern müssen, können Sie entweder:

• Bearbeiten Sie die a365.config.json-Datei direkt und führen Sie a365 config init -c ./a365.config.json erneut aus.
• Bitten Sie den KI-Agenten, bestimmte Werte zu aktualisieren

Nächste Schritte