Creación de un AgentCore navegador Obtenga la herramienta de AgentCore navegador Listar las herramientas AgentCore del navegador Eliminar un navegador AgentCore

Uso de la herramienta del navegador

Creación de un AgentCore navegador

Puede crear una herramienta de navegador mediante la AgentCore consola, la AWS CLI o el AWS SDK de Amazon Bedrock.

ejemplo

Console

Para crear una herramienta de navegador mediante la consola
Abra la AgentCore consola en https://console.aws.amazon.com/bedrock-agentcore/home#.
En el panel de navegación, selecciona Built-in herramientas.
Seleccione Crear herramienta de navegador.
Proporcione un nombre de herramienta exclusivo y una descripción opcional.
En Configuración de red, selecciona Red pública que permite el acceso a los recursos públicos de Internet.
En Grabación de sesiones, puedes habilitar la grabación de las sesiones del navegador en un bucket de S3 para revisarlas más adelante.
En Permisos, especifique una función de ejecución de IAM que defina a qué AWS recursos puede acceder la herramienta del navegador.
Seleccione Crear.

AWS CLI

Para crear una herramienta de navegador mediante la AWS CLI, utilice el create-browser comando:


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

Para crear una herramienta de navegador con el AWS SDK para Python (Boto3), usa el método: create_browser

Sintaxis de la solicitud

A continuación se muestra la sintaxis de la solicitud:


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

Para crear una nueva instancia de navegador mediante la API, usa la siguiente llamada:


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

Obtenga la herramienta de AgentCore navegador

Puede obtener información sobre la herramienta de navegación de su cuenta y ver sus detalles, estado y configuraciones.

ejemplo

Console

Para obtener información sobre la herramienta del navegador mediante la consola
Abra la AgentCore consola en https://console.aws.amazon.com/bedrock-agentcore/home#.
En el panel de navegación, selecciona Built-in herramientas.
Las herramientas del navegador se muestran en la sección Herramientas del navegador.
Puede elegir una herramienta que haya creado para ver sus detalles, como el nombre, el ID, el estado y la fecha de creación de cada herramienta del navegador.

AWS CLI

Para obtener información sobre una herramienta de navegador mediante la AWS CLI, utilice el get-browser comando:
```
aws bedrock-agentcore-control get-browser \
  --region <Region> \
  --browser-id "<your-browser-id>"
```

Boto3

Para obtener información sobre la herramienta de navegador mediante el AWS SDK para Python (Boto3), utilice el método: get_browser

Sintaxis de la solicitud

A continuación, se muestra la sintaxis de la solicitud:
```
response = cp_client.get_browser(
    browserId="<your-browser-id>"
)
```

API

Para que la herramienta del navegador utilice la API, utilice la siguiente llamada:


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

Listar las herramientas AgentCore del navegador

Puedes hacer una lista de todas las herramientas del navegador de tu cuenta para ver sus detalles, estado y configuraciones.

ejemplo

Console

Para ver una lista de las herramientas del navegador mediante la consola
Abra la AgentCore consola en https://console.aws.amazon.com/bedrock-agentcore/home#.
En el panel de navegación, selecciona Built-in herramientas.
Las herramientas del navegador se muestran en la sección Herramientas del navegador.
Puede ver detalles como el nombre, el ID, el estado y la fecha de creación de cada herramienta del navegador.

AWS CLI

Para enumerar las herramientas del navegador mediante la AWS CLI, utilice el list-browsers comando:


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

Puede filtrar los resultados por tipo:


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

También puedes limitar el número de resultados y usar la paginación:


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

Boto3

Para enumerar las herramientas del navegador que utilizan el AWS SDK para Python (Boto3), usa el método: list_browsers

Sintaxis de la solicitud

A continuación, se muestra la sintaxis de la solicitud:
```
response = cp_client.list_browsers(type="CUSTOM")
```

API

Para ver una lista de las herramientas del navegador que utilizan la API, usa la siguiente llamada:


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

Puedes filtrar los resultados por tipo:


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>

También puedes limitar el número de resultados y usar la paginación:


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>

Eliminar un navegador AgentCore

Cuando ya no necesite una herramienta de navegación, puede eliminarla para liberar recursos. Antes de eliminar una herramienta del navegador, asegúrate de detener todas las sesiones activas asociadas a ella.

ejemplo

Console

Para eliminar una herramienta del navegador mediante la consola
Abra la AgentCore consola en https://console.aws.amazon.com/bedrock-agentcore/home#.
Navegue hasta Built-in las herramientas y seleccione la herramienta de su navegador.
En el menú Acciones, elija Eliminar.
Confirme la eliminación escribiendo el nombre de la herramienta del navegador en el cuadro de diálogo de confirmación.
Elija Eliminar.

nota
No puede eliminar una herramienta del navegador que tenga sesiones activas. Detenga todas las sesiones antes de intentar eliminar la herramienta.

AWS CLI

Para eliminar una herramienta de navegador mediante la AWS CLI, utilice el delete-browser comando:


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

Boto3

Para eliminar una herramienta de navegador mediante el AWS SDK para Python (Boto3), usa el método: delete_browser

Sintaxis de la solicitud

A continuación, se muestra la sintaxis de la solicitud:
```
response = cp_client.delete_browser(
    browserId="<your-browser-id>"
    )
```

API

Para eliminar una herramienta del navegador mediante la API, usa la siguiente llamada:


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

Aviso JavaScript está desactivado o no está disponible en su navegador.

Para utilizar la documentación de AWS, debe estar habilitado JavaScript. Para obtener más información, consulte las páginas de ayuda de su navegador.

Convenciones del documento

Aspectos fundamentales

Gestión de las sesiones del navegador

Uso de la herramienta del navegador

Creación de un AgentCore navegador

ejemplo

Obtenga la herramienta de AgentCore navegador

ejemplo

Listar las herramientas AgentCore del navegador

ejemplo

Eliminar un navegador AgentCore

ejemplo

nota