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 | 持久性瀏覽器設定檔（Cookie、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 會在 stderr 輸出一個 Live View 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
常見問題
「執行 AWS CLI 失敗」 表示 AWS CLI 未安裝或不在 PATH 中。請安裝它，或直接設定 AWS_ACCESS_KEY_ID 和 AWS_SECRET_ACCESS_KEY。
「AWS CLI 失敗：... 執行 'aws sso login'」 表示 SSO 憑證已過期。執行 aws sso login 以重新整理憑證。
工作階段逾時： 預設值為 3600 秒（1 小時）。對於較長的任務，請使用 AGENTCORE_SESSION_TIMEOUT=7200 增加時長。