Guía de inicio rápido de Computer Use

En esta página, se muestra cómo realizar llamadas directas a la API para crear y usar un entorno de zona de pruebas de Computer Use. En esta guía de inicio rápido, realizarás las siguientes tareas:

  • Crea una instancia de Agent Platform para acceder al sandbox.
  • Crea una zona de pruebas de uso de la computadora.
  • Genera un token de acceso para la zona de pruebas.
  • Envía una solicitud para verificar el estado.
  • Limpia los recursos.

Antes de comenzar

Configura tu proyecto y tu entorno.

Configura tu proyecto

  1. Accede a tu cuenta de Google Cloud . Si eres nuevo en Google Cloud, crea una cuenta para evaluar el rendimiento de nuestros productos en situaciones reales. Los clientes nuevos también obtienen $300 en créditos gratuitos para ejecutar, probar y, además, implementar cargas de trabajo.

  2. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Roles required to select or create a project

    • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
    • Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

    Go to project selector

  3. Verify that billing is enabled for your Google Cloud project.

  4. Enable the Gemini Enterprise Agent Platform API.

    Roles required to enable APIs

    To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

    Enable the API

  5. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Roles required to select or create a project

    • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
    • Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

    Go to project selector

  6. Verify that billing is enabled for your Google Cloud project.

  7. Enable the Gemini Enterprise Agent Platform API.

    Roles required to enable APIs

    To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

    Enable the API

    8.

Obtén los roles necesarios

Para usar el entorno de pruebas y generar tokens, necesitas los siguientes roles:

  • Usuario de Agent Platform (roles/aiplatform.user) en el proyecto.
  • Creador de tokens de cuenta de servicio (roles/iam.serviceAccountTokenCreator) en la cuenta de servicio que se usa para generar tokens
  • La cuenta de servicio que se usa para generar tokens también debe tener el rol de usuario de Agent Platform (roles/aiplatform.user) en el proyecto.

Instala bibliotecas

Instala el SDK de Agent Platform: posix-terminal pip install google-cloud-aiplatform>=1.112.0

Crea una instancia de Agent Platform

Para usar el entorno de pruebas, primero crea una instancia de Agent Platform.

import vertexai
client = vertexai.Client(
    project='PROJECT_ID',
    location='LOCATION',
    http_options={
        "api_version": "v1beta1",
    }
)
agent_instance = client.agent_engines.create()
agent_instance_name = agent_instance.api_resource.name

Reemplaza lo siguiente:

  • "PROJECT_ID": Es el ID de tu proyecto de Google Cloud .
  • "LOCATION": Es la región de tu instancia (por ejemplo, us-central1).

Crea una plantilla para el uso de la computadora

Crea una plantilla de zona de pruebas que usarás cuando crees una zona de pruebas de uso de la computadora.

# Create a default Computer Use sandbox template
templates_client = client.agent_engines.sandboxes.templates
tmplt_operation = templates_client.create(
    name=agent_instance_name,
    display_name='DISPLAY_NAME',
    config={
        "default_container_environment": {
            "default_container_category": "DEFAULT_CONTAINER_CATEGORY_COMPUTER_USE",
        },
        "egress_control_config": {
            "internet_access": True,
        },
    },
)
template_name = tmplt_operation.response.name
print(f"Created template: {template_name}")

Crea una zona de pruebas de uso de la computadora

Crea un entorno de pruebas a partir de la plantilla.

# Create a sandbox environment referencing the template
create_operation = client.agent_engines.sandboxes.create(
    name=agent_instance_name,
    config={
        "sandbox_environment_template": template_name,
        "display_name": 'DISPLAY_NAME',
    }
)
sandbox = create_operation.response
print(f"Created sandbox environment: {sandbox.name}")

Genera un token de acceso

Para interactuar con el entorno de pruebas, genera un token de acceso de token web JSON (JWT) con una cuenta de servicio.

service_account_email = "SERVICE_ACCOUNT_EMAIL"
access_token = client.agent_engines.sandboxes.generate_access_token(
    service_account_email=service_account_email,
)

Reemplaza SERVICE_ACCOUNT_EMAIL por el correo electrónico de la cuenta de servicio que tiene el rol de Creador de tokens de cuenta de servicio.

Envía una solicitud a la zona de pruebas

Envía una solicitud GET de HTTP al servidor de la API de zona de pruebas para verificar su estado.

response = client.agent_engines.sandboxes.send_command(
    http_method="GET",
    access_token=access_token,
    sandbox_environment=sandbox
)
print(f"Sandbox response: {response.body}")

Realiza una limpieza

Para evitar que se generen cargos, borra los recursos que creaste en esta guía de inicio rápido.

client.agent_engines.sandboxes.delete(name=sandbox.name)
agent_instance.delete()

¿Qué sigue?

  • Explora las instantáneas para la administración del ciclo de vida del entorno de pruebas.