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 de navegador

Creación de un AgentCore navegador

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

ejemplo

Console

Para crear una herramienta de navegación mediante la consola
Abra la AgentCore consola en https://console.aws.amazon.com/bedrock-agentcore/home #.
En el panel de navegación, seleccione Built-in herramientas.
Selecciona Crear herramienta de navegador.
Proporcione un nombre de herramienta único 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, especifica un rol de ejecución de IAM que defina a qué AWS recursos puede acceder la herramienta de navegación.
Seleccione Crear.

AWS CLI

Para crear una herramienta de navegación 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 navegación con el AWS SDK para Python (Boto3), utilice 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, utilice 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

Puedes obtener información sobre la herramienta de navegación en tu cuenta y ver sus detalles, estados y configuraciones.

ejemplo

Console

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

AWS CLI

Para obtener información sobre una herramienta de navegador que utiliza 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 que utiliza 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 de navegación 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 enumerar todas las herramientas del navegador de tu cuenta para ver sus detalles, estados 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, seleccione Built-in herramientas.
Las herramientas del navegador se enumeran 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 enumerar las herramientas del navegador que utilizan la API, utilice 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>

Puede 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 necesites una herramienta de navegación, puedes eliminarla para liberar recursos. Antes de eliminar una herramienta de navegación, asegúrese de detener todas las sesiones activas asociadas a ella.

ejemplo

Console

Para eliminar una herramienta de navegación 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 de navegación 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), utilice 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 de navegación mediante la API, utilice 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

Administrar las sesiones del navegador

Uso de la herramienta de 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