View a markdown version of this page

Usando o AgentCore navegador com o Nova Act - Amazon Bedrock AgentCore

Usando o AgentCore navegador com o Nova Act

Você pode criar um agente de navegador usando o Nova Act para automatizar as interações na web:

Etapa 1: instalar dependências

Crie uma pasta de projeto (caso ainda não tenha feito isso):

mkdir agentcore-browser-quickstart cd agentcore-browser-quickstart python3 -m venv .venv source .venv/bin/activate
nota

No Windows, use: .venv\Scripts\activate

Instale os pacotes obrigatórios:

pip install bedrock-agentcore nova-act rich boto3

Esses pacotes fornecem:

  • bedrock-agentcore: O SDK para as AgentCore ferramentas Amazon Bedrock, incluindo o navegador AgentCore

  • nova-act: O SDK para Nova Act, que inclui o modelo e o orquestrador para automação de navegadores

  • rich: Biblioteca para texto rico e formatação bonita no terminal

  • boto3: AWS SDK para Python (Boto3) para criar, configurar e gerenciar serviços AWS

Etapa 2: Obtenha a chave de API do Nova Act

Navegue até a página Nova Act e gere uma chave de API usando suas credenciais da amazon.com. (Observe que atualmente isso funciona apenas para contas da amazon.com sediadas nos EUA)

Crie um arquivo chamado nova_act_browser_agent.py e adicione o seguinte código:

Escreva um agente de navegador usando o Nova Act

O código Python a seguir mostra como escrever um agente de navegador usando o Nova Act. Para obter informações sobre como obter a chave de API para o Nova Act, consulte a documentação do Amazon Nova Act.

from bedrock_agentcore.tools.browser_client import browser_session from nova_act import NovaAct from rich.console import Console import argparse import json import boto3 console = Console() from boto3.session import Session boto_session = Session() region = boto_session.region_name print("using region", region) def browser_with_nova_act(prompt, starting_page, nova_act_key, region="us-west-2"): result = None with browser_session(region) as client: ws_url, headers = client.generate_ws_headers() try: with NovaAct( cdp_endpoint_url=ws_url, cdp_headers=headers, nova_act_api_key=nova_act_key, starting_page=starting_page, ) as nova_act: result = nova_act.act(prompt) except Exception as e: console.print(f"NovaAct error: {e}") finally: return result if __name__ == "__main__": parser = argparse.ArgumentParser() parser.add_argument("--prompt", required=True, help="Browser Search instruction") parser.add_argument("--starting-page", required=True, help="Starting URL") parser.add_argument("--nova-act-key", required=True, help="Nova Act API key") parser.add_argument("--region", default="us-west-2", help="AWS region") args = parser.parse_args() result = browser_with_nova_act( args.prompt, args.starting_page, args.nova_act_key, args.region ) console.print(f"\n[cyan] Response[/cyan] {result.response}") console.print(f"\n[bold green]Nova Act Result:[/bold green] {result}")

Etapa 3: Executar o agente

Execute o script (substitua por sua chave de API do Nova Act no comando):

python nova_act_browser_agent.py --prompt "What are the common usecases of Bedrock AgentCore?" --starting-page "https://docs.aws.amazon.com/bedrock-agentcore/latest/devguide/what-is-bedrock-agentcore.html" --nova-act-key "your-nova-act-API-key"

Saída esperada

Você deve ver a resposta do agente contendo detalhes dos casos de uso comuns do Amazon Bedrock. AgentCore O agente navega pelo site, realiza a pesquisa e extrai as informações solicitadas.

Se você encontrar erros, verifique:

  • Seu IAM role/user tem as permissões corretas

  • Sua chave de API do Nova Act está correta

  • Suas AWS credenciais estão configuradas corretamente

Etapa 4: ver a sessão do navegador ao vivo

Enquanto o script do navegador está em execução, você pode visualizar a sessão em tempo real por meio do AWS console:

  1. Abra o console do AgentCore navegador Amazon Bedrock

  2. Navegue até Built-in as ferramentas na navegação à esquerda

  3. Selecione a ferramenta Navegador (por exemploAgentCore Browser Tool, ou seu navegador personalizado)

  4. Na seção Sessões do navegador, encontre sua sessão ativa com o status Pronto

  5. Na coluna Visualização ao vivo/gravação, clique no URL “Exibir sessão ao vivo” fornecido

  6. A exibição ao vivo é aberta em uma nova janela do navegador, exibindo a sessão do navegador em tempo real

A interface de visualização ao vivo fornece:

  • Real-time stream de vídeo da sessão do navegador

  • Controles interativos para assumir ou liberar o controle da automação

  • Capacidade de encerrar a sessão