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 | 持久化浏览器配置文件（cookies，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 打印到 stderr。在浏览器中打开它，即可从 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_ACCESS_KEY_ID 和 AWS_SECRET_ACCESS_KEY。
“AWS CLI failed: ... Run 'aws sso login'” 表示 SSO 凭证已过期。运行 aws sso login 刷新它们。
会话超时： 默认值为 3600 秒（1 小时）。对于更长的任务，使用 AGENTCORE_SESSION_TIMEOUT=7200 增加。