Erste Schritte mit dem Tool für die Browserautomatisierung (Vorschau) in gehosteten Agenten

Voraussetzungen

• Ein Azure-Konto mit einem aktiven Abonnement. Wenn Sie noch kein Azure-Abonnement haben, erstellen Sie ein kostenloses Konto, bevor Sie beginnen.
• Ihr Azure Konto benötigt die Rollen "Besitzer" oder "Mitwirkender" für eine Ressourcengruppe.
• Azure Developer CLI. Wenn Sie nicht über Azure Developer CLI verfügen, lesen Sie "Installieren der Azure Developer CLI".
  • Das azd ai agent extension ist installiert (azd extension install azure.ai.agents). Wenn die Erweiterung nicht installiert ist, wird die Erweiterung automatisch installiert, wenn Sie die Startvorlage initialisieren oder die Erweiterung ausführen azd ai agent .

Schritt 1: Erstellen eines Playwright-Arbeitsbereichs

Um das Browserautomatisierungstool zu verwenden, müssen Sie zuerst einen Playwright-Arbeitsbereich erstellen. (Wenn Sie über einen vorhandenen Playwright Workspace verfügen, können Sie diesen Schritt überspringen.)

1. Melden Sie sich mit den Anmeldeinformationen für Ihr Azure-Abonnement beim Azure-Portal an.
2. Suchen Sie auf der Startseite des Portals nach Arbeitsbereiche für Dramatiker und wählen Sie sie aus.
3. Wählen Sie "Erstellen" aus, und geben Sie die folgenden Informationen ein:
   • Subscription
   • Ressourcengruppe
   • Name
   • Ort
4. Wählen Sie „Überprüfen + Erstellen“ und dann „Erstellen“ aus. Es dauert ein paar Minuten, um den Arbeitsbereich zu erstellen. Warten Sie, bis auf der Portalseite „Ihre Bereitstellung ist abgeschlossen“ angezeigt wird, bevor Sie fortfahren.

Schritt 2: Bereitstellen des gehosteten Beispiel-Agents

Um mit dem Browserautomatisierungstool in gehosteten Agents zu beginnen, wählen Sie eines der folgenden Beispiele aus:

• Microsoft Agent Framework
• Framework nach Wahl

Sie können eines dieser Frameworks verwenden, je nachdem, welches Framework Sie zum Erstellen Ihres gehosteten Agents verwenden möchten.

Schritt 2.1: Initialisieren der Gehosteten Agent-Beispielanwendung

1. Öffnen Sie ein neues Verzeichnis, und initialisieren Sie das Agent-Beispiel aus den Beispielen azure.yaml, indem Sie einen der folgenden Befehle ausführen:

   • Microsoft Agent Framework:

   azd ai agent init -m "https://github.com/microsoft-foundry/foundry-samples/blob/main/samples/python/hosted-agents/agent-framework/responses/14-browser-automation-agent/azure.yaml" --deploy-mode container
   

   • Eigenes Framework mitbringen:

   azd ai agent init -m "https://github.com/microsoft-foundry/foundry-samples/blob/main/samples/python/hosted-agents/bring-your-own/responses/browser-automation/azure.yaml" --deploy-mode container
   

2. Der interaktive Ablauf fordert zur Eingabe der folgenden Angaben auf:

   • App-Verzeichnis: Der lokale Pfad zum Initialisieren der Anwendung.
   • Agentname: Passen Sie den Namen an, oder akzeptieren Sie den Standardwert, browser-automation-agent-sample-foundry. Der Name sollte innerhalb von 1 bis 63 Zeichen stehen, mit einem Buchstaben oder einer Zahl beginnen und enden und nur Buchstaben, Zahlen und interne Bindestriche enthalten.
   • Foundry-Projekt: Wählen Sie ein vorhandenes Foundry-Projekt aus, oder erstellen Sie ein neues Projekt. Wenn Sie ein vorhandenes Foundry-Projekt verwenden, müssen Sie auf Projektebene über die Rolle Foundry Project Manager oder eine andere Rolle verfügen, die sowohl Berechtigungen für die Datenebene als auch für Rollenzuweisungen gewährt. Die vollständige Rollenmatrix finden Sie unter Referenz zu den Berechtigungen für gehostete Agents.
   • Modell: Wählen Sie die Standard- oder ein anderes Modell aus, gpt-5.4-miniauf 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, normalerweise Standard oder GlobalStandard.
   • Bereitstellungskapazität: Wählen Sie die Standardeinstellung 10 aus.
   • Bereitstellungsname: Wählen Sie die Standardeinstellung aus. gpt-5.4-mini

Nachdem die Anwendung erfolgreich initialisiert wurde, wird die folgende Meldung angezeigt:

AI agent definition added to your azd project successfully!

Schritt 2.2: Bereitstellen der Azure-Ressourcen

1. Festlegen der Umgebungsvariablen, die auf den Playwright-Arbeitsbereich verweisen

   • Playwright Workspace-Ressourcen-ID: Um die Ressourcen-ID abzurufen, öffnen Sie die Playwright Workspace-Ressource, wechseln Sie zur Seite "Übersicht", wählen Sie die JSON-Ansicht aus, und kopieren Sie die Ressourcen-ID.

   azd env set PLAYWRIGHT_SERVICE_RESOURCE_ID "/subscriptions/<subscription-id>/resourceGroups/<resource-group>/providers/Microsoft.LoadTestService/playwrightWorkspaces/<workspace-name>"
   

   • Playwright Workspace-Dienst-URL: Um die Dienst-URL abzurufen, öffnen Sie die Ressource "Playwright Workspace", und wechseln Sie zur Seite "Übersicht". Kopieren Sie den Browserendpunkt (beginnt mit wss://).

   azd env set PLAYWRIGHT_SERVICE_URL "wss://<region>.api.playwright.microsoft.com/playwrightworkspaces/<workspace-id>/browsers"
   

2. Stellen Sie die in azure.yaml definierten Ressourcen bereit:

azd provision

Dieser Schritt dauert einige Minuten und erstellt die folgenden Ressourcen. Nach der Bereitstellung wird die folgende Meldung angezeigt:

SUCCESS: Your application was provisioned in Azure in X minute YY seconds.

Schritt 2.3: Den Agent in Foundry Agent Service bereitstellen

Erstellen und Bereitstellen des Agentcontainers:

azd deploy

Wenn der Agent installiert ist, sehen Sie die folgende Meldung -

SUCCESS: Your application was deployed to Azure in X minutes YY seconds.

Schritt 3: Gewähren des Agents Zugriff auf den Playwright-Arbeitsbereich

Die verwaltete Identität des Foundry-Projekts muss die folgende Rolle im Azure Playwright-Arbeitsbereich haben:

1. Suchen Sie die Identitätsobjekt-ID des Agents im Findry-Portal. Wechseln Sie zu „Agents“, wählen Sie Ihren Agenten aus und dann „Identität“.
2. Weisen Sie die Rolle mithilfe von Azure CLI zu:

PRINCIPAL_ID="<project-managed-identity-object-id>"
PWW_RESOURCE_ID="/subscriptions/<subscription-id>/resourceGroups/<resource-group>/providers/Microsoft.LoadTestService/playwrightWorkspaces/<workspace-name>"

az role assignment create --assignee "$PRINCIPAL_ID" --role "Playwright Workspace Contributor" --scope "$PWW_RESOURCE_ID"

Schritt 4: Testen des Agenten im Foundry Playground

1. Öffnen Sie das Foundry-Portal , und melden Sie sich an.
2. Wählen Sie Ihr Projekt aus "Zuletzt verwendete Projekte" oder "Alle Projekte" aus.
3. Wählen Sie im linken Navigationsbereich Build > Agents aus.
4. Wählen Sie Ihren Agenten aus, und wählen Sie dann „In Playground öffnen“ aus.
5. Geben Sie eine Eingabeaufforderung ein, z. B. -

Go to the website finance.yahoo.com, search for MSFT and report the Microsoft stock price.

Schritt 4: Bereinigen von Ressourcen

Löschen Sie die Ressourcen, wenn Sie fertig sind, damit Keine Gebühren anfallen.

azd down

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