Création d'un AgentCore navigateur Outil Get AgentCore Browser Outils AgentCore du navigateur de listes Supprimer un AgentCore navigateur

Utilisation de l'outil de navigation

Création d'un AgentCore navigateur

Vous pouvez créer un outil de navigation à l'aide de la AgentCore console, de l' AWS interface de ligne de commande ou du AWS SDK Amazon Bedrock.

Exemple

Console

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, choisissez Built-in Outils.
Choisissez Créer un outil de navigation.
Fournissez un nom d'outil unique et une description facultative.
Dans Paramètres réseau, choisissez Réseau public qui autorise l'accès aux ressources Internet publiques.
Sous Enregistrement de session, vous pouvez activer l'enregistrement des sessions du navigateur dans un compartiment S3 pour une révision ultérieure.
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.

AWS CLI

Pour créer un outil de navigation à l'aide de l' AWS interface de ligne de commande, 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"

Boto3

Pour créer un outil de navigation à 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"
      }
    }
)

API

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

Outil Get AgentCore Browser

Vous pouvez obtenir des informations sur l'outil Navigateur dans votre compte et consulter ses détails, son état et ses configurations.

Exemple

Console

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, choisissez 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 navigation.

AWS CLI

Pour obtenir des informations sur un outil de navigateur à l'aide de l' AWS interface de ligne de commande, utilisez la get-browser commande suivante :
```
aws bedrock-agentcore-control get-browser \
  --region <Region> \
  --browser-id "<your-browser-id>"
```

Boto3

Pour obtenir des informations sur l'outil Navigateur à 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>"
)
```

API

Pour obtenir l'outil de navigation à 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>

Outils AgentCore du navigateur de listes

Vous pouvez répertorier tous les outils de navigation de votre compte pour afficher leurs détails, leur état et leur configuration.

Exemple

Console

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, choisissez Built-in Outils.
Les outils du navigateur sont répertoriés dans la section Outils du navigateur.
Vous pouvez consulter des informations telles que le nom, l'identifiant, le statut et la date de création de chaque outil de navigation.

AWS CLI

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


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

Boto3

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

API

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>

Supprimer un AgentCore navigateur

Lorsque vous n'avez plus besoin d'un outil de navigation, vous pouvez le supprimer pour libérer des ressources. Avant de supprimer un outil de navigation, assurez-vous d'arrêter toutes les sessions actives qui lui sont associées.

Exemple

Console

Pour supprimer un outil de navigation à 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).

Note
Vous ne pouvez pas supprimer un outil de navigation dont les sessions sont actives. Arrêtez toutes les sessions avant de tenter de supprimer l'outil.

AWS CLI

Pour supprimer un outil de navigateur à l'aide de l' AWS interface de ligne de commande, utilisez la delete-browser commande suivante :
```
aws bedrock-agentcore-control delete-browser \
  --region <Region> \
  --browser-id "<your-browser-id>"
```

Boto3

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

API

Pour supprimer un outil de navigation à 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>

Avertissement JavaScript est désactivé ou n'est pas disponible dans votre navigateur.

Pour que vous puissiez utiliser la documentation AWS, Javascript doit être activé. Vous trouverez des instructions sur les pages d'aide de votre navigateur.

Conventions de rédaction

Principes fondamentaux

Gestion des sessions du navigateur

Utilisation de l'outil de navigation

Création d'un AgentCore navigateur

Exemple

Outil Get AgentCore Browser

Exemple

Outils AgentCore du navigateur de listes

Exemple

Supprimer un AgentCore navigateur

Exemple

Note