Introdução à ferramenta de automatização do browser (pré-visualização) em agentes hospedados

Pré-requisitos

• Uma conta do Azure com uma assinatura ativa. Se não tiver uma subscrição do Azure, crie uma conta gratuita antes de começar.
• A sua conta Azure precisa dos papéis de Proprietário ou Contribuinte num grupo de recursos.
• Azure Developer CLI. Se não tiver a CLI do Azure Developer, veja Instalar a CLI do Azure Developer.
  • O azd ai agent extension instalado (azd extension install azure.ai.agents). Se não tiver a extensão instalada, quando inicializa o template inicial ou executa azd ai agent , a extensão é instalada automaticamente.

Passo 1: Criar um Espaço de Trabalho para Dramaturgos

Para usar a ferramenta de automação do navegador, primeiro precisa de criar um espaço de trabalho Playwright. (Se já tiver um Espaço de Trabalho de Dramaturgo, pode saltar este passo.)

1. Entre no portal do Azure usando as credenciais para sua assinatura do Azure.
2. Na página inicial do portal, pesquise e selecione Espaços de trabalho para dramaturgos.
3. Selecione Criar e introduza as seguintes informações:
   • Subscription
   • Grupo de recursos
   • Nome
   • Location
4. Selecione Rever + Criar e depois selecione Criar. Demora alguns minutos a criar o espaço de trabalho. Aguarde que a página do portal apareça A sua implementação está concluída antes de avançar.

Passo 2: Implementar o agente hostado de exemplo

Para começar a usar a ferramenta de automação do navegador em agentes alojados, escolha um destes exemplos:

• Estrutura do Microsoft Agent
• Framework Traga o Seu Próprio

Podes usar qualquer um destes dependendo do framework que pretendes usar para construir o teu agente alojado.

Passo 2.1: Inicializar a aplicação de agente alojada de exemplo

1. Abra um novo diretório e inicialize a amostra do agente a partir da amostra azure.yaml , executando um destes comandos:

   • 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
   

   • Use o seu próprio 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. O fluxo interativo solicita os seguintes detalhes:

   • Diretório da aplicação: O caminho local para inicializar a aplicação.
   • Nome do agente: Personalize o nome ou aceite o padrão, browser-automation-agent-sample-foundry. O nome deve ter entre 1 e 63 caracteres, começar e terminar com uma letra ou número, e conter apenas letras, números e hífens internos.
   • Projeto Foundry: Selecione um projeto Foundry existente ou crie um novo. Se utilizar um projeto Foundry existente, deve ter a função Foundry Project Manager ao nível do projeto ou outra função que conceda permissões tanto de plano de dados como de atribuição de funções. Para a matriz completa de funções, veja Referência de permissões de agente hospedado.
   • Modelo: Selecione o modelo padrão, gpt-5.4-mini, ou outro modelo a que possa aceder.
   • Versão do modelo: Selecione a opção predefinida.
   • SKU do Modelo: Selecione uma opção com quota disponível que não seja Batch, normalmente Standard ou GlobalStandard.
   • Capacidade de implantação: Selecione o padrão, 10.
   • Nome da implementação: Selecione o padrão, gpt-5.4-mini.

Depois de a aplicação ser inicializada com sucesso, vê a seguinte mensagem:

AI agent definition added to your azd project successfully!

Passo 2.2: Provisionar os recursos do Azure

1. Defina as variáveis de ambiente para apontarem para o seu Espaço de Trabalho de Dramaturgo

   • ID do recurso Playwright Workspace: Para obter o ID do recurso, abra o recurso Playwright Workspace, vá à página de Visão Geral, selecione Visualização JSON e copie o ID do Recurso.

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

   • URL do serviço Playwright Workspace: Para obter o URL do serviço, abra o recurso Playwright Workspace e vá à página de Visão Geral. Copie o endpoint do navegador (começa com wss://).

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

2. Providencie os recursos definidos em azure.yaml:

azd provision

Este passo demora alguns minutos e cria os seguintes recursos. Após o provisionamento, vê a seguinte mensagem:

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

Passo 2.3: Enviar o agente para o Serviço de Agentes da Fundição

Construa e implemente o contentor do agente:

azd deploy

Quando o agente for destacado, verá a seguinte mensagem -

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

Passo 3: Conceda ao agente acesso ao Playwright Workspace

A identidade gerida do projeto Foundry deve ter o seguinte papel no espaço de trabalho do Azure Playwright:

1. Encontre o ID do objeto de identidade do agente no portal da Foundry. Vai a Agentes, seleciona o teu agente e depois seleciona Identidade.
2. Atribua o papel usando o CLI do 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"

Passo 4: Teste o agente no Foundry Playground

1. Abra o portal da Foundry e inicie sessão.
2. Selecione o seu projeto entre Projetos Recentes ou Todos os projetos.
3. Na navegação à esquerda, selecione Agentes de Construção > .
4. Selecione o seu agente e depois selecione Abrir no playground.
5. Introduza um prompt como -

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

Etapa 4: Limpar recursos

Elimine os recursos quando tiver terminado para deixar de incorrer em custos.

azd down

O AZD lista os recursos que apaga e solicita confirmação. A limpeza demora cerca de 2 a 5 minutos.