View a markdown version of this page

使用 Nova A AgentCore ct 的浏览器 - Amazon Bedrock AgentCore

使用 Nova A AgentCore ct 的浏览器

你可以使用 Nova Act 构建浏览器代理来自动执行网络交互:

步骤 1:安装依赖关系

创建项目文件夹(如果还没有):

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

在 Windows 上,使用:.venv\Scripts\activate

安装所需的软件包:

pip install bedrock-agentcore nova-act rich boto3

这些软件包提供:

  • bedrock-agentcore: 适用于亚马逊 Bedrock 的 SDK AgentCore 工具,包括 AgentCore 浏览器

  • nova-act: Nova Act 的 SDK,包括浏览器自动化的模型和协调器

  • rich: 终端中包含富文本和精美格式的库

  • boto3: 用于创建、配置和管理服务的适用于 Python (Boto3) 的 AWS SDK AWS

第 2 步:获取 Nova Act API 密钥

导航至 Nova Act 页面,使用您的亚马逊凭证生成 API 密钥。(请注意,这目前仅适用于美国的亚马逊账户)

创建一个名为的文件nova_act_browser_agent.py并添加以下代码:

使用 Nova Act 编写浏览器代理

以下 Python 代码展示了如何使用 Nova Act 编写浏览器代理。有关获取 Nova Act API 密钥的信息,请参阅 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}")

步骤 3:运行代理

执行脚本(在命令中用你的 Nova Act API 密钥替换):

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"

预期产出

您应该会看到代理的回复,其中包含 Amazon Bedrock 常见用例的详细信息。 AgentCore代理浏览网站,执行搜索并提取所请求的信息。

如果遇到错误,请验证:

  • 您的 IAM role/user 拥有正确的权限

  • 你的 Nova Act API 密钥正确

  • 您的 AWS 凭证配置正确

步骤 4:实时查看浏览器会话

当您的浏览器脚本运行时,您可以通过 AWS 控制台实时查看会话:

  1. 打开 Amazon Bedrock AgentCore 浏览器控制台

  2. 导航到左侧导航栏中的Built-in 工具

  3. 选择浏览器工具(例如AgentCore Browser Tool,或您的自定义浏览器)

  4. 在 “浏览器会话” 部分,找到状态为 “就绪” 的活动会话

  5. 在 “实时预览/录制” 栏中,单击提供的 “查看实时会话” 网址

  6. 实时视图将在新的浏览器窗口中打开,显示实时浏览器会话

实时预览界面提供:

  • Real-time 浏览器会话的视频流

  • 交互式控件可接管或从自动化中释放控制权

  • 能够终止会话