View a markdown version of this page

Nova 법과 함께 AgentCore 브라우저 사용 - Amazon Bedrock AgentCore

Nova 법과 함께 AgentCore 브라우저 사용

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 : AgentCore 브라우저를 포함한 Amazon Bedrock AgentCore용 SDK 도구

  • nova-act : 브라우저 자동화를 위한 모델 및 오케스트레이터가 포함된 Nova용 SDK 법

  • rich : 터미널의 풍부한 텍스트와 아름다운 서식을 위한 라이브러리

  • boto3 AWS 서비스를 생성, 구성 및 관리하기 위한 Python(Boto3)용 : AWS SDK

2단계: Nova Act API 키 가져오기

Nova Act 페이지로 이동하여 amazon.com 자격 증명을 사용하여 API 키를 생성합니다. (이는 현재 미국 기반 amazon.com 계정에서만 작동합니다.)

라는 파일을 생성하고 다음 코드를 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 콘솔을 통해 세션을 실시간으로 볼 수 있습니다.

  1. Amazon Bedrock AgentCore 브라우저 콘솔 열기

  2. 왼쪽 탐색에서 기본 제공 도구로 이동합니다.

  3. 브라우저 도구(예: AgentCore Browser Tool 또는 사용자 지정 브라우저)를 선택합니다.

  4. 브라우저 세션 섹션에서 준비됨 상태의 활성 세션을 찾습니다.

  5. 라이브 보기/레코딩 열에서 제공된 "라이브 세션 보기" URL을 클릭합니다.

  6. 라이브 보기가 새 브라우저 창에서 열리고 실시간 브라우저 세션이 표시됩니다.

라이브 뷰 인터페이스는 다음을 제공합니다.

  • 브라우저 세션의 실시간 비디오 스트림

  • 자동화에서 제어를 인계하거나 해제하기 위한 대화형 제어

  • 세션을 종료할 수 있는 기능