Introducción a la herramienta de automatización del explorador (versión preliminar) en agentes hospedados

Prerequisites

• Una cuenta de Azure con una suscripción activa. Si no tiene una suscripción a Azure, cree una cuenta gratuita antes de empezar.
• La cuenta de Azure necesita los roles Propietario o Colaborador en un grupo de recursos.
• Azure CLI para desarrolladores. Si no tiene Azure CLI para desarrolladores, consulte Instalación de la CLI para desarrolladores de Azure.
  • El azd ai agent extension instalado (azd extension install azure.ai.agents). Si no tiene instalada la extensión, al inicializar la plantilla de inicio o ejecutar azd ai agent la extensión se instala automáticamente.

Paso 1: Crear un área de trabajo de Playwright

Para usar la herramienta de automatización del explorador, primero debe crear un área de trabajo de Playwright. (Si tiene un área de trabajo de Playwright existente, puede omitir este paso).

1. Inicie sesión en Azure Portal con las credenciales de la suscripción de Azure.
2. En la página Inicio del portal, busque y seleccione Espacios de trabajo de dramaturgo.
3. Seleccione Crear y escriba la siguiente información:
   • Subscription
   • Grupo de recursos
   • Nombre
   • Ubicación
4. Seleccione Revisar y crear y, a continuación, seleccione Crear. Se tarda unos minutos en crear el área de trabajo. Espere a que la página del portal muestre La implementación se ha completado antes de continuar.

Paso 2: Implementación del agente hospedado de ejemplo

Para empezar a trabajar con la herramienta de automatización del explorador en agentes hospedados, elija uno de estos ejemplos:

• Marco de trabajo de agentes de Microsoft
• Traiga su propio marco

Puede usar cualquiera de estos en función del marco que quiera usar para compilar el agente hospedado.

Paso 2.1: Inicialización de la aplicación del agente hospedado de ejemplo

1. Abra un nuevo directorio e inicialice el ejemplo del agente desde el ejemplo azure.yaml mediante la ejecución de uno de estos comandos:

   • marco del agente de Microsoft:

   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
   

   • Traiga su propio marco:

   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. El flujo interactivo solicita los detalles siguientes:

   • Directorio de la aplicación: ruta de acceso local para inicializar la aplicación.
   • Nombre del agente: personalice el nombre o acepte el valor predeterminado, browser-automation-agent-sample-foundry. El nombre debe tener entre 1 y 63 caracteres, empezar y terminar con una letra o un número, y contener solo letras, números y guiones internos.
   • Proyecto foundry: seleccione un proyecto Foundry existente o cree un proyecto. Si utilizas un proyecto de Foundry ya existente, debes tener el rol Foundry Project Manager en el ámbito del proyecto u otro rol que otorgue permisos tanto para el plano de datos como para la asignación de roles. Para obtener la matriz de roles completa, consulte Referencia de permisos del agente hospedado.
   • Modelo: seleccione el valor predeterminado, gpt-5.4-mini, u otro modelo al que puede acceder.
   • Versión del modelo: seleccione la opción predeterminada.
   • SKU de modelo: seleccione una opción con cuota disponible que no sea Batch, normalmente Estándar o GlobalStandard.
   • Capacidad de implementación: seleccione el valor predeterminado, 10.
   • Nombre de implementación: seleccione el valor predeterminado, gpt-5.4-mini.

Una vez que la aplicación se haya inicializado correctamente, verá el siguiente mensaje:

AI agent definition added to your azd project successfully!

Paso 2.2: Aprovisionamiento de los recursos de Azure

1. Configure las variables de entorno para que apunten a su espacio de trabajo de Playwright

   • Id. de recurso del área de trabajo de Playwright: para obtener el identificador de recurso, abra el recurso Área de trabajo de Playwright, vaya a la página Información general, seleccione Vista JSON y copie el identificador de recurso.

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

   • Dirección URL del servicio Playwright Workspace: para obtener la dirección URL del servicio, abra el recurso Área de trabajo de Playwright y vaya a la página Información general. Copie el punto de conexión del explorador (comienza por wss://).

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

2. Aprovisione los recursos definidos en azure.yaml:

azd provision

Este paso tarda unos minutos y crea los siguientes recursos. Después del aprovisionamiento, verá el siguiente mensaje:

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

Paso 2.3: Implementar el agente en Foundry Agent Service

Compile e implemente el contenedor del agente:

azd deploy

Cuando se haya implementado el agente, verá el siguiente mensaje -

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

Paso 3: Conceder al agente acceso al área de trabajo de Playwright

La identidad administrada del proyecto Foundry debe tener el rol siguiente en el área de trabajo de Azure Playwright:

1. Busque el identificador de objeto de identidad del agente en el portal de Foundry. Vaya a Agentes, seleccione su agente y, a continuación, seleccione Identidad.
2. Asigne el rol mediante CLI de 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"

Paso 4: Probar el agente en el área de juegos de Foundry

1. Abra el portal de Foundry e inicie sesión.
2. Seleccione el proyecto en Proyectos recientes o Todos los proyectos.
3. En el panel de navegación de la izquierda, seleccione Agentes de > compilación.
4. Seleccione el agente y, a continuación, seleccione Abrir en el área de juegos.
5. Introduzca una instrucción como -

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

Paso 4: Limpieza de recursos

Elimine los recursos cuando haya terminado para dejar de incurrir en cargos.

azd down

azd enumera los recursos que elimina y solicita confirmación. La limpieza tarda aproximadamente entre 2 y 5 minutos.