Freigeben über

KI-gesteuerte Einrichtung für Agent 365

Von Bedeutung

Sie müssen Teil des Frontier-Vorschauversionsprogramms sein, um Vorabzugriff auf Microsoft Agent 365 zu erhalten. Frontier verbindet Sie direkt mit den neuesten KI-Innovationen von Microsoft. Frontier-Vorschauversionen unterliegen den bestehenden Vorschauversionsbedingungen Ihrer Kundenvereinbarungen. Da sich diese Funktionen noch in der Entwicklung befinden, können sich ihre Verfügbarkeit und Merkmale im Laufe der Zeit ändern.

Der Entwicklungszyklus von Agent 365 umfasst mehrere Schritte: Installation der CLI, Konfiguration von Voraussetzungen, Erstellung eines Agenten-Blueprints, Bereitstellung von Code und Veröffentlichung im Microsoft 365 Admin Center. Jeder Schritt hat seine eigenen Voraussetzungen, Validierungsprüfungen und Entscheidungspunkte.

Das KI-gesteuerte Setup automatisiert diesen gesamten Workflow, indem ein KI-Codierungsagent (wie GitHub Copilot in VS Code) die Lebenszyklusschritte in Ihrem Namen ausführt. 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.
  • Automatisierte Voraussetzungsvalidierung – Der KI-Agent prüft, dass die Azure-CLI installiert und authentifiziert ist, dass die Registrierung Ihrer benutzerdefinierten Client-App mit Zustimmung des Administrators die richtigen Berechtigungen hat und dass sprachspezifische Build-Tools verfügbar sind – und das alles, bevor irgendwelche a365 CLI-Befehle ausgeführt werden.
  • Intelligente Standardwerte und Autoerkennung – Der KI-Agent fragt Ihr Azure-Abonnement nach bestehenden Ressourcengruppen, App-Service-Plänen und Benutzerinformationen ab und verwendet diese Werte als Vorschläge beim Sammeln von Konfigurationseingaben.
  • Abgeleitete Namenskonventionen — Sie geben Ihrem Agenten einen einzigen Grundnamen vor, und der KI-Agent leitet alle zugehörigen Ressourcennamen (Identität, Bauplan, Benutzerprinzip, Web-App) mit konsistenten Mustern 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

Erforderliche Konten und Berechtigungen

Erforderlicher Agentencode

  • Ein funktionierendes Agentenprojekt (Python, Node.jsoder .NET), das du bereitstellen möchtest. 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 du das Repository nicht geklont hast, lade 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

Öffne dein Agentenprojektverzeichnis 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: GitHub Copilot Chat im Agentenmodus öffnen

Öffnen Sie das GitHub Copilot Chat-Panel und schalten Sie in den Agentenmodus . Der Agent-Modus gibt GitHub Copilot die Möglichkeit, Terminalbefehle auszuführen, Dateien zu lesen und mit Ihrem Projekt zu interagieren – alles Fähigkeiten, die durch das KI-gesteuerte Setup erforderlich sind.

Von Bedeutung

Du musst den Agentenmodus nutzen (nicht den Ask- oder Bearbeiten-Modus). Das KI-gesteuerte Setup erfordert die Fähigkeit, Terminalbefehle auszuführen und mit der Umgebung zu interagieren.

Schritt 3: Hänge die Anleitungsdatei an und starte

Im Copilot-Chat-Input fügen Sie die a365-setup-instructions.md Datei an und senden Sie sie mit einer kurzen Aufforderung. Beispiel:

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

Der KI-Agent liest die Befehlsdatei und beginnt mit der geführten Einrichtung. Es erstellt eine Aufgabenliste mit fünf Schritten und arbeitet diese nacheinander durch:

  1. Verifiziere und installiere die Agent 365 CLI – Prüft die CLI, installiert oder aktualisiert sie und überprüft, ob sie funktioniert.
  2. Voraussetzungen validieren – Bestätigt die Azure-CLI-Authentifizierung, validiert die Registrierung und Berechtigungen Ihrer benutzerdefinierten Client-App und prüft, ob Build-Tools für Ihren Projekttyp installiert sind.
  3. Konfigurieren Sie die Agent 365 CLI – fragt, ob Sie eine Azure-gehostete oder selbstgehostete Bereitstellung wünschen, sammelt Konfigurationswerte, leitet Ressourcennamen ab und erstellt die a365.config.json Datei.
  4. Ressourcen bereitstellen – Wird ausgeführt a365 setup all , um Azure-Infrastruktur und den Agenten-Blueprint zu erstellen.
  5. Veröffentlichen und deployen – Überprüft das Manifest, veröffentlicht den Agenten im Microsoft 365 Admin Center, bereitet den Code in Azure und gibt 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.
  • Bereitstellungstyp — Ob eine Azure Web App (Azure-gehostet) erstellt oder ein bestehendes Endpunkt (selbstgehostet) verwendet werden soll.
  • Konfigurationswerte — Ressourcengruppe, Standort, Agentname, Manager-E-Mail und App-Service-Plan (für Azure-gehostet) oder Agentenname und Manager-E-Mail (für selbstgehostet).
  • Abgeleitete Wertbestätigung — Überprüfen Sie automatisch generierte Namen für die Agentenidentität, den Blueprint und das Benutzerprinzip.
  • Manifest-Überprüfung — Bestätigen Sie, dass Ihr manifest.json Makler mit Namen, Beschreibung und Entwicklerinformationen aktualisiert ist.

Tipp

Der KI-Agent zeigt echte Werte aus deinem Azure-Abonnement als Beispiele an, wenn er nach Konfigurationseingaben fragt. Du kannst die Vorschläge annehmen oder deine eigenen Werte angeben.

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:

Lebenszyklusphase Was der KI-Agent tut Manuelles Äquivalent
CLI-Installation Installiert oder aktualisiert die Agent 365 CLI Agent 365 CLI
Voraussetzungen Validiert die Azure-CLI, benutzerdefinierte Client-App, Berechtigungen und Build-Tools Registrierung von benutzerdefinierten Client-Apps
Konfiguration Erstellt mit validierten Werten a365.config.json Setup Agent 365 Konfiguration
Bauplan-Aufbau Läuft a365 setup all zur Erstellung von Infrastruktur und Blaupause. Setup-Agent-Blueprint
Einsatz Läuft a365 deploy , um Code zu erstellen und bereitzustellen. Deploy agent to Azure
Publishing Läuft a365 publish zur Registrierung des Agenten im Verwaltungszentrum Agent veröffentlichen im Microsoft Admin Center

Hinweis

Das KI-gesteuerte Setup ersetzt nicht die Notwendigkeit, zuerst deinen Agentencode zu erstellen . Du solltest ein funktionierendes Agentenprojekt haben, bevor du mit dem geführten Setup startest. Für neue Projekte beginnen Sie mit einem Quickstart.

Problembehandlung

Der KI-Agent führt keine Terminalbefehle aus

Wenn der KI-Agent Befehle beschreibt, sie aber nicht ausführt, stelle sicher, dass du den Agent-Modus im GitHub Copilot Chat benutzt. 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 Datei direkt und führen Sie sie a365.config.json erneut aus a365 config init -c ./a365.config.json
  • Bitten Sie den KI-Agenten, bestimmte Werte zu aktualisieren

Nächste Schritte

Erfahren Sie mehr über den Entwicklungszyklus von Agent 365

Agent-Instanzen erstellen

  • Last updated on