Usando a ferramenta do navegador

Para criar uma ferramenta de navegador usando o console

Abra o AgentCore console em https://console.aws.amazon.com/bedrock-agentcore/home#.

No painel de navegação, escolha Built-in ferramentas.

Escolha Criar ferramenta de navegador.

Forneça um nome exclusivo da ferramenta e uma descrição opcional.

Em Configurações de rede, escolha Rede pública que permite acesso a recursos públicos da Internet.

Em Gravação de sessão, você pode ativar a gravação de sessões do navegador em um bucket do S3 para análise posterior.

Em Permissões, especifique uma função de execução do IAM que define quais AWS recursos a Browser Tool pode acessar.

Escolha Criar.

Para criar uma ferramenta de navegador usando a AWS CLI, use o 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"

Para criar uma ferramenta de navegador usando o AWS SDK para Python (Boto3), use o método: create_browser

Sintaxe da solicitação

Veja a seguir a sintaxe da solicitação:

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

Para criar uma nova instância do navegador usando a API, use a seguinte chamada:

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

Para obter informações sobre a ferramenta Browser usando o console

Abra o AgentCore console em https://console.aws.amazon.com/bedrock-agentcore/home#.

No painel de navegação, escolha Built-in ferramentas.

As ferramentas do navegador estão listadas na seção Ferramentas do navegador.

Você pode escolher uma ferramenta criada para visualizar seus detalhes, como nome, ID, status e data de criação de cada ferramenta do navegador.

Para obter informações sobre uma ferramenta de navegador usando a AWS CLI, use o get-browser comando:

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

Para obter informações sobre a ferramenta Browser usando o AWS SDK para Python (Boto3), use o método: get_browser

Sintaxe da solicitação

Veja a seguir a sintaxe da solicitação:

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

Para obter a ferramenta do navegador usando a API, use a seguinte chamada:

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

Para listar as ferramentas do navegador usando o console

Abra o AgentCore console em https://console.aws.amazon.com/bedrock-agentcore/home#.

No painel de navegação, escolha Built-in ferramentas.

As ferramentas do navegador estão listadas na seção Ferramentas do navegador.

Você pode visualizar detalhes como nome, ID, status e data de criação de cada ferramenta do navegador.

Para listar as ferramentas do navegador usando a AWS CLI, use o list-browsers comando:

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

Você pode filtrar os resultados por tipo:

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

Você também pode limitar o número de resultados e usar a paginação:

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

Para listar as ferramentas do navegador usando o AWS SDK para Python (Boto3), use o método: list_browsers

Sintaxe da solicitação

Veja a seguir a sintaxe da solicitação:

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

Para listar as ferramentas do navegador usando a API, use a seguinte chamada:

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

Você pode filtrar os 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>

Você também pode limitar o número de resultados e usar a paginação:

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>

Para excluir uma ferramenta do navegador usando o console

Abra o AgentCore console em https://console.aws.amazon.com/bedrock-agentcore/home#.

Navegue até Built-in as ferramentas e selecione a ferramenta do seu navegador.

Escolha Excluir no menu Ações.

Confirme a exclusão digitando o nome da ferramenta do navegador na caixa de diálogo de confirmação.

Escolha Excluir.

Para excluir uma ferramenta do navegador usando a AWS CLI, use o delete-browser comando:

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

Para excluir uma ferramenta do navegador usando o AWS SDK para Python (Boto3), use o método: delete_browser

Sintaxe da solicitação

Veja a seguir a sintaxe da solicitação:

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

Para excluir uma ferramenta do navegador usando a API, use a seguinte chamada:

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