Auf dieser Seite wird gezeigt, wie Sie direkte API-Aufrufe ausführen, um eine Sandbox-Umgebung für die Computernutzung der Agent Platform zu erstellen und zu verwenden. In dieser Kurzanleitung führen Sie die folgenden Aufgaben aus:
- Erstellen Sie eine Agent Platform-Instanz, um auf die Sandbox zuzugreifen.
- Erstellen Sie eine Sandbox für die Computernutzung.
- Generieren Sie ein Zugriffstoken für die Sandbox.
- Senden Sie eine Anfrage, um den Status zu prüfen.
- Ressourcen bereinigen
Hinweis
Richten Sie Ihr Projekt und Ihre Umgebung ein.
Projekt einrichten
-
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 theresourcemanager.projects.createpermission. Learn how to grant roles.
-
Verify that billing is enabled for your Google Cloud project.
Enable the Gemini Enterprise Agent Platform API, if it is not already enabled.
Roles required to enable APIs
To enable APIs, you need the
serviceusage.services.enablepermission. If you created the project, then you likely already have this permission through the Owner role (roles/owner). Otherwise, you can get this permission through the Service Usage Admin role (roles/serviceusage.serviceUsageAdmin). Learn how to grant roles.
Erforderliche Rollen abrufen
Wenn Sie die Sandbox verwenden und Tokens generieren möchten, benötigen Sie die folgenden Rollen:
- Agent Platform User (
roles/aiplatform.user) für das Projekt. - Ersteller von Dienstkonto-Token (
roles/iam.serviceAccountTokenCreator) für das Dienstkonto, das für die Tokengenerierung verwendet wird. - Das für die Tokengenerierung verwendete Dienstkonto muss außerdem die Rolle „Agent Platform User“ (
roles/aiplatform.user) für das Projekt haben.
Bibliotheken installieren
Installieren Sie das Agent Platform SDK:
pip install google-cloud-agentplatform>=2.0.1Agent Platform-Instanz erstellen
Wenn Sie die Sandbox verwenden möchten, müssen Sie zuerst eine Agent Platform-Instanz erstellen.
import agentplatform
client = agentplatform.Client(
project='PROJECT_ID',
location='LOCATION',
http_options={
"api_version": "v1beta1",
}
)
remote_agent = client.runtimes.create()
remote_agent_name = remote_agent.api_resource.name
Ersetzen Sie Folgendes:
PROJECT_ID: Ihre Google Cloud Projekt-IDLOCATION: Die Region für Ihre Instanz, z. B.us-central1.
Wenn Sie Ihre Sandbox-Daten mit kundenverwalteten Verschlüsselungsschlüsseln (CMEK) verschlüsseln möchten, müssen Sie CMEK beim Erstellen Ihrer Agent Platform-Instanz konfigurieren. Weitere Informationen finden Sie unter Kundenverwaltete Verschlüsselungsschlüssel (CMEK) konfigurieren.
Vorlage für die Computernutzung erstellen
Erstellen Sie eine Sandbox-Vorlage, die Sie beim Erstellen einer Sandbox für die Computernutzung verwenden.
# Create a default Computer Use sandbox template
templates_client = client.sandboxes.templates
tmplt_operation = templates_client.create(
name=remote_agent_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}")
Sandbox für die Computernutzung erstellen
Erstellen Sie eine Sandbox-Umgebung aus der Vorlage.
# Create a sandbox environment referencing the template.
# To customize the lifetime, set `ttl` to a duration string in seconds (for example, "3600s" for 1 hour).
create_operation = client.sandboxes.create(
name=remote_agent_name,
config={
"sandbox_environment_template": template_name,
"display_name": 'DISPLAY_NAME',
"ttl": "3600s", # Optional. Overrides the default 2-hour sandbox lifetime.
}
)
sandbox = create_operation.response
print(f"Created sandbox environment: {sandbox.name}")
print(f"Sandbox will expire at: {sandbox.expire_time}")
Zugriffstoken erstellen
Wenn Sie mit der Sandbox interagieren möchten, generieren Sie mithilfe eines Dienstkontos ein JSON Web Token (JWT)-Zugriffstoken.
service_account_email = "SERVICE_ACCOUNT_EMAIL"
access_token = client.sandboxes.generate_access_token(
service_account_email=service_account_email,
)
Ersetzen Sie SERVICE_ACCOUNT_EMAIL durch die E-Mail-Adresse des Dienstkontos, das die Rolle „Ersteller von Dienstkonto-Tokens“ hat.
Anfrage an die Sandbox senden
Senden Sie eine HTTP-GET-Anfrage an den Sandbox-API-Server, um seinen Status zu prüfen.
response = client.sandboxes.send_command(
http_method="GET",
access_token=access_token,
sandbox_environment=sandbox
)
print(f"Sandbox response: {response.body}")
Senden Sie eine HTTP-POST-Anfrage, um eine bestimmte Seite aufzurufen.
data = {"command": "Page.navigate", "params": {"url": "https://example.com"}}
response = client.sandboxes.send_command(
http_method="POST",
path="cdp",
access_token=access_token,
request_dict=data,
sandbox_environment=sandbox
)
In der folgenden Tabelle sind zusätzliche Methoden und Pfade aufgeführt, die Sie an Ihre Sandbox senden können:
| Methode | Pfad | Beschreibung |
|---|---|---|
| GET | / | Ruft die Systemdiagnose der Sandbox ab. |
| POST | /tabs | Erstellt einen neuen Tab und gibt die zugehörigen Details zurück. |
| GET | /tabs | Listet Details zu allen geöffneten Tabs auf. |
| POST | /tabs/{tab_id}/activate | Legt einen Tab als aktiv fest und bringt ihn in den Vordergrund. |
| LÖSCHEN | /tabs/{tab_id} | Schließt einen bestimmten Tab. |
| GET | /cdp_ws_endpoint | Gibt den CDP-WebSocket-Endpunktpfad zurück. |
| POST | /cdp | Führt einen CDP-Befehl auf dem aktiven Tab aus. |
| POST | /cdps | Führt mehrere CDP-Befehle auf dem aktiven Tab aus. |
Weitere Informationen zu den unterstützten CDP-Befehlen und zum Format finden Sie auf der CDP-Website.
Bereinigen
Löschen Sie die in dieser Kurzanleitung erstellten Ressourcen, um Gebühren zu vermeiden.
client.sandboxes.delete(name=sandbox.name)
remote_agent.delete()