AWS Bedrock AgentCore
AWS Bedrock AgentCore가 호스팅하는 클라우드 브라우저 세션에서 agent-browser를 실행합니다. 모든 표준 agent-browser 명령어가 동일하게 작동하며, 유일한 차이는 브라우저가 실행되는 위치입니다.
설정
자격 증명은 자동으로 확인됩니다.
- 환경 변수 (
AWS_ACCESS_KEY_ID,AWS_SECRET_ACCESS_KEY, 선택적으로AWS_SESSION_TOKEN) - AWS CLI 대체 (
aws configure export-credentials) - SSO, IAM 역할, 명명된 프로필 지원
사용자에게 이미 유효한 AWS 자격 증명이 있다면 추가 설정이 필요하지 않습니다.
핵심 워크플로
# AgentCore 클라우드 브라우저에서 페이지 열기
agent-browser -p agentcore open https://example.com
# 나머지는 로컬 Chrome과 동일
agent-browser snapshot -i
agent-browser click @e1
agent-browser screenshot page.png
agent-browser close
환경 변수
| 변수 | 설명 | 기본값 |
|---|---|---|
AGENTCORE_REGION | AWS 리전 | us-east-1 |
AGENTCORE_BROWSER_ID | 브라우저 식별자 | aws.browser.v1 |
AGENTCORE_PROFILE_ID | 영구 브라우저 프로필 (쿠키, localStorage) | (없음) |
AGENTCORE_SESSION_TIMEOUT | 세션 시간 초과 (초) | 3600 |
AWS_PROFILE | 자격 증명 확인용 AWS CLI 프로필 | default |
영구 프로필
AGENTCORE_PROFILE_ID를 사용하여 여러 세션에 걸쳐 브라우저 상태를 유지할 수 있습니다. 로그인 세션을 유지하는 데 유용합니다.
# 첫 번째 실행: 로그인
AGENTCORE_PROFILE_ID=my-app agent-browser -p agentcore open https://app.example.com/login
agent-browser snapshot -i
agent-browser fill @e1 "[email protected]"
agent-browser fill @e2 "password"
agent-browser click @e3
agent-browser close
# 이후 실행: 이미 인증됨
AGENTCORE_PROFILE_ID=my-app agent-browser -p agentcore open https://app.example.com/dashboard
실시간 보기
세션이 시작되면 AgentCore가 Live View URL을 stderr로 출력합니다. 브라우저에서 이 URL을 열면 AWS 콘솔에서 세션을 실시간으로 볼 수 있습니다.
Session: abc123-def456
Live View: https://us-east-1.console.aws.amazon.com/bedrock-agentcore/browser/aws.browser.v1/session/abc123-def456#
리전 선택
# 기본값: us-east-1
agent-browser -p agentcore open https://example.com
# 명시적 리전
AGENTCORE_REGION=eu-west-1 agent-browser -p agentcore open https://example.com
자격 증명 패턴
# 명시적 자격 증명 (CI/CD, 스크립트)
export AWS_ACCESS_KEY_ID=AKIA...
export AWS_SECRET_ACCESS_KEY=...
agent-browser -p agentcore open https://example.com
# SSO (대화형)
aws sso login --profile my-profile
AWS_PROFILE=my-profile agent-browser -p agentcore open https://example.com
# IAM 역할 / 기본 자격 증명 체인
agent-browser -p agentcore open https://example.com
AGENT_BROWSER_PROVIDER와 함께 사용하기
환경 변수를 통해 제공자를 설정하면 모든 명령에 -p agentcore를 전달하지 않아도 됩니다.
export AGENT_BROWSER_PROVIDER=agentcore
export AGENTCORE_REGION=us-east-2
agent-browser open https://example.com
agent-browser snapshot -i
agent-browser click @e1
agent-browser close
일반적인 문제
**"Failed to run aws CLI"**는 AWS CLI가 설치되지 않았거나 PATH에 없음을 의미합니다. AWS CLI를 설치하거나 AWS_ACCESS_KEY_ID와 AWS_SECRET_ACCESS_KEY를 직접 설정하세요.
**"AWS CLI failed: ... Run 'aws sso login'"**는 SSO 자격 증명이 만료되었음을 의미합니다. aws sso login을 실행하여 갱신하세요.
세션 시간 초과: 기본값은 3600초(1시간)입니다. 더 긴 작업의 경우 AGENTCORE_SESSION_TIMEOUT=7200으로 늘리세요.