Deploy agent to Azure

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.

Sie haben Ihren Agent erstellt und lokal getestet – jetzt ist es an der Zeit, ihn in der Cloud zum Leben zu erwecken. Dieser Schritt ist optional und kann übersprungen werden, wenn du deinen Agenten bereits in einer Cloud ausgerollt hast (es muss nicht einmal Azure sein).

Dieser Leitfaden führt Sie durch die Bereitstellung Ihres Agent-Codes in Azure und die Veröffentlichung im Microsoft Admin Center, wo er zu einem auffindbaren Objekt für Ihre Organisation wird.

Es gibt auch Ressourcen, die zeigen, wie Sie den Messaging-Endpunkt aktualisieren können, wenn Sie Ihren Agenten anstelle von Azure bereits bei anderen Cloud-Anbietern wie AWS oder GCP bereitgestellt haben:

• Verwenden Sie Agentencode, der in AWS bereitgestellt wird
• Verwenden Sie Agentencode, der in GCP bereitgestellt wird

Voraussetzungen

Bevor Sie beginnen, stellen Sie folgendes sicher:

Erforderliche Konten und Berechtigungen

• Azure-Abonnement mit Contributor-Zugriff.
• Funktionierender Agentencode mit einem gültigen und erreichbaren Messaging-Endpunkt. Bitte stellen Sie sicher, dass Sie dies lokal getestet haben und überprüfen, ob der Agentencode erstellt und ausgeführt werden kann.
• Schließen Sie den Schritt des Setup-Agenten-Blueprints ab, um einen gültigen Agenten-Blueprint zu haben.
• Stelle sicher, dass Konfigurationsdateien a365.config.jsonund a365.generated.config.json Konfigurationsdateien im Code (z. B. .env-Datei) aktuell sind.

Erforderliche Tools

• Azure CLI, die installiert und authentifiziert wurde (Installieren der Azure CLI)
• A365 CLI, die installiert wurde (Agent 365 CLI)

In Azure bereitstellen

Der Befehl a365 deploy deployt deinen Agenten auf die während der Einrichtung erstellte Azure Web App. Dadurch wird Ihr Agentencode in Azure hochgeladen, sodass er in der Cloud ausgeführt und alle agentischen Anfragen an diesen Endpunkt bearbeiten kann.

Bereitstellen des Agents

Führen Sie den Bereitstellungsbefehl aus:

a365 deploy

Hinweis

a365 deploy -h zeigt alle Optionen, diesen Befehl auszuführen, einschließlich Unterbefehle.

.NET

Der Bereitstellungsbefehl für .NET-Agents:

• Erkennt .NET-Projektdateien (*.csproj, *.fsprojoder *.vbproj)
• Stellt NuGet-Pakete mithilfe von dotnet restore wieder her
• Veröffentlicht die Anwendung mithilfe von dotnet publish mit der Versionskonfiguration
• Erstellt das Oryx-Manifest mit dem Einstiegspunkt-DLL-Befehl (z. B dotnet YourApp.dll)
• Konfiguriert die Azure-Runtime basierend auf der erkannten .NET-Version (Standard: DOTNET|8.0)
• Bereitstellung per ZIP mit Echtzeitfortschritt

Python

Der Bereitstellungsbefehl für Python-Agents:

• Erkennt die Python-Projektstruktur (Dateien pyproject.toml, requirements.txt und *.py)
• Erstellt Pakete mithilfe von uv build, wenn pyproject.toml vorhanden ist
• Konvertiert .env automatisch in Azure-App-Einstellungen
• Intelligente Starterkennung: Findet Agent 365-Einstiegspunkte.
• Konfiguriert die Azure-Runtime für PYTHON|3.11
• Bereitstellung per ZIP mit Echtzeitfortschritt

Node.js

Der Bereitstellungsbefehl für Node.js-Agents:

• Erkennt die Node.js-Projektstruktur (Datei package.json)
• Installiert Abhängigkeiten mithilfe von npm ci (ggf. Fallback zu npm install)
• Führt das Build-Skript (npm run build) aus, sofern in package.json definiert
• Kopiert Anwendungsdateien: erstellte Ausgabe- (dist/build) oder Quelldateien
• Kopiert node_modules für die Azure-Bereitstellung
• Erstellt das Oryx-Manifest mit dem Startbefehl von package.json (oder erkennt den Einstiegspunkt)
• Konfiguriert die Azure-Runtime basierend auf der erkannten Node-Version (Standard: NODE|18)
• Bereitstellung per ZIP mit Echtzeitfortschritt

Warnung

Geheimnisverwaltung: Bei der Bereitstellung werden Umgebungsvariablen (einschließlich API-Schlüsseln und Geheimnissen) als Azure-App Einstellungen gespeichert. Während Umgebungsvariablen oft für die Konfiguration verwendet werden, werden sie in Nur-Text gespeichert. Für Produktionsumgebungen empfiehlt Microsoft die Verwendung von Azure Key Vault für vertrauliche Geheimnisse. Weitere Informationen finden Sie unter Sicheres Speichern von App-Geheimnissen bei der Entwicklung in ASP.NET Core und Azure Key Vault-Konfigurationsanbieter. Übergeben Sie niemals .env-Dateien mit vertraulichen Informationen an die Quellcodeverwaltung.

Überprüfen der Bereitstellung

Nach Abschluss der Bereitstellung:

1. Navigieren Sie zu Ihrer Web-App im Azure Portal.
2. Gehen Sie zu Einstellungen>Konfiguration, um die App-Einstellungen zu überprüfen.
3. Überprüfen Sie die Bereitstellungsprotokolle im Deployment Center.

Nächste Schritte

Veröffentlichen Sie als Nächstes Ihre Agent-Anwendung im Microsoft Admin Center, damit Agent-Instanzen und Benutzer daraus erstellt werden können: Agent im Microsoft Admin Center veröffentlichen

Dein Agent ist jetzt live in der Cloud und bereit, auf agentische Anfragen zu reagieren. Während dein Agent reale Anfragen bearbeitet, solltest du folgende Schritte deines Codes bedenken:

• Leistung überwachen: Verwenden Sie Observability-Funktionen zum Nachverfolgen des Agent-Verhaltens und Optimieren von Antworten.
• Weitere Tools hinzufügen: Erkunden Sie den Toolkatalog, um die Funktionen Ihres Agents zu erweitern.
• Iterieren und verbessern: Aktualisieren Sie Ihren Agent-Code, stellen Sie ihn erneut bereit und veröffentlichen Sie ihn wieder (denken Sie daran, die Versionsnummer zu erhöhen!).
• Organisationsweit skalieren: Teilen Sie die Erfolgsgeschichten Ihres Agents, um die Einführung zu beschleunigen.