Introdução à ferramenta de automação do navegador (versão prévia) em agentes hospedados

Pré-requisitos

• Uma conta do Azure com uma assinatura ativa. Se você não tiver uma assinatura do Azure, crie uma conta gratuita antes de começar.
• Sua conta de Azure precisa das funções Proprietário ou Colaborador em um grupo de recursos.
• CLI do Azure para Desenvolvedores. Se você não tiver Azure CLI do Desenvolvedor, consulte Instalar a CLI do Desenvolvedor do Azure.
  • O azd ai agent extension instalado (azd extension install azure.ai.agents). Se você não tiver a extensão instalada, ao inicializar o modelo inicial ou executar azd ai agent, a extensão será instalada automaticamente.

Etapa 1: Criar um workspace do dramaturgo

Para usar a ferramenta de automação do navegador, primeiro, você precisa criar um espaço de trabalho do Playwright. (Se você tiver um Workspace de Dramaturgo existente, ignore esta etapa.)

1. Entre no portal do Microsoft Azure usando as credenciais de assinatura do Azure.
2. Na home page do portal, pesquise e selecione Workspaces do dramaturgo.
3. Selecione Criar e insira as seguintes informações:
   • Subscription
   • Grupo de recursos
   • Nome
   • Localidade
4. Selecione Examinar + Criar e, em seguida, selecione Criar. Leva alguns minutos para criar o espaço de trabalho. Aguarde até que a página do portal exiba a mensagem "Sua implantação está concluída" antes de continuar.

Etapa 2: Implantar o agente hospedado de exemplo

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

• Estrutura do Microsoft Agent
• Traga sua própria estrutura

Você pode usar qualquer uma delas dependendo de qual estrutura você deseja usar para criar seu agente hospedado.

Etapa 2.1: inicializar o aplicativo de agente hospedado de exemplo

1. Abra um novo diretório e inicialize o exemplo do agente do exemplo 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
   

   • Traga 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 do aplicativo: o caminho local para inicializar o aplicativo.
   • Nome do agente: personalize o nome ou aceite o padrão. browser-automation-agent-sample-foundry O nome deve estar dentro de 1 a 63 caracteres, iniciar e terminar com uma letra ou número e conter apenas letras, números e hifens internos.
   • Projeto do Foundry: Selecione um projeto existente do Foundry ou crie um novo projeto. Se você usar um projeto existente do Foundry, deverá ter a função Foundry Project Manager no escopo do projeto ou outra função que conceda permissões de plano de dados e de atribuição de função. Para obter a matriz de função completa, consulte a referência de permissões do agente hospedado.
   • Modelo: selecione o padrão gpt-5.4-miniou outro modelo que você possa acessar.
   • Versão do modelo: selecione a opção padrão.
   • SKU do modelo: selecione uma opção com cota disponível que não seja o Lote, geralmente Standard ou GlobalStandard.
   • Capacidade de implantação: selecione o padrão, 10.
   • Nome da implantação: selecione o padrão. gpt-5.4-mini

Depois que o aplicativo for inicializado com êxito, você verá a seguinte mensagem:

AI agent definition added to your azd project successfully!

Etapa 2.2: Provisionar os recursos de Azure

1. Defina as variáveis de ambiente para apontar para o espaço de trabalho do Playwright

   • ID do recurso do Workspace do Playwright: Para obter o ID do recurso, abra o recurso do Workspace do Playwright, vá para a página Visão Geral, selecione Modo de exibiçã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 do Playwright Workspace: Para obter a URL do serviço, abra o recurso Playwright Workspace e vá para a página de Visão geral. Copie o ponto de extremidade do Navegador (ele começa com wss://).

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

2. Provisione os recursos definidos em azure.yaml:

azd provision

Essa etapa leva alguns minutos e cria os recursos a seguir. Após o provisionamento, você verá a seguinte mensagem:

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

Etapa 2.3: Implantar o agente no Foundry Agent Service

Compile e implante o contêiner do agente:

azd deploy

Quando o agente for implantado, você verá a seguinte mensagem -

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

Etapa 3: Conceder ao agente acesso ao Workspace do Dramaturgo

A identidade gerenciada do projeto Foundry deve ter a seguinte função no espaço de trabalho do Azure Playwright:

1. Encontre o ID do objeto de identidade do agente no portal do Foundry. Vá para Agentes, selecione seu agente e selecione Identidade.
2. Atribua a função usando 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"

Etapa 4: Testar o agente no Foundry Playground

1. Abra o portal do Foundry e entre.
2. Selecione seu projeto em projetos recentes ou todos os projetos.
3. Na navegação à esquerda, selecione Build > Agents.
4. Selecione o agente e Abrir no playground.
5. Insira um prompt como :

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

Etapa 4: Limpar recursos

Exclua os recursos quando terminar de usá-los para deixar de gerar cobranças.

azd down

o azd lista os recursos excluídos e solicita confirmação. A limpeza leva cerca de 2 a 5 minutos.