Introduzione allo strumento di automazione del browser (anteprima) negli agenti ospitati

Prerequisiti

• Un account Azure con una sottoscrizione attiva. Se non si ha una sottoscrizione di Azure, creare un account gratuito prima di iniziare.
• L'account Azure richiede i ruoli Proprietario o Collaboratore in un gruppo di risorse.
• interfaccia della riga di comando per sviluppatori Azure. Se non si dispone di Azure Developer CLI, vedere Installare Azure Developer CLI.
  • L'azd ai agent extension è installata (azd extension install azure.ai.agents). Se l'estensione non è installata, quando si inizializza il modello di avvio o si esegue azd ai agent l'estensione viene installata automaticamente.

Passaggio 1: Crea un'area di lavoro Playwright

Per usare lo strumento di automazione del browser, è prima necessario creare un'area di lavoro Playwright. Se si dispone di un'area di lavoro Playwright esistente, è possibile ignorare questo passaggio.

1. Accedere al portale di Azure usando le credenziali della sottoscrizione di Azure.
2. Nella home page del portale cercare e selezionare Spazi di lavoro Playwright.
3. Selezionare Crea e immettere le informazioni seguenti:
   • Subscription
   • Gruppo di risorse
   • Name
   • Posizione
4. Selezionare Review + Create e quindi Crea. La creazione dell'area di lavoro richiede alcuni minuti. Attendere che la pagina del portale mostri il messaggio "La distribuzione è completa" prima di procedere.

Passaggio 2: Distribuisci l'agente ospitato di esempio

Per iniziare a usare lo strumento di automazione del browser negli agenti ospitati, scegliere uno di questi esempi:

• Microsoft Agent Framework
• Portare il proprio framework

È possibile usare uno di questi elementi a seconda del framework che si vuole usare per compilare l'agente ospitato.

Passaggio 2.1: Inizializzare l'applicazione dell'agente ospitato di esempio

1. Aprire una nuova directory e inizializzare l'esempio dell'agente dall'esempio azure.yaml eseguendo uno di questi comandi:

   • 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
   

   • Portare il proprio framework:

   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. Il flusso interattivo richiede i dettagli seguenti:

   • Directory dell'app: percorso locale per inizializzare l'applicazione.
   • Nome agente: personalizzare il nome o accettare l'impostazione predefinita. browser-automation-agent-sample-foundry Il nome deve essere compreso tra 1 e 63 caratteri, inizio e fine con una lettera o un numero e contenere solo lettere, numeri e trattini interni.
   • Progetto Foundry: selezionare un progetto Foundry esistente o crearne uno nuovo. Se si utilizza un progetto Foundry esistente, è necessario disporre del ruolo Foundry Project Manager a livello di progetto o di un altro ruolo che conferisca autorizzazioni sia per il piano dati sia per l'assegnazione dei ruoli. Per la matrice completa dei ruoli, vedi Riferimento delle autorizzazioni dell'agente ospitato.
   • Modello: selezionare il valore predefinito, gpt-5.4-minio un altro modello a cui è possibile accedere.
   • Versione del modello: selezionare l'opzione predefinita.
   • SKU del modello: selezionare un'opzione con quota disponibile che non è Batch, in genere Standard o GlobalStandard.
   • Capacità di distribuzione: selezionare il valore predefinito 10.
   • Nome distribuzione: selezionare il valore predefinito, gpt-5.4-mini.

Dopo l'inizializzazione dell'applicazione, viene visualizzato il messaggio seguente:

AI agent definition added to your azd project successfully!

Passaggio 2.2: Effettuare il provisioning delle risorse Azure

1. Impostare le variabili di ambiente in modo che puntino all'area di lavoro Playwright

   • ID risorsa dell'area di lavoro Playwright: Per ottenere l'ID della risorsa, aprire la risorsa dell'area di lavoro Playwright, passare alla pagina Panoramica, selezionare Vista JSON e copiare l'ID risorsa.

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

   • URL del servizio Area di lavoro playwright: per ottenere l'URL del servizio, aprire la risorsa Area di lavoro Playwright e passare alla pagina Panoramica. Copia l'endpoint del Browser (che inizia con wss://).

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

2. Effettuare il provisioning delle risorse definite in azure.yaml:

azd provision

Questo passaggio richiede alcuni minuti e crea le risorse seguenti. Dopo il provisioning, viene visualizzato il messaggio seguente:

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

Passaggio 2.3: Distribuire l'agente nel Servizio agenti Foundry

Compilare e distribuire il contenitore dell'agente:

azd deploy

Quando l'agente viene distribuito, verrà visualizzato il messaggio seguente:

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

Passaggio 3: Concedere all'agente l'accesso all'area di lavoro Playwright

L'identità gestita del progetto Foundry deve avere il ruolo seguente nell'area di lavoro Azure Playwright:

1. Trova l'ID oggetto dell'identità dell'agente nel portale Foundry. Passare ad Agenti, selezionare l'agente e quindi selezionare Identità.
2. Assegnare il ruolo usando interfaccia della riga di comando di Azure:

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"

Passaggio 4: Testare l'agente in Foundry Playground

1. Apri il portale Foundry e accedi.
2. Selezionare il progetto da Progetti recenti o Tutti i progetti.
3. Nel riquadro di navigazione a sinistra, selezionare Crea agenti >.
4. Selezionare l'agente, quindi selezionare Apri nel playground.
5. Immettere un prompt, ad esempio -

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

Passaggio 4: Pulire le risorse

Elimina le risorse quando hai finito, per evitare ulteriori addebiti.

azd down

azd elenca le risorse che elimina e richiede la conferma. La pulizia richiede circa 2-5 minuti.