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はライブビュー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で増やしてください。