Utilisation de l'outil de navigation

Pour créer un outil de navigation à l'aide de la console

Ouvrez la AgentCore console à l'adresse https://console.aws.amazon.com/bedrock-agentcore/home#.

Dans le volet de navigation, sélectionnez Built-in Outils.

Choisissez Créer un outil de navigateur.

Indiquez un nom d'outil unique et une description facultative.

Sous Paramètres réseau, choisissez Réseau public qui permet d'accéder aux ressources Internet publiques.

Sous Enregistrement de session, vous pouvez activer l'enregistrement des sessions de navigateur dans un compartiment S3 pour un examen ultérieur.

Sous Autorisations, spécifiez un rôle d'exécution IAM qui définit les AWS ressources auxquelles l'outil de navigation peut accéder.

Choisissez Créer.

Pour créer un outil de navigateur à l'aide de la AWS CLI, utilisez la create-browser commande suivante :

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"

Pour créer un outil de navigateur à l'aide du AWS SDK pour Python (Boto3), utilisez la méthode suivante : create_browser

Syntaxe de la demande

Voici la syntaxe de la demande :

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"
      }
    }
)

Pour créer une nouvelle instance de navigateur à l'aide de l'API, utilisez l'appel suivant :

# 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"
  }'

Pour obtenir des informations sur l'outil Navigateur à l'aide de la console

Ouvrez la AgentCore console à l'adresse https://console.aws.amazon.com/bedrock-agentcore/home#.

Dans le volet de navigation, sélectionnez Built-in Outils.

Les outils du navigateur sont répertoriés dans la section Outils du navigateur.

Vous pouvez choisir un outil que vous avez créé pour afficher ses détails tels que le nom, l'identifiant, le statut et la date de création de chaque outil de navigateur.

Pour obtenir des informations sur un outil de navigateur à l'aide de la AWS CLI, utilisez la get-browser commande :

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

Pour obtenir des informations sur l'outil Browser à l'aide du AWS SDK pour Python (Boto3), utilisez la méthode suivante : get_browser

Syntaxe de la demande

Voici la syntaxe de la demande :

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

Pour obtenir l'outil de navigateur à l'aide de l'API, utilisez l'appel suivant :

# 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>

Pour répertorier les outils du navigateur à l'aide de la console

Ouvrez la AgentCore console à l'adresse https://console.aws.amazon.com/bedrock-agentcore/home#.

Dans le volet de navigation, sélectionnez Built-in Outils.

Les outils du navigateur sont répertoriés dans la section Outils du navigateur.

Vous pouvez consulter les détails tels que le nom, l'identifiant, le statut et la date de création de chaque outil de navigateur.

Pour répertorier les outils du navigateur à l'aide de la AWS CLI, utilisez la list-browsers commande :

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

Vous pouvez filtrer les résultats par type :

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

Vous pouvez également limiter le nombre de résultats et utiliser la pagination :

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

Pour répertorier les outils du navigateur à l'aide du AWS SDK pour Python (Boto3), utilisez la méthode suivante : list_browsers

Syntaxe de la demande

Voici la syntaxe de la demande :

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

Pour répertorier les outils du navigateur à l'aide de l'API, utilisez l'appel suivant :

# 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>

Vous pouvez filtrer les résultats par type :

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>

Vous pouvez également limiter le nombre de résultats et utiliser la pagination :

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>

Pour supprimer un outil de navigateur à l'aide de la console

Ouvrez la AgentCore console à l'adresse https://console.aws.amazon.com/bedrock-agentcore/home#.

Accédez aux Built-in outils et sélectionnez l'outil de votre navigateur.

Dans le menu Actions, choisissez Delete (Supprimer).

Confirmez la suppression en saisissant le nom de l'outil du navigateur dans la boîte de dialogue de confirmation.

Sélectionnez Delete (Supprimer).

Pour supprimer un outil de navigateur à l'aide de la AWS CLI, utilisez la delete-browser commande suivante :

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

Pour supprimer un outil de navigateur à l'aide du AWS SDK pour Python (Boto3), utilisez la méthode suivante : delete_browser

Syntaxe de la demande

Voici la syntaxe de la demande :

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

Pour supprimer un outil de navigateur à l'aide de l'API, utilisez l'appel suivant :

# 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>