View a markdown version of this page

Usando perfis de navegador - Base da Amazônia AgentCore
Visão geral doPré-requisitosComeçando com perfis de navegadorOperações de perfil do navegadorCasos de usoConsiderações

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Usando perfis de navegador

Os perfis do navegador permitem que você persista e reutilize os dados do perfil do navegador em várias sessões do navegador. Um perfil de navegador armazena informações da sessão, incluindo cookies e armazenamento local.

Por exemplo, você pode se autenticar em um site uma vez em uma sessão do navegador e salvar os dados do perfil no recurso de perfil do navegador. Quando você inicia uma nova sessão do navegador com esse perfil salvo, seu estado de autenticação é preservado e você permanece conectado. Isso permite que os agentes realizem tarefas em sites autenticados sem precisar de intervenção manual.

Visão geral do

Os perfis de navegador no Amazon Bedrock AgentCore funcionam da seguinte maneira:

  1. Crie um recurso de perfil de navegador que será reutilizado em todas as sessões do navegador

  2. Inicie uma sessão no navegador e realize ações (como fazer login em um site ou colocar um item no carrinho de compras) que preenchem os cookies e o armazenamento local

  3. Salve os dados do perfil da sessão atual do navegador no recurso de perfil do navegador

  4. Inicie novas sessões do navegador usando o perfil salvo para restaurar o estado anterior

Pré-requisitos

Antes de usar perfis de navegador, verifique se você tem:

  • Concluiu os pré-requisitos gerais do navegador

  • Permissões do IAM para gerenciar recursos de perfil. Adicione as seguintes permissões à sua política do IAM:

    {
"Version": "2012-10-17",
    "Statement": [
        {
            "Sid": "BedrockAgentCoreBrowserProfileManagementAccess",
            "Effect": "Allow",
            "Action": [
                "bedrock-agentcore:CreateBrowserProfile",
                "bedrock-agentcore:ListBrowserProfiles",
                "bedrock-agentcore:GetBrowserProfile",
                "bedrock-agentcore:DeleteBrowserProfile"
            ],
            "Resource": "arn:aws:bedrock-agentcore:<Region>:<account_id>:browser-profile/*"
        }
    ]
}

  • Permissões do IAM para salvar e carregar perfis. Adicione as seguintes permissões à sua política do IAM:

    {
"Version": "2012-10-17",
    "Statement": [
        {
            "Sid": "BedrockAgentCoreBrowserProfileUsageAccess",
            "Effect": "Allow",
            "Action": [
                "bedrock-agentcore:StartBrowserSession",
                "bedrock-agentcore:SaveBrowserSessionProfile"
            ],
            "Resource": [
                "arn:aws:bedrock-agentcore:<Region>:<account_id>:browser-profile/*",
                "arn:aws:bedrock-agentcore:<Region>:<account_id>:browser-custom/*",
                "arn:aws:bedrock-agentcore:<Region>:<account_id>:browser/*"
            ]
        }
    ]
}

Começando com perfis de navegador

Esta seção orienta você na criação de um perfil de navegador, no salvamento dos dados da sessão nele e na reutilização do perfil nas sessões subsequentes.

Etapa 1: criar um perfil de navegador

Crie um recurso de perfil de navegador para armazenar dados da sessão.

exemplo
AWS CLI

  1. Para criar um perfil de navegador usando a AWS CLI:

    aws bedrock-agentcore-control create-browser-profile \
  --region <Region> \
  --name "profile_demo" \
  --description "example profile"
Boto3

  1. Para criar um perfil de navegador usando o AWS SDK para Python (Boto3):

    import boto3

region = "us-west-2"
client = boto3.client('bedrock-agentcore-control', region_name=region)

response = client.create_browser_profile(
    name="profile_demo",
    description="example profile"
)

profile_id = response['profileId']
print(f"Created profile: {profile_id}")
API

  1. Para criar um perfil de navegador usando a API:

    awscurl -X PUT \
  "https://bedrock-agentcore-control.<Region>.amazonaws.com/browser-profiles" \
  -H "Content-Type: application/json" \
  --service bedrock-agentcore-control \
  --region <Region> \
  -d '{
    "name": "profile_demo",
    "description": "example profile",
    "clientToken": "FC21DD1F-FA7B-40EC-8D3A-12E029A1BFF3"
  }'

Etapa 2: iniciar uma sessão do navegador e realizar ações

Inicie uma sessão do navegador e realize ações como fazer login em um site. O estado da sessão, incluindo cookies e armazenamento local, será capturado.

exemplo
AWS CLI

  1. Para iniciar uma sessão do navegador usando a AWS CLI:

    aws bedrock-agentcore start-browser-session \
  --region <Region> \
  --browser-identifier "aws.browser.v1" \
  --name "my-session" \
  --session-timeout-seconds 3600

    Use o ID de sessão retornado para interagir com o navegador e realizar as ações desejadas (por exemplo, fazer login em um site).

Boto3

  1. Para iniciar uma sessão do navegador usando o Boto3:

    import boto3

region = "us-west-2"
client = boto3.client('bedrock-agentcore', region_name=region)

response = client.start_browser_session(
    browserIdentifier="aws.browser.v1",
    name="my-session",
    sessionTimeoutSeconds=3600
)

session_id = response['sessionId']
print(f"Session ID: {session_id}")

# Use the session to perform actions (e.g., login to a website)
# ... your browser automation code here ...
API

  1. Para iniciar uma sessão do navegador usando a API:

    awscurl -X PUT \
  "https://bedrock-agentcore.<Region>.amazonaws.com/browsers/aws.browser.v1/sessions/start" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  --service bedrock-agentcore \
  --region <Region> \
  -d '{
    "name": "my-session",
    "sessionTimeoutSeconds": 3600
  }'

Etapa 3: Salvar a sessão em um perfil

Depois de realizar ações na sessão do navegador, salve o estado atual no perfil do seu navegador. Isso captura cookies, armazenamento local e outros dados da sessão.

exemplo
AWS CLI

  1. Para salvar uma sessão do navegador em um perfil usando a AWS CLI:

    aws bedrock-agentcore save-browser-session-profile \
  --region <Region> \
  --profile-identifier "<ProfileId>" \
  --browser-identifier "aws.browser.v1" \
  --session-id "<SessionId>"
Boto3

  1. Para salvar uma sessão do navegador em um perfil usando o Boto3:

    import boto3

region = "us-west-2"
client = boto3.client('bedrock-agentcore', region_name=region)

response = client.save_browser_session_profile(
    profileIdentifier=profile_id,  # From Step 1
    browserIdentifier="aws.browser.v1",
    sessionId=session_id  # From Step 2
)

print(f"Profile saved successfully")
API

  1. Para salvar uma sessão do navegador em um perfil usando a API:

    awscurl -X PUT \
  "https://bedrock-agentcore.<Region>.amazonaws.com/browser-profiles/<ProfileId>/save" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  --service bedrock-agentcore \
  --region <Region> \
  -d '{
    "browserIdentifier": "aws.browser.v1",
    "sessionId": "<SessionId>",
    "clientToken": "52866F95-4468-4B6C-920C-09A00D36F04E"
  }'

Etapa 4: iniciar uma nova sessão com o perfil

Inicie uma nova sessão do navegador usando o perfil salvo. A sessão será inicializada com o estado salvo, incluindo cookies de autenticação e armazenamento local.

exemplo
AWS CLI

  1. Para iniciar uma sessão do navegador com um perfil usando a AWS CLI:

    aws bedrock-agentcore start-browser-session \
  --region <Region> \
  --browser-identifier "aws.browser.v1" \
  --name "session-with-profile" \
  --session-timeout-seconds 3600 \
  --profile-configuration '{
    "profileIdentifier":"<ProfileId>"
  }'
Boto3

  1. Para iniciar uma sessão do navegador com um perfil usando o Boto3:

    import boto3

region = "us-west-2"
client = boto3.client('bedrock-agentcore', region_name=region)

response = client.start_browser_session(
    browserIdentifier="aws.browser.v1",
    name="session-with-profile",
    sessionTimeoutSeconds=3600,
    profileConfiguration={
        "profileIdentifier": profile_id  # From Step 1
    }
)

new_session_id = response['sessionId']
print(f"New session started with profile: {new_session_id}")
print("Session is now authenticated with saved cookies and state")
API

  1. Para iniciar uma sessão do navegador com um perfil usando a API:

    awscurl -X PUT \
  "https://bedrock-agentcore.<Region>.amazonaws.com/browsers/aws.browser.v1/sessions/start" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  --service bedrock-agentcore \
  --region <Region> \
  -d '{
    "name": "session-with-profile",
    "sessionTimeoutSeconds": 3600,
    "profileConfiguration": {
      "profileIdentifier": "<ProfileId>"
    },
    "clientToken": "8FAAFF7F-7803-4C40-A7BD-139C6D008646"
  }'

Operações de perfil do navegador

Esta seção descreve operações adicionais para gerenciar perfis de navegador.

Listando perfis de navegador

Você pode listar todos os perfis de navegador em sua conta.

exemplo
AWS CLI

  1. Para listar perfis de navegador usando a AWS CLI:

    aws bedrock-agentcore-control list-browser-profiles \
  --region <Region>
Boto3

  1. Para listar perfis de navegador usando o Boto3:

    import boto3

region = "us-west-2"
client = boto3.client('bedrock-agentcore-control', region_name=region)

response = client.list_browser_profiles()

for profile in response.get('items', []):
    print(f"Profile ID: {profile['profileId']}")
    print(f"Name: {profile['name']}")
    print(f"Status: {profile['status']}")
    print("---")
API

  1. Para listar perfis de navegador usando a API:

    awscurl -X POST \
  "https://bedrock-agentcore-control.<Region>.amazonaws.com/browser-profiles/list" \
  -H "Content-Type: application/json" \
  --service bedrock-agentcore-control \
  --region <Region>

Obter detalhes do perfil do navegador

Você pode recuperar detalhes sobre um perfil de navegador específico.

exemplo
AWS CLI

  1. Para obter detalhes do perfil do navegador usando a AWS CLI:

    aws bedrock-agentcore-control get-browser-profile \
  --region <Region> \
  --profile-id "<ProfileId>"
Boto3

  1. Para obter detalhes do perfil do navegador usando o Boto3:

    import boto3

region = "us-west-2"
client = boto3.client('bedrock-agentcore-control', region_name=region)

response = client.get_browser_profile(
    profileId=profile_id
)

print(f"Profile ID: {response['profileId']}")
print(f"Name: {response['name']}")
print(f"Description: {response.get('description', 'N/A')}")
print(f"Status: {response['status']}")
print(f"Created: {response['createdAt']}")
API

  1. Para obter detalhes do perfil do navegador usando a API:

    awscurl -X GET \
  "https://bedrock-agentcore-control.<Region>.amazonaws.com/browser-profiles/<ProfileId>" \
  -H "Content-Type: application/json" \
  --service bedrock-agentcore-control \
  --region <Region>

Excluindo um perfil de navegador

Quando você não precisar mais de um perfil de navegador, poderá excluí-lo para liberar recursos.

exemplo
AWS CLI

  1. Para excluir um perfil de navegador usando a AWS CLI:

    aws bedrock-agentcore-control delete-browser-profile \
  --region <Region> \
  --profile-id "<ProfileId>"
Boto3

  1. Para excluir um perfil de navegador usando o Boto3:

    import boto3

region = "us-west-2"
client = boto3.client('bedrock-agentcore-control', region_name=region)

response = client.delete_browser_profile(
    profileId=profile_id
)

print(f"Profile deleted successfully")
API

  1. Para excluir um perfil de navegador usando a API:

    awscurl -X DELETE \
  "https://bedrock-agentcore-control.<Region>.amazonaws.com/browser-profiles/<ProfileId>" \
  -H "Content-Type: application/json" \
  --service bedrock-agentcore-control \
  --region <Region>

Casos de uso

Os perfis do navegador são úteis para:

  • Autenticação persistente: mantenha sessões de login em várias invocações do navegador sem precisar reautenticar a cada vez

  • Multi-step fluxos de trabalho: execute fluxos de trabalho complexos que abrangem várias sessões, preservando o estado e o contexto (em cookies ou armazenamento local)

  • Tarefas automatizadas: permita que agentes de IA realizem tarefas em sites autenticados sem intervenção manual

Considerações

  • Persistência do perfil: os dados do perfil são salvos quando você chama explicitamente a operação de salvamento. Certifique-se de salvar o perfil antes de encerrar a sessão para preservar o estado.

  • Isolamento da sessão: cada sessão do navegador usando um perfil opera de forma independente. As alterações feitas em uma sessão não são visíveis em outras sessões simultâneas.

  • Carregamento de perfil: as alterações de perfil salvas só se aplicam a novas sessões. As sessões ativas continuam usando o estado do perfil desde o início e não refletirão as atualizações feitas no perfil após o início da sessão.

  • Segurança: os perfis do navegador podem conter dados confidenciais, como cookies de autenticação. Garanta que as políticas de IAM adequadas estejam em vigor para restringir o acesso aos recursos do perfil.

  • Atualizações de perfil: quando você salva uma sessão em um perfil, ela substitui os dados do perfil anterior. Considere seu fluxo de trabalho com cuidado para evitar a perda de informações importantes sobre o estado.

  • Expiração do cookie: os cookies têm seus próprios prazos de validade definidos pelos sites. Os perfis do navegador preservam os cookies, mas os cookies expirados são removidos automaticamente pelo navegador de acordo com suas datas de validade.