Schnellstart: Bereitstellen Ihres ersten gehosteten Agents

• Azure Developer CLI (AZD) 1.25.3 oder höher.

• Die azd microsoft.foundry Erweiterung. Installieren und überprüfen Sie die Erweiterung nach der Installation von AZD:

  azd ext install microsoft.foundry
  

• Visual Studio Code.
• Microsoft Foundry Toolkit für Visual Studio Code.

Schritt 1: Initialisieren des Beispiel-Agents

Initialisieren Sie einen neuen gehosteten Agent mithilfe des grundlegenden Agent Framework-Beispiels in einem leeren Verzeichnis:

azd ai agent init -m "https://github.com/microsoft-foundry/foundry-samples/blob/main/samples/python/hosted-agents/agent-framework/responses/01-basic/agent.manifest.yaml" --deploy-mode code

Der interaktive Ablauf fragt Folgendes ab:

• Agentname: Passen Sie den Namen an oder übernehmen Sie den Standardwert, agent-framework-agent-basic-responses
• Foundry Project: Wählen Sie ein neues Foundry-Projekt erstellen oder ein vorhandenes Foundry-Projekt verwenden
• Tenant: Wählen Sie Ihren Azure Mandanten aus.
• Abonnement: Wählen Sie Ihr Azure-Abonnement aus.
• Location: Wählen Sie einen Azure Bereich aus.
• Modell: Wählen Sie die Standard-, gpt-4.1-mini- oder ein anderes Modell aus, auf das Sie zugreifen können.
• Modellversion: Wählen Sie die Standardoption aus.
• Modell-SKU: Wählen Sie eine Option mit verfügbarem Kontingent aus, das nicht Batch ist, in der Regel "Standard" oder "GlobalStandard".
• Bereitstellungskapazität: Wählen Sie die Standardeinstellung10 aus.
• Bereitstellungsname: Wählen Sie die Standardeinstellung"gpt-4.1-mini" aus.

Nach Abschluss sollte die KI-Agent-Definition erfolgreich zu Ihrem azd-Projekt hinzugefügt werden!. Ändern Sie das Verzeichnis in einen neu erstellten Agentordner.

cd agent-framework-agent-basic-responses

Schritt 2: Bereitstellen Azure Ressourcen

Stellen Sie die in azure.yaml definierten Ressourcen bereit:

azd provision

Schritt 3: Lokal testen des Agents

azd ai agent run

Dieser Befehl erstellt eine virtuelle Umgebung, installiert Abhängigkeiten, startet den Agenten mithilfe der in startupCommand definierten azure.yaml und öffnet den Agent-Inspektor in Ihrem Browser, damit Sie mit dem Agenten chatten können.

Schritt 4: Im Foundry-Agent-Dienst bereitstellen

Erstellen und Bereitstellen des Agentcontainers:

azd deploy

Wenn der Befehl abgeschlossen ist, zeigt die Ausgabe Links zum Agent-Playground und zum Agent-Endpunkt an:

Deploying services (azd deploy)

  Done: Deploying service basic-agent
  - Agent playground (portal): https://ai.azure.com/.../build/agents/basic-agent/build?version=1
  - Agent endpoint: https://ai-account-<name>.services.ai.azure.com/api/projects/<project>/agents/basic-agent/versions/1

Schritt 5: Aufrufen Ihres Agents

1. Senden Sie dieselbe Eingabeaufforderung an den bereitgestellten Agent:

   azd ai agent invoke "Write a haiku about deploying cloud applications."
   

   Innerhalb weniger Sekunden sollte eine Haiku-Antwort angezeigt werden.

2. (Optional) Containerprotokolle streamen, während Sie mit dem Agenten interagieren:

   azd ai agent monitor --follow
   

Schritt 1: Erstellen eines Foundry-Projekts

1. Öffnen Sie die Befehlspalette (Ctrl+SHIFT+P), und wählen Sie Foundry Toolkit: Erstellen Project aus.
2. Wählen Sie Ihr Azure-Abonnement aus.
3. Erstellen Sie eine neue Ressourcengruppe, oder wählen Sie eine vorhandene aus.
4. Geben Sie einen Namen für das Foundry-Projekt ein.

Schritt 2: Bereitstellen eines Modells

1. Öffnen Sie die Befehlspalette, und wählen Sie foundry Toolkit: Open Model Catalog.
2. Suchen Sie nach gpt-4.1 und wählen Sie Deploy.
3. Wählen Sie auf der Modellbereitstellungsseite Deploy to Microsoft Foundry aus.

Schritt 3: Erstellen eines gehosteten Agent-Projekts

1. Öffnen Sie die Befehlspalette, und wählen Sie "Foundry Toolkit" aus: Neuen gehosteten Agent erstellen.
2. Wählen Sie die Python als Sprache aus.
3. Wählen Sie für "Framework" die Option "Agent Framework" aus.
4. Wählen Sie die Antwort-API als Protokolltyp aus.
5. Wählen Sie "Einfach" als Beispielcode aus.
6. Wählen Sie die Schaltfläche "Weiter" aus.
7. Wählen Sie einen Ordner für die Projektdateien aus, und geben Sie einen Namen für den Agent ein.
8. Wählen Sie für "Umgebungseinrichtung" Setup mit Microsoft Foundry aus, der Inhalt sollte automatisch mit dem Projekt und dem Modell aufgefüllt werden, das Sie in Schritt 1 und 2 erstellt haben.
9. Wählen Sie die Schaltfläche "Erstellen" aus.

Ein neues VS Code-Fenster wird geöffnet, wobei das Projekt der aktive Arbeitsbereich ist.

Schritt 4: Installieren von Abhängigkeiten

Erstellen Sie eine virtuelle Umgebung, und installieren Sie die Anforderungen.

Für macOS oder Linux:

python -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt

Für Windows (PowerShell)

python -m venv .venv
.\.venv\Scripts\Activate.ps1
pip install -r requirements.txt

Schritt 5: Lokal testen des Agents

Drücken Sie F5 , um den lokalen HTTP-Server mit aktivierter Debuggingfunktion zu starten. Der Foundry Toolkit Agent Inspector wird für interaktive Tests geöffnet, und Sie können Haltepunkte in Ihrem Code festlegen.

So führen Sie den Server ohne Debugging aus:

python main.py

Der Agent wartet auf http://localhost:8088/. Senden sie eine Testaufforderung mit curl (oder einem beliebigen HTTP-Client):

curl -sS -H "Content-Type: application/json" -X POST http://localhost:8088/responses \
    -d '{"input": "Write a haiku about deploying cloud applications.", "stream": false}'

Schritt 6: Bereitstellen im Foundry-Agentendienst

1. Öffnen Sie die Befehlspalette, und wählen Sie Foundry Toolkit: Deploy Hosted Agent. Eine Bereitstellungswebansicht wird geöffnet.
2. Wählen Sie für "Bereitstellungsmethode" die Option "Code" aus.
3. Wählen Sie "Remote" als Paketmodus aus.
4. Der „Agent Name“ sollte automatisch ausgefüllt werden.
5. Wählen Sie die Schaltfläche "Weiter" aus.
6. Diese Seite „Überprüfen und bereitstellen“ sollte automatisch vollständig ausgefüllt werden.
7. Wählen Sie die Schaltfläche "Bereitstellen" aus.

Nach Abschluss der Bereitstellung wird der Agent im Explorer des Foundry Toolkit unter "Gehostete Agents (Vorschau)" angezeigt.

Schritt 7: Aufrufen Ihres Agents

1. Erweitern Sie im Explorer des Foundry Toolkits Gehostete Agents (Vorschau) und wählen Sie Ihren Agent aus. Auf der Detailseite wird der Status unter "Bereitstellungsdetails" angezeigt.
2. Wählen Sie die Registerkarte „Playground“ aus und senden Sie einen Test-Prompt, wie z. B. Write a haiku about deploying cloud applications..

azd down

azd listet die Ressourcen auf, die gelöscht werden, und fordert zur Bestätigung auf. Die Bereinigung dauert etwa 2-5 Minuten.

1. Öffnen Sie das portal Azure und navigieren Sie zu der Ressourcengruppe, die Ihren Agent enthält.
2. Wählen Sie "Ressourcengruppe löschen", geben Sie den zu bestätigenden Ressourcengruppennamen ein, und wählen Sie "Löschen" aus.