Verwenden des Browser-Tools

Um ein Browser-Tool mit der Konsole zu erstellen

Öffnen Sie die AgentCore Konsole unter https://console.aws.amazon.com/bedrock-agentcore/home#.

Wählen Sie im Navigationsbereich Built-in Tools aus.

Wählen Sie Browser-Tool erstellen.

Geben Sie einen eindeutigen Namen für das Tool und optional eine Beschreibung ein.

Wählen Sie unter Netzwerkeinstellungen die Option Öffentliches Netzwerk aus, das den Zugriff auf öffentliche Internetressourcen ermöglicht.

Unter Sitzungsaufzeichnung können Sie die Aufzeichnung von Browsersitzungen in einem S3-Bucket zur späteren Überprüfung aktivieren.

Geben Sie unter Berechtigungen eine IAM-Ausführungsrolle an, die definiert, auf welche AWS Ressourcen das Browser-Tool zugreifen kann.

Wählen Sie Erstellen aus.

Verwenden Sie den create-browser folgenden Befehl, um ein Browser-Tool mit der AWS CLI zu erstellen:

aws bedrock-agentcore-control create-browser \
  --region <Region> \
  --name "my-browser" \
  --description "My browser for web interaction" \
  --network-configuration '{
    "networkMode": "PUBLIC"
  }' \
  --recording '{
    "enabled": true,
    "s3Location": {
      "bucket": "my-bucket-name",
      "prefix": "sessionreplay"
    }
  }' \
  --execution-role-arn "arn:aws:iam::123456789012:role/my-execution-role"

Verwenden Sie die folgende Methode, um ein Browser-Tool mit dem AWS SDK for Python (Boto3) zu erstellen: create_browser

Anforderungssyntax

Im Folgenden wird die Anforderungssyntax gezeigt:

response = cp_client.create_browser(
    name="my_custom_browser",
    description="Test browser for development",
    networkConfiguration={
        "networkMode": "PUBLIC"
    },
    executionRoleArn="arn:aws:iam::123456789012:role/Sessionreplay",
    clientToken=str(uuid.uuid4()),
    recording={
    "enabled": True,
    "s3Location": {
        "bucket": "session-record-123456789012",
        "prefix": "replay-data"
      }
    }
)

Verwenden Sie den folgenden Aufruf, um mithilfe der API eine neue Browserinstanz zu erstellen:

# Using awscurl
awscurl -X PUT \
  "https://bedrock-agentcore-control.<Region>.amazonaws.com/browsers" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  --service bedrock-agentcore \
  --region <Region> \
  -d '{
    "name": "test_browser_1",
    "description": "Test sandbox for development",
    "networkConfiguration": {
      "networkMode": "PUBLIC"
    },
    "recording": {
      "enabled": true,
      "s3Location": {
        "bucket": "<your-bucket-name>",
        "prefix": "sessionreplay"
      }
    },
    "executionRoleArn": "arn:aws:iam::123456789012:role/my-execution-role"
  }'

Um Informationen über das Browser-Tool mithilfe der Konsole abzurufen

Öffnen Sie die AgentCore Konsole unter https://console.aws.amazon.com/bedrock-agentcore/home#.

Wählen Sie im Navigationsbereich Built-in Tools aus.

Die Browser-Tools sind im Abschnitt Browser-Tools aufgeführt.

Sie können ein von Ihnen erstelltes Tool auswählen, um dessen Details wie Name, ID, Status und Erstellungsdatum für jedes Browser-Tool anzuzeigen.

Verwenden Sie den get-browser folgenden Befehl, um Informationen zu einem Browser-Tool mithilfe der AWS CLI abzurufen:

aws bedrock-agentcore-control get-browser \
  --region <Region> \
  --browser-id "<your-browser-id>"

Verwenden Sie die folgende Methode, um Informationen über das Browser-Tool mit dem AWS SDK for Python (Boto3) get_browser abzurufen:

Anforderungssyntax

Im Folgenden wird die Anforderungssyntax gezeigt:

response = cp_client.get_browser(
    browserId="<your-browser-id>"
)

Verwenden Sie den folgenden Aufruf, um das Browser-Tool mithilfe der API abzurufen:

# Using awscurl
awscurl -X GET \
  "https://bedrock-agentcore-control.<Region>.amazonaws.com/browsers/<your-browser-id>" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  --service bedrock-agentcore \
  --region <Region>

Um Browser-Tools mithilfe der Konsole aufzulisten

Öffnen Sie die AgentCore Konsole unter https://console.aws.amazon.com/bedrock-agentcore/home#.

Wählen Sie im Navigationsbereich Built-in Tools aus.

Die Browser-Tools sind im Abschnitt Browser-Tools aufgeführt.

Sie können Details wie Name, ID, Status und Erstellungsdatum für jedes Browser-Tool anzeigen.

Verwenden Sie den list-browsers folgenden Befehl, um Browser-Tools mithilfe der AWS CLI aufzulisten:

aws bedrock-agentcore-control list-browsers \
  --region <Region>

Sie können die Ergebnisse nach Typ filtern:

aws bedrock-agentcore-control list-browsers \
  --region <Region> \
  --type SYSTEM

Sie können auch die Anzahl der Ergebnisse einschränken und die Paginierung verwenden:

aws bedrock-agentcore-control list-browsers \
  --region <Region> \
  --max-results 10 \
  --next-token "<your-pagination-token>"

Verwenden Sie die folgende Methode, um Browser-Tools aufzulisten, die das AWS SDK for Python (Boto3) verwenden: list_browsers

Anforderungssyntax

Im Folgenden wird die Anforderungssyntax gezeigt:

response = cp_client.list_browsers(type="CUSTOM")

Verwenden Sie den folgenden Aufruf, um Browser-Tools aufzulisten, die die API verwenden:

# Using awscurl
awscurl -X POST \
  "https://bedrock-agentcore-control.<Region>.amazonaws.com/browsers" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  --service bedrock-agentcore \
  --region <Region>

Sie können die Ergebnisse nach Typ filtern:

awscurl -X POST \
  "https://bedrock-agentcore-control.<Region>.amazonaws.com/browsers?type=SYSTEM" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  --service bedrock-agentcore \
  --region <Region>

Sie können auch die Anzahl der Ergebnisse einschränken und die Paginierung verwenden:

awscurl -X POST \
  "https://bedrock-agentcore-control.<Region>.amazonaws.com/browsers?maxResults=1&nextToken=<your-pagination-token>" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  --service bedrock-agentcore \
  --region <Region>

Um ein Browser-Tool mithilfe der Konsole zu löschen

Öffnen Sie die AgentCore Konsole unter https://console.aws.amazon.com/bedrock-agentcore/home#.

Navigieren Sie zu Built-in Tools und wählen Sie Ihr Browser-Tool aus.

Wählen Sie im Menü Aktionen die Option Löschen aus.

Bestätigen Sie den Löschvorgang, indem Sie den Namen des Browser-Tools in das Bestätigungsdialogfeld eingeben.

Wählen Sie Löschen aus.

Verwenden Sie den delete-browser folgenden Befehl, um ein Browser-Tool mit der AWS CLI zu löschen:

aws bedrock-agentcore-control delete-browser \
  --region <Region> \
  --browser-id "<your-browser-id>"

Verwenden Sie die folgende Methode, um ein Browser-Tool mit dem AWS SDK for Python (Boto3) zu löschen: delete_browser

Anforderungssyntax

Im Folgenden wird die Anforderungssyntax gezeigt:

response = cp_client.delete_browser(
    browserId="<your-browser-id>"
    )

Verwenden Sie den folgenden Aufruf, um ein Browser-Tool mithilfe der API zu löschen:

# Using awscurl
awscurl -X DELETE \
  "https://bedrock-agentcore-control.<Region>.amazonaws.com/browsers/<your-browser-id>" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  --service bedrock-agentcore-control \
  --region <Region>