搭配 Nova Act 使用 AgentCore 瀏覽器
您可以使用 Nova Act 建置瀏覽器代理程式來自動化 Web 互動:
步驟 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:適用於 Amazon Bedrock AgentCore 工具的 SDK,包括 AgentCore 瀏覽器 -
nova-act:適用於 Nova Act 的 SDK,其中包含瀏覽器自動化的模型和協調器 -
rich:終端機中用於豐富文字和完美格式的程式庫 -
boto3: AWS SDK for Python (Boto3) 以建立、設定和管理 AWS 服務
步驟 2:取得 Nova Act API 金鑰
導覽至 Nova Act
建立名為 的檔案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 角色/使用者具有正確的許可
-
您的 Nova Act API 金鑰正確
-
您的 AWS 登入資料已正確設定
步驟 4:即時檢視瀏覽器工作階段
當瀏覽器指令碼執行時,您可以透過 AWS 主控台即時檢視工作階段:
-
導覽至左側導覽中的內建工具
-
選取瀏覽器工具 (例如,
AgentCore Browser Tool或您的自訂瀏覽器) -
在瀏覽器工作階段區段中,尋找狀態為就緒的作用中工作階段
-
在即時檢視/錄製欄中,按一下提供的「檢視即時工作階段」 URL
-
即時檢視會在新的瀏覽器視窗中開啟,顯示即時瀏覽器工作階段
即時檢視界面提供:
-
瀏覽器工作階段的即時影片串流
-
從自動化接管或釋放控制的互動式控制項
-
能夠終止工作階段